Sun ONE Portal Server 6.2 Installation Guide |
Appendix D
Creating and Deleting Instances of the ServerAn instance is a server that listens on a particular port, bound to either one or more IP addresses. For the Sun ONE 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
- Log in to the server running the Sun ONE Portal Server.
- Go to the Sun ONE Identity Server utilities directory
cd identity-server-install-root/SUNWam/bin
- Run the following command:
./amserver create
- Enter a name for the new instance when prompted.
- Enter an unused port for the new instance when prompted.
- If you want to create more instances, type y and press Enter when asked the question:
Do you want to create more server instances? y/[n] y.
Repeat Step 4 and Step 5 for each instance that you wish to create. Otherwise press Enter to create the server instances.
- Enter the amadmin password when prompted.
- Go to the web server install directory.
- To verify that the instance has been created, use the ls command.
- Go to the directory for the newly created instance.
cd https-new-instance-name
- Run the start script for the newly created instance.
./start
- Go to the Portal Server utilities directory.
cd portal-server-install-root/SUNWps/bin
- Run the multiserverinstance script.
./multiserverinstance
- Enter the name of the instance from Step 4.
- Enter the port of the new instance from Step 5.
- If you have portlets, redeploy them. For instructions to redeploy portlets, consult the Sun ONE Portal Server 6.2 Administrator’s Guide.
- After the multiservinstance script exits, go to the web server instance directory.
cd web-server-install-root/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.
- In a browser, enter:
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 identity-server-install-root/SUNWam/bin/amserver.instance-nickname
if [ ‘$ID | $AWK ’{print $1}’‘ != "uid=0(root)" ]; then
$ECHO "You must be root user. $BELL_CHAR"
exit 1
fi
To Delete an Instance of the Server
- Log in to the server running the Sun ONE Portal Server.
- Change directories to portal-server-install-root/SUNWps/bin.
cd portal-server-install-root/SUNWps/bin
- If you have portlets, remove them. For instructions, see the Sun ONE Portal Server 6.2 Administrator’s Guide
- Enter:
./multiserverinstance delete -instance instance-name
- If you are also removing the Sun ONE Identity Server, change directories to the Identity Server utilities directory.
cd identity-server-install-root/SUNWam/bin
- Enter:
./amserver delete instance-name