Chapter 3 Creating and Deleting Instances of the Server

An instance is a server that listens on a particular port, bound to either one or more IP addresses. For the Sun Java™ System Portal Server, an instance corresponds to a web server process listening on a port and running a single Java™ Virtual Machine (JVM™).

To Create an Instance of the Server


Note	Multiple-instances are supported with Sun Java™ System Web Server and Sun Java™ System Application Server.

Deploy a new Access Manager instance. For instructions on deploying a new Access Manager instance, see the Chapter 1 of the Sun Java System Access Manager Administration Guide at: http://docs.sun.com/.

Go to the Portal Server utilities directory.

cd PortalServer-base/SUNWps/bin

Run the multiserverinstance script.

./multiserverinstance

Enter the name of the instance.

Enter the port of the new instance.

If you have portlets, redeploy them. For instructions to redeploy portlets, consult the Sun Java System Portal Server 2005Q1 Technical Reference Guide.

After the multiservinstance script exits, go to the web server instance directory.

cd WebServer-base/https-new-instance-name

Stop the web server instance.

./stop

Restart the web server instance.

./start

Go to the newly created instance in a browser.

Repeat steps Step 9 through Step 11 for each newly created instance.

In a browser, enter:

http://hostname.domain:instance-portnumber/amconsole to access the administration console through the new instance

http://hostname.domain:instance-portnumber/portal to access the default URL for the Portal Desktop through the new instance

If you create any additional server instances and you want to run them as non-root or nobody, comment out the following lines for each instance at AccessManager-base/SUNWam/bin/amserver.instance-nickname

if [ "$uid" != "0" ];
then
echo "‘$gettext ’You must be root user to run’‘ $0."
exit 1
fi

To Delete an Instance of the Server

Change directories to PortalServer-base/SUNWps/bin.

cd PortalServer-base/SUNWps/bin

If you have portlets, remove them. For instructions, see the Sun Java System Portal Server 2005Q1 Technical Reference Guide for more information on administering command line utilities.

Enter:

./multiserverinstance delete -instance instance-name

If you are also removing the Sun Java System Access Manager, uninstall the Access Manager instance. For instructions on uninstalling an Access Manager instance, see the Chapter 1 of the Sun Java System Access Manager Administration Guide at: http://docs.sun.com/.

Previous Contents Index Next
Sun Java System Portal Server 6 2005Q1 Administration Guide