Sun ONE logo      Previous      Contents      Index      Next     

Sun ONE Portal Server 6.2 Installation Guide

Appendix D
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™ ONE Portal Server, an instance corresponds to a web server process listening on a port and running a single Java™ Virtual Machine (JVM™).


Multiple-instances are supported only with Sun™ ONE Web Server.

To Create an Instance of the Server

  1. Log in to the server running the Sun ONE Portal Server.
  2. Go to the Sun™ ONE Identity Server utilities directory
  3. cd identity-server-install-root/SUNWam/bin

  4. Run the following command:
  5. ./amserver create

  6. Enter a name for the new instance when prompted.
  7. Enter an unused port for the new instance when prompted.
  8. If you want to create more instances, type y and press Enter when asked the question:
  9. 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.

  10. Enter the amadmin password when prompted.
  11. Go to the web server install directory.
  12. To verify that the instance has been created, use the ls command.
  13. Go to the directory for the newly created instance.
  14. cd https-new-instance-name

  15. Run the start script for the newly created instance.
  16. ./start

  17. Go to the Portal Server utilities directory.
  18. cd portal-server-install-root/SUNWps/bin

  19. Run the multiserverinstance script.
  20. ./multiserverinstance

  21. Enter the name of the instance from Step 4.
  22. Enter the port of the new instance from Step 5.
  23. If you have portlets, redeploy them. For instructions to redeploy portlets, consult the Sun ONE Portal Server 6.2 Administrator’s Guide.
  24. After the multiservinstance script exits, go to the web server instance directory.
  25. cd web-server-install-root/https-new-instance-name

  26. Stop the web server instance.
  27. ./stop

  28. Restart the web server instance.
  29. ./start

  30. Go to the newly created instance in a browser.
  31. Repeat steps Step 9 through Step 20 for each newly created instance.
  32. 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 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


To Delete an Instance of the Server

  1. Log in to the server running the Sun ONE Portal Server.
  2. Change directories to portal-server-install-root/SUNWps/bin.
  3. cd portal-server-install-root/SUNWps/bin

  4. If you have portlets, remove them. For instructions, see the Sun ONE Portal Server 6.2 Administrator’s Guide
  5. Enter:
  6. ./multiserverinstance delete -instance instance-name

  7. If you are also removing the Sun ONE Identity Server, change directories to the Identity Server utilities directory.
  8. cd identity-server-install-root/SUNWam/bin

  9. Enter:
  10. ./amserver delete instance-name

Previous      Contents      Index      Next     

Copyright 2003 Sun Microsystems, Inc. All rights reserved.