Java CAPS Runtime Installation

This topic provides instructions on how to perform a runtime installation on new Java^TM Composite Application Platform Suite (Java CAPS) domains. If you have any questions or problems, see the Java CAPS Support web site at http://goldstar.stc.com/support.

To access all the Java CAPS documentation in HTML format on the Sun Developer Network (SDN) web site, go to http://developers.sun.com/docs/javacaps/ or click the HELP tab in Enterprise Manager.

The HELP tab in the Java CAPS Uploader opens the “Installing Java CAPS Components Using the Java CAPS Uploader” topic.

What You Need to Know

• Overview of a Runtime Installation

What You Need to Do

• Runtime Installation for Domains

Overview of a Runtime Installation

The Java CAPS runtime is installed with a complete Java CAPS installation. During this installation domain1 is automatically created with a runtime. However, if you create a second domain, such as domain2, this domain does not have a runtime. You need to install the runtime for this domain.

To set the properties for the new domain, edit the install.properties file or specify the settings on the command line. The install.properties file is located in JavaCAPS6\appserver\addons\caps.

If, after installing the runtime add-on scripts on a domain, you run the runtime add-on scripts on this domain a second time it is going to fail.

Runtime Installation for Domains

Whenever you create a domain after completing the initial Java CAPS installation you must add the runtime to it. This installation assumes that you intend to use the default configurations for the Sun Java System Application Server; that is, domain1, 4848, admin, adminadmin, and changeit. If any of these parameters are different, such as the name of the domain, edit the install.properties file, which is located in JavaCAPS\appserver\addons\caps directory before you install the runtime on the new domain. The install.properties contains the domain configuration, and defines where to install and deploy components, as well as how to connect to the application server. You can also specify the changed parameters for domain name, port number, and username on the command line.

To Install Runtime on a Domain

1. From the command line, navigate to the directory where the new domain is located.

2. Run the command appserver\bin>asant -f ..\addons\caps\install.xml

   Where:

   ..\addons is the directory where you installed the Java CAPS runtime components during the Java CAPS installation.

3. Restart the Sun Java System Application Server.