Installing Updates from the Update Tool

Web Space Server updates and add-ons can be downloaded using the Sun GlassFish Update Tool.

If the user is behind a proxy, and is upgrading from a early version of Web Space Server ( a version of Web Space Server which is earlier to Web Space Server 10.0 Update 5), the user need to use a workaround. For the instructions for using this workaround, see To Use updatetool in a Proxy That Requires Authentication.

First release of the product (Web Space Server 10.0) was bundled with Update Center 2.0 which was not supporting authenticated proxy setup. Sun GlassFish Web Space Server 10.0 Update 5 and later versions of Web Space Server are bundled with Update Center 2.2, with supports proxy authentication, and hence the workaround is not required.

The version of Update Tool included with some versions of GlassFish Enterprise Server is not compatible with the Web Space Server Add-On package repositories. You must use the version of Update Tool that comes with Web Space Server 10.0 software.

Update Tool also includes a command-line (CLI) Image Packaging System (IPS) utility, called pkg, which provides the same core functionality as its GUI-based counterpart. This IPS tool is started with the webspace_dir/bin/pkg command. See the Update Center wiki for complete information about Update Tool and the pkg command.

To Download the Updates Using Update Tool

1. Start Update Tool by changing to the webspace-dir/bin directory and typing updatetool.

   • If the Update Tool main window appears, proceed to Step 2.

   • If a prompt appears asking whether to allow the installation of Update Tool to proceed:

     1. Type y to proceed.

        The installer downloads and installs Update Tool and then exits. This process takes approximately 10 ‐ 15 minutes.

     2. Type the updatetool command again to start Update Tool.

        The Update Tool main window appears.

2. Expand Web Space under the Application Images pane, and click Available Updates.

   Figure 2–1 Update Tool

   
   

3. Click the Edit Properties button.

   The Image Properties window is displayed.

4. Select the option support.sun.com repository, and choose Preferred.

   The Repository Properties window appears.

5. Provide the appropriate repository URL provided by Sun support, and click OK.

   The support.sun.com repository is highlighted.

   Figure 2–2 Selecting the support.sun.com repository

   
   

6. Click OK again to enable the support.sun.com repository.

   The Update Tool main window is displayed.

7. Expand Web Space under the Application Images pane, and select Available Add-ons.

8. Select the Web Space for GlassFish V2 component, and click install.

9. Restart the GlassFish server.

   cd <glassfish_dir>/bin
   ./asadmin stop-domain
   ./asadmin start-domain

10. Change to the webspace_dir/webspace/application directory.

11. Run the ant install-gfv2.xml script to regenerate and redeploy the Web Space Server WAR files.

    ant -f install-gfv2.xml

12. Restart the GlassFish server.

    cd <glassfish_dir>/bin
    ./asadmin start-domain

To Download the Updates Using the CLI-Based pkg Tool

1. Start Update Tool by changing to the webspace-dir/bin directory and typing updatetool.

   • If the Update Tool main window appears, proceed to Step 2.

   • If a prompt appears asking whether to allow the installation of Update Tool to proceed:

     1. Type y to proceed.

        The installer downloads and installs Update Tool and then exits. This process takes approximately 10 ‐ 15 minutes.

     2. Type the updatetool command again to start Update Tool.

        The Update Tool main window appears.

2. Change to the webspace_dir/pkg/bin directory.

3. Type the following command to download updates:

   pkg set-authority -P --enable -O http://pkg.sun.com/webspace/10/ repository-name

   Ask your SunSolve service representative for the correct repository name to use.

4. Type the following commands to install the Update components.

   pkg image-update

5. Restart the GlassFish server.

   cd <glassfish_dir>/bin
   ./asadmin stop-domain
   ./asadmin start-domain

6. Change to the webspace_dir/webspace/application directory.

7. Run the ant install-gfv2.xml script to regenerate and redeploy the Web Space Server WAR files.

   ant -f install-gfv2.xml

8. Restart the GlassFish server.

   cd <glassfish_dir>/bin
   ./asadmin start-domain

To Use updatetool in a Proxy That Requires Authentication

This is a workaround to install Web Space Server from behind a proxy, when you are updating from a early version of Web Space Server. Sun GlassFish Web Space Server 10.0 Update 5 and later versions of Web Space Server are bundled with Update Center 2.2 which supports proxy authentication, and this workaround is not required.

1. Download Update Center 2.2 suitable for your platform from Update Center Wiki.

2. Unzip the Update Center 2.2 to a temporary directory (i.e. /tmp/uc2.2)

3. Copy the files pkg-bootstrap.jar and pkg-client.jar from /tmp/uc2.2/pkg-toolkit-sunos-i386/pkg/lib to <webspace_dir>/webspace-for-gfv2/pkg/lib.

4. Navigate to <webspace_dir>/webspace-for-gfv2/bin, and run updatetool.

   You are prompted to type the proxy info and proxy port.

5. Type the proxy info and proxy port information.

   The latest version of the updatetool and pkg files is downloaded.

6. Run updatetool again to download Web Space Server packages.