After installing the core Web Space Server 10.0 software, updates to Web Space Server and any plugins can be performed entirely through the Update Tool that is bundled with Web Space Server 10.0.
The version of Update Tool included with some versions of GlassFish Enterprise Server is not compatible with the Web Space Server update repositories. You must use the version of Update Tool that comes with Web Space Server 10.0 software rather than the version that is bundled with GlassFish .
Update Tool also includes a command-line (CLI) Image Packaging System (IPS) utility, called pkg, that provides the same core functionality as its GUI-based counterpart. This IPS tool is started with the ws-install-dir/bin/pkg command. See the Update Center wiki for complete information about Update Tool and the pkg command.
You can install Web Space Server 10.0 Update components through either the Update Tool GUI or with the pkg CLI utility.
To Install the Update Components Using the GUI-Based Update Tool
To Install the Update Components Using the CLI-Based pkg Tool
Before installing a Web Space Server Update package, or when performing Web Space Server maintenance tasks in general, it is often useful to know the full version information about the currently running Web Space Server installation. This information can be displayed through Update Center, but the quickest and most complete information is found the Web Space Server version file.
In a command shell, change to the ws-install-dir/var/webspace directory, and display the contents of the version.
cd ws-install-dir/var/webspace less version |
For example, the following version information is returned for Web Space Server Update 5:
Version=10.0.5 Build=1.19 Revisions=1626-31998-26479 VanityVersion=Web Space Server 10.0 Update 5 |
This procedure explains how to install an Update patch on top of an existing Web Space Server 10.0 installation using the GUI-based Update Tool. If you prefer to use the pkg command line tool, see To Install the Update Components Using the CLI-Based pkg Tool.
Note the following before you begin the Update installation:
Web Space Server 10.0 software must be installed and running, as described in Installing Web Space Server Software.
Installation of the 10.0 Update components cannot be rolled back.
In a command shell for your operating system, change to the ws-install-dir/bin directory and run the updatetool command.
If this is the first time you have launched updatetool, the full Update Tool product will not yet be installed, and you are prompted to allow installation to proceed.
Type y when prompted to install Update Tool.
The installer downloads and installs the full Update Tool product and then exits.
Enter the updatetool command again to launch Update Tool.
The Update Tool main window is displayed, with Available Updates highlighted.
(Optional) Specify proxy server settings, if necessary.
This step is only required if you are using Update Tool from behind a firewall that implements a proxy server.
Click the Web Space node in the Application Images pane on the left in Update Tool.
Details about the currently selected software repositories are displayed. To get the Web Space Server updates, the update repository URL must be modified in this list.
Click Edit Properties on the right side of the Image Details pane.
The repositories displayed by default depend on the version of Web Space Server you are using.
Back in the Update Tool main window, choose the Available Updates node in the Application Images pane to display the list of available Updates.
The available updates and their associated WAR files are displayed. It is recommended that you always choose the latest available update.
Select the Web Space Server update package you want to install, and then click Install to install the update.
Restart the application server.
For example, if running GlassFish Enterprise Server, use the following commands:
cd gf-install-dir/bin ./asadmin stop-domain domain_name ./asadmin start-domain domain_name |
Change to the ws-install-dir/webspace/application directory.
Run the Ant install.xml script to regenerate and redeploy the Web Space Server WAR files.
ant -f install.xml |
Restart the application server once again.
For example, if running GlassFish Enterprise Server:
cd gf-install-dir/bin ./asadmin start-domain domain_name |
This procedure explains how to install an Update patch on top of an existing Web Space Server 10.0 installation using the CLI-based pkg utility. If you prefer to use the GUI-based Update Tool, see To Install the Update Components Using the GUI-Based Update Tool.
Note the following before you begin the Update installation:
Web Space Server 10.0 software must be installed and running, as described in Installing Web Space Server Software.
Installation of the 10.0 Update components cannot be rolled back.
In a command shell for your operating system, change to the ws-install-dir/bin directory and run the updatetool command.
If this is the first time you have launched updatetool, the full Update Tool product will not yet be installed, and you are prompted to allow installation to proceed.
Type y when prompted to install Update Tool.
The installer downloads and installs the full Update Tool product and then exits.
Change to the ws-install-dir/pkg/bin directory.
Use the pkg command to download the Update components.
If you are using Web Space Server Update 6, enter the following command:
pkg set-publisher -O http://pkg.sun.com/webspace/10/_support_ webspace.sun.com |
If you are using Web Space Server Update 5 or earlier, enter the following command:
pkg set-authority -P --enable -O http://pkg.sun.com/webspace/10/_support_ support.sun.com |
Enter the following command to install the Update components:
pkg image-update |
Restart the application server.
For example, if running GlassFish Enterprise Server, use the following commands:
cd gf-install-dir/bin ./asadmin stop-domain domain_name ./asadmin start-domain domain_name |
Change to the ws-install-dir/webspace/application directory.
Run the Ant install.xml script to regenerate and redeploy the Web Space Server WAR files.
ant -f install.xml |
Restart the application server.
For example, if running GlassFish Enterprise Server:
cd gf-install-dir/bin ./asadmin start-domain domain_name |
When using Update Tool to upgrade a version of Web Space Server prior to Update 5, a workaround is required when performing the upgrade from behind a proxy server that requires authentication.
The workaround presented here is only required when updating Web Space Server versions prior to Update 5. Web Space Server Update 5 and later are bundled with Update Center 2.2, which supports proxy authentication and therefore does not require this workaround. See To Determine the Current Web Space Server Version for instructions on displaying the current Web Space Server version.
Download Update Center 2.2 package suitable for your platform from the Update Center wiki.
Unzip the Update Center 2.2 package to the temporary directory of your choice.
In this example, the temporary directory is named /tmp/uc2.2, and the package is for the Sun Solaris x86 operating environment.
Copy the pkg-bootstrap.jar and pkg-client.jar files from /tmp/uc2.2/pkg-toolkit-platform_name/pkg/lib to the ws-install-dir/pkg/lib directory.
Change to the ws-install-dir/bin directory and run the updatetool command.
You are prompted to specify the proxy host and port.
Enter the proxy information as prompted.
The latest versions of the updatetool and pkg files are downloaded and installed.
Run updatetool again, and proceed with the Web Space Server update, as described in To Install the Update Components Using the GUI-Based Update Tool or To Install the Update Components Using the CLI-Based pkg Tool.