The NetBeans Visual Web Pack 5.5 provides an environment for rapidly building web applications with AJAX-enabled JavaServer Faces components, support for drag-and-drop binding to data sources, and more.
Contents
Note: For information about system requirements for the software included in this bundle, see the NetBeans Visual Web Pack 5.5 Release Notes.
This topic specifies the prerequisites that must be met before you start to install NetBeans Visual Web Pack 5.5.
Download NetBeans Visual Web Pack 5.5 from the netbeans.org Downloads Page.
Required Software
Hardware, software, and operating system requirements are detailed in the NetBeans Visual Web Pack 5.5 System Requirements.
- NetBeans IDE 5.5
Java SE Development Kit (JDK) 5.0 Update 6 (version 1.5.0_06)
If you do not have an installation of JDK 5.0 Update 6 or higher, you cannot proceed with the installation. For best results use JDK 5.0 Update 9. For details, see the System Requirements topic in the Release Notes.Sun Java System Application Server 9.0 UR1 Build 14 or later (also known as GlassFish v1 UR1)
You can download the NetBeans IDE 5.5 bundled with Sun Java System Application Server from the NetBeans IDE 5.5 Download page or download the application server separately from Java EE Downloads. To use the sample databases and run the sample applications bundled with NetBeans Visual Web Pack 5.5, you must have Sun Java System Application Server installed.
Firewall Applications
Enabled firewall applications can prevent some components from being configured correctly during the installation process. Depending on your firewall, you might have to disable it prior to installation. Consult your firewall documentation.
This topic contains instructions for installing NetBeans Visual Web Pack 5.5 on all supported platforms:
Note: The order of installation is as follows:
Install the application server.
Skip this and the next step if you installed the NetBeans IDE bundled with Sun Java Application Server 9.0.Solaris OS and Linux
Following are instructions for installing NetBeans Visual Web Pack 5.5 on Solaris and Linux platforms.
In the instructions below, replace your_binary_executable with one of the following:
- Solaris OS, SPARC: netbeans-visualweb-5_5-tp-solaris-sparc.bin
- Solaris OS, x86/x64 Platform Edition: netbeans-visualweb-5_5-tp-solaris-x86.bin
- Linux: netbeans-visualweb-5_5-tp-linux.bin
To Install
- When you have downloaded the installer file your_binary_executable, navigate to the directory that contains the file.
If necessary, change the permissions on the installer file to make the binary executable by typing the following command at a command prompt:
$ chmod -x your_binary_executable- Launch the installer by typing the following command at a command prompt:
$ ./your_binary_executable- At the Welcome page of the installation wizard, click Next.
- Accept the license agreement and click Next.
- At the installation directory page of the installation wizard, accept the NetBeans IDE directory found by the wizard or select a different IDE installation.
Verify that the installation location is correct and that you have adequate space on your system for the installation. To determine the amount of free disk space, execute the following command:
df -k- Click Install to begin the installation.
- When the installation is complete, click Finish to exit the wizard.
The default projects directory is $HOME/. If you uninstall NetBeans Visual Web Pack, this directory is not deleted, and will be identified the next time you install Visual Web Pack.
Note: If you encounter problems during software installation, see Troubleshooting for full descriptions and suggested workarounds for unresolved issues that could affect the installation process.
Microsoft Windows
Following are instructions for installing NetBeans Visual Web Pack 5.5 on the Microsoft Windows platform.
Before You Start
The following restriction applies to the installation on the Microsoft Windows platform:
The installer first extracts the required files to the default temporary space directory defined by the TEMP environment variable. If the amount of disk space in the temporary directory is less than required, the installation might fail or proceed incorrectly.
If you encounter this problem, you can increase the space allocated for the TEMP environment variable or specify a different temporary directory that has sufficient space. To specify a temporary directory for the installation, type the following commands:
> cd location-of-installer
> netbeans-visualweb-5_5-tp-windows.exe -is:tempdir temporary-directoryTo Install
- When you have downloaded the installer file netbeans-visualweb-5_5-tp-windows.exe, double-click the installer's icon to launch the installer.
- At the Welcome page of the installation wizard, click Next.
- Accept the license agreement and click Next.
- At the installation directory page of the installation wizard, specify the location of your NetBeans IDE 5.5 installation.
- The installation wizard searches for compatible JDK installations. If your JDK is not in the default location, you will need to specify the location of your Java JDK 1.5.0_06 or higher. You can also type the path to another installed JDK or use the Browse button to navigate to and select another installation.
- When installation is complete, click Finish to exit the wizard.
The default projects directory is C:\Documents and Settings\username. If you uninstall NetBeans Visual Web Pack, this directory is not deleted, and will be identified the next time you install Visual Web Pack.
Note: If you encounter problems during software installation, see Troubleshooting for full descriptions and suggested workarounds for unresolved issues that could affect the installation process.
Mac OS X
Following are instructions for installing NetBeans Visual Web Pack 5.5 on the Macintosh OS X platform.
Note that for the Macintosh OS, the required JDK is Java 2 Standard Edition (J2SE) 5.0 Release 4. You can download this JDK from the Apple Downloads page. Search for "J2SE" to locate the this release.
Before You Start
The following restrictions apply to the installation on the Mac OS X platform:
To ensure correct operation of the installer and uninstaller, you must configure Java to use JDK 5.0:
- In the Finder window, go to Applications > Utilities > Java > J2SE5.0 and open the Java Preferences utility.
- In the Java Application Runtime Settings section, move J2SE5.0 to the top of the list.
- To allow the operating system to correctly recognize the NetBeans 5.5 IDE bundle components, the installation directory must end with the string .app.
To Install
When you have downloaded the installer file netbeans-visualweb-5_5-tp-macosx.jar, navigate to the directory that contains the file and execute the command:
chmod +x- Double-click the installer's icon to launch the installer.
- At the Welcome page of the installation wizard, click Next.
- Accept the license agreement and click Next.
- At the installation directory page of the installation wizard, accept the NetBeans IDE directory found by the wizard or select a different IDE installation.
Verify that the installation location is correct and that you have adequate space on your system for the installation. To determine the amount of free disk space, execute the following command:
df -b- Click Install to begin the installation.
- When the installation is complete, click Finish to exit the wizard.
The default projects directory is $username/. If you uninstall NetBeans Visual Web Pack, this directory is not deleted, and will be identified the next time you install Visual Web Pack.
Note: If you encounter problems during software installation, see Troubleshooting for full descriptions and suggested workarounds for unresolved issues that could affect the installation process.
Configuration Information
This topic provides information for configuring the NetBeans Visual Web Pack 5.5 for use with various databases. If you plan to use the Visual Web Pack tutorials, it is best to install the NetBeans IDE 5.5 and Sun Java System Application Server before installing NetBeans 5.5 Visual Web Pack.
Application Server Configuration
To work with Visual Web Pack's sample applications and databases, you need an installation of Sun Java System Application Server. Download it from The Sun Developer Network Java EE Downloads page. If you have installed the NetBeans IDE 5.5 bundled with Sun Java System Application Server, the application server is already registered with Visual Web Pack and you do not need to configure it.
To configure Sun Java System Application Server for NetBeans Visual Web Pack 5.5:
- After installing the NetBeans IDE 5.5 and the Sun Java System Application Server, launch the NetBeans IDE 5.5 and configure the application server before installing NetBeans Visual Web Pack 5.5.
- Select the Runtime Window.
- Right-click Servers and select Add Server.
- In the Add Server Instance wizard, choose the Sun Java System Application Server and click Next.
- Enter the location of the application server installation and click Next.
The default username and password values for the default Application Server domain, domain1, are:
Note that if you specify a password here, it will be stored in your user directory, a possible security risk. If you do not specify the password here, you will be prompted for the values when needed.
- username: admin
- password: adminadmin
- Click Finish.
- Install NetBeans Visual Web Pack 5.5.
Your installation of Visual Web Pack will be configured for Sun Java System Application Server and you can now work with Visual Web Pack's sample applications and databases.
Database Configuration
This section contains information for configuring Visual Web Pack for various database systems.
To create a new database connection:
- Launch the NetBeans IDE.
- In the Runtime window, right-click Databases and select New Connection.
On the Basic setting tab of the New JDBC Driver dialog:
- Select New Driver from the Name dropdown list.
- In the New JDBC Driver window, click Add and navigate to the location of your database's JDBC driver. The Driver Class and Name fields should populate automatically. Click OK.
- Modify the Database URL to reflect the host, port, and database you are using.
- Enter the User name and password of a user registered on the database. If you want to specify a database schema to use, do so on the Advanced tab. Otherwise click OK.
To configure your database for NetBeans Visual Web Pack 5.5:
- Launch the NetBeans IDE.
- In the Runtime window, right-click Databases > Drivers and select New Driver.
- In the New JDBC Driver window, click Add, navigate to the location of your database's JDBC driver, and select the driver. The Driver Class and Name fields should populate automatically. Click OK.
Applications and Sample Databases
To work with sample databases and sample applications (that use sample databases), you need to install Sun Java System Application Server and add it to the IDE Servers as described in Application Server Configuration above. After this, restart the IDE to have sample databases and database connections created at IDE startup. The following database and database connection will be created:
Sample Database Connection Details Needed For Travel DB URL: jdbc:derby://localhost:1527/travel
Driver: org.apache.derby.jdbc.ClientDriver
Username: travel
Password: travel
This connection is automatically created.To complete tutorials and run some of the sample applications.
For more information:
- NetBeans Visual Web Pack 5.5 Configuration Information has further instructions for configuring databases and application servers in Visual Web Pack 5.5.
- Java DB At a Glance gives a product overview to Java DB as well as a tour and documentation.
Uninstalling the Software
This section contains information for uninstalling NetBeans Visual Web Pack 5.5 from your system.
- Solaris OS and Linux
- Microsoft Windows
- Mac OS X
Solaris OS and Linux
- Shut down the IDE.
- Navigate to the _uninstall subdirectory of your NetBeans Visual Web Pack 5.5 installation, $NetBeansInstallDir/rave2.0/_uninst.
- Execute the uninstall script.
Microsoft Windows
- Shut down the IDE.
- From the Control Panel, start Add or Remove Programs, select NetBeans Visual Web Pack and click Change/Remove.
- Follow the instructions in the uninstaller.
Mac OS X
- Shut down the IDE.
- Navigate to the Visual Web Pack _uninstall subdirectory of your NetBeans IDE 5.5 installation, $NetBeansInstallDir/NetBeans.app/Contents/Resources/NetBeans/rave2.0/_uninstall.
- Change the permissions for uninstall.jar using the command chmod +x.
- Execute uninstall.jar.
Troubleshooting
If you experience problems installing or running the software, see the list of issues below for workarounds. For a complete list of known issues, system requirements, and configuration information, see the Release Notes.
If you encounter a problem not listed in the release notes or wish to request an enhancement, file an issue in the NetBeans bug tracking system, IssueZilla, at http://www.netbeans.org/issues. For Visual Web Pack issues, select the "visualweb" component and then select an appropriate subcomponent. If you are not sure of the right subcomponent name, choose "other".
If you are already logged in to netbeans.org, you can go directly to the visualweb issue entry screen: http://www.netbeans.org/issues/enter_bug.cgi?component=visualweb&version=5.5.
Following are the unresolved issues for this release that could affect or disrupt the installation process:
- Solaris installation aborts with the error "JRE not found" even though JRE was installed and specified.
Description: This application requires a Java Run Time Environment (JRE) implementation to run, but the installer is unable to find one on your computer. Use the command line switch -is:javahome to specify a valid JRE. For more help, use the option -is:help.
Workaround: Start the installer with the -is:tempdir custom-temp-dir command line parameter. Note that custom-temp-dir must be an absolute path, and should contain at least 1 GB of disk space.