Java CAPS Domain and Runtime Installation

Creating a New Java CAPS Domain

You can create a new Java CAPS domain by running an asadmin command. The instructions below provide an example of a very simple command with few parameters, but you can specify additional information such as the location for the domain files, a password file, and so on. For a complete list of options, type asadmin create-domain at the command line.


Note –

Do not abbreviate the following instructions by running asadmin and then entering all command at the asadmin prompt. Run each command separately as noted below to avoid any loss of information.


ProcedureTo Create a New Java CAPS Domain

  1. Do one of the following:

    • Add the following path to your PATH environment variable: appserver/bin, where appserver is the path to your GlassFish home directory for Java CAPS.

    • Navigate to appserver/bin.

  2. Run the following command:

    asadmin create-domain --portbase PortBaseNumber --savemasterpassword=true --savelogin=true DomainName

    where PortBaseNumber is the port number with which port assignment starts and DomainName is the name you want to give the new domain.


    Note –

    Use the --savemasterpassword option to encrypt and save the master password so you do not need to enter it for asadmin commands. Use the --savelogin option to encrypt and save the admin password in UserHomeDirectory/.asadminpass. This enables the Access Manager to configure itself after the domain is first started.

    For more information about create-domain options, see create-domain(1).


  3. Enter the administrator login credentials when prompted.

  4. (Optional) If you need STCMS (Java CAPS JMS) support in the new domain, run the following command:

    asadmin create-stcms --domainname DomainName --stcmsport PortNumber STCMSName

    where:

    • DomainName is the name you assigned to the new domain above

    • PortNumber is the port number for STCMS (typically the base port number plus seven)

    • STCMSName is a unique name for the message service

  5. Run the following command to start the new domain:

    asadmin start-domain DomainName

  6. Continue to Installing a Java CAPS Runtime on a New Domain.