This procedure describes how to install the Web Space Server package specifically intended for use with WebLogic Server software. Only install this Web Space Server package on WebLogic; do not install any of the Web Space Server evaluation bundles or GlasFish bundles. See Getting Sun GlassFish Web Space Server Software for information about all available Web Space Server packages.
Oracle WebLogic Server software must be installed and running on your system before proceeding with these instructions. See Installing Oracle WebLogic Server Softwarefor more information about installing Oracle WebLogic Server software.
WebLogic version: WebLogic 10g or 11g are the recommended WebLogic versions for production environments.
Ant version: Apache Ant 1.7 or later must be installed on your system before performing the Web Space Server installation. The version of Ant bundled with Sun GlassFish does not work with Web Space Server 10.0. Make sure that Ant 1.7 or later is installed on your system, and that your PATH and ANT_HOME environment variables point to this newer version. You can verify the version of Ant that will be used by default by entering the following command in a command shell for your operating system:
ant -version |
Refer to the documentation included with your Ant package for complete installation instructions.
(Mac OS X systems only) Configure your Java environment.
If using JDK 1.6, use the Java Preferences application to specify the correct JDK version.
Also be sure to set JAVA_HOME to point to JDK 1.6.
export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/Home |
If using JDK 1.5, rename the 14compatibility.jar file.
The 14compatibility.jar file includes some aspects of the Xalan XSLT processor and the Crimson XML parser that conflict with newer versions of the classes bundled with Web Space Server 10.0.
Use the following commands to rename the 14compatibility.jar file:
cd /System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/ \ Classes/.compatibility sudo mv 14compatibility.jar 14compatibility.jar.orig cd /System/Library/Frameworks/JavaVM.framework/Versions/A/Resources/.compatibility sudo mv 14compatibility.jar 14compatibility.jar.orig |
Open the WebLogic administration console in a Web browser; for example:
http://localhost:7001/console |
Navigate to the domain in which Web Space Server will be installed, and then click on the Web Applications tab.
Enable the Optimistic Serialization option and save the setting.
Stop the WebLogic domain.
Download the webspace-10.0.6-for-weblogic.zip integration bundle and unzip it in the directory of your choice.
To avoid the chance of overwriting existing WebLogic configuration settings or files, it is strongly recommended that you not unzip the Web Space Server package into an existing WebLogic directory structure.
For the remainder of these instructions, the root directory of the existing WebLogic installation is referred to as or-install-dir, and the directory in which the Web Space Server installer has been unzipped is referred to as ws-install-dir.
Change to the ws-install-dir/webspace/application directory and run the install.xml script.
cd ws-install-dir/webspace/application ant -f ./install.xml |
Follow the prompts to complete the Web Space Server installation in the WebLogic domain you want to use.
The Web Space Server WAR files are copied to the ws-install-dir/var/webspace/war-workspace/finals/ directory.
(Optional) Configure Web Space Server to work with a database other than the default HSQL database.
In most production environments, you will want to use a database other than the default HSQL database that is bundled with Web Space Server. See Configuring a Database for Use With Web Space Server for detailed instructions. Continue with the next step, below, after configuring your database.
Start the WebLogic domain.
Deploy the Web Space Server WAR files.
The Web Space Server WARs can be deployed using the GUI-based WebLogic administration console or the WebLogic command line.
To deploy the Web Space Server WARs using the GUI-based WebLogic administration console
Use a Web browser to log in to the WebLogic administration console; for example:
http://localhost:7001/console |
Click Deployments, and manually deploy the Web Space Server WAR files, one at a time.
The Web Space Server WAR files are located in the ws-install-dir/var/webspace/war-workspace/finals/ directory.
When running WebLogic in Production mode, you must explicitly click the Start button in the WebLogic administration console for each WAR file you deploy.
To deploy the Web Space Server WARs using the WebLogic command line
Open a root command shell for your operating environment on the server on which WebLogic is running.
Add the weblogic.jar to the Java CLASSPATH.
export CLASSPATH=$CLASSPATH:or-install-dir/server/lib/weblogic.jar |
Deploy the webspace.war file.
java weblogic.Deployer -adminurl t3://localhost:7001 -user \ weblogic -password weblogic -deploy webspace.war |
Note that the above command should be entered on a single line. To start the application, invoke the above command with the -start option.
Deploy the tunnel-web.war file.
java weblogic.Deployer -adminurl t3://localhost:7001 -user \ weblogic -password weblogic -deploy tunnel-web.war |
As with the webspace.war example, this command should be entered on a single line, and the application can be started by invoking the command with the -start option.
(Optional) Verify that the application WARs are deployed.
java weblogic.Deployer -adminurl t3://localhost:7001 -user \ weblogic -password weblogic -listapps |
(Optional) Open the Web Space Server site.
Web Space Server uses whatever HTTP/HTTPS port is defined for your domain. For example:
http://domainfoo:7001 |