NetBeans Visual Web Pack 5.5 Installation Instructions

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.


Prerequisites

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.

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.

top

Installing the Software

This topic contains instructions for installing NetBeans Visual Web Pack 5.5 on all supported platforms:

Note: The order of installation is as follows:

  1. Install the NetBeans 5.5 IDE.
  2. Install the application server.

    Skip this and the next step if you installed the NetBeans IDE bundled with Sun Java Application Server 9.0.
  3. Configure the application server on NetBeans IDE 5.5, as described in Application Server Configuration.
  4. Install NetBeans Visual Web Pack 5.5 as described in this section.

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:

To Install

  1. When you have downloaded the installer file your_binary_executable, navigate to the directory that contains the file.
  2. 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
  3. Launch the installer by typing the following command at a command prompt:

    $ ./your_binary_executable
  4. At the Welcome page of the installation wizard, click Next.
  5. Accept the license agreement and click Next.
  6. At the installation directory page of the installation wizard, accept the NetBeans IDE directory found by the wizard or select a different IDE installation.
  7. 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
  8. Click Install to begin the installation.
  9. 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.

top

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-directory

To Install

  1. When you have downloaded the installer file netbeans-visualweb-5_5-tp-windows.exe, double-click the installer's icon to launch the installer.
  2. At the Welcome page of the installation wizard, click Next.
  3. Accept the license agreement and click Next.
  4. At the installation directory page of the installation wizard, specify the location of your NetBeans IDE 5.5 installation.
  5. 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.
  6. 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.

top

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:

    1. In the Finder window, go to Applications > Utilities > Java > J2SE5.0 and open the Java Preferences utility.
    2. 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

    1. 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
    2. Double-click the installer's icon to launch the installer.
    3. At the Welcome page of the installation wizard, click Next.
    4. Accept the license agreement and click Next.
    5. At the installation directory page of the installation wizard, accept the NetBeans IDE directory found by the wizard or select a different IDE installation.
    6. 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
    7. Click Install to begin the installation.
    8. 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.

top


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:
  1. 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.
  2. Select the Runtime Window.
  3. Right-click Servers and select Add Server.
  4. In the Add Server Instance wizard, choose the Sun Java System Application Server and click Next.
  5. Enter the location of the application server installation and click Next.
  6. The default username and password values for the default Application Server domain, domain1, are:

    • username: admin
    • password: adminadmin
    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.
  7. Click Finish.
  8. 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.

top

Database Configuration

This section contains information for configuring Visual Web Pack for various database systems.

To create a new database connection:

  1. Launch the NetBeans IDE.
  2. In the Runtime window, right-click Databases and select New Connection.
  3. On the Basic setting tab of the New JDBC Driver dialog:

    1. Select New Driver from the Name dropdown list.
    2. 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.
    3. Modify the Database URL to reflect the host, port, and database you are using.
    4. 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:

  1. Launch the NetBeans IDE.
  2. In the Runtime window, right-click Databases > Drivers and select New Driver.
  3. 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:

top

Uninstalling the Software

This section contains information for uninstalling NetBeans Visual Web Pack 5.5 from your system.


Copyright and Trademark Notice