Managing Sun Java System App Server Instances and Clusters

This section describes how to maintain Sun Java System App Server managed server instances and clusters.

Managing Sun Java System App Server Domains and Domain Administration Servers

The following are component procedures for Sun Java System App Server 8.1 Domain Management:

install: default

Creates a domain on the target host and marks the component installed in the Sun N1 Service Provisioning System database.

uninstall: default

Same as markOnly; marks the component and also the dependant components as uninstalled in the Sun N1 Service Provisioning System database.

uninstall: deleteDomain

Deletes the domain from the target host and marks the component as uninstalled in the Sun N1 Service Provisioning System database.

startCompleteDomain

Starts the domain and the dependant components.

stopCompleteDomain

Stops the domain and the dependant components.

verifyDomainServerRunning

Verifies that the domain is running.

startDomainServer

Starts the domain admin server.

stopDomainServer

Stops the domain admin server.

listDomains

Lists all domains.

How to Remove a Sun Java System App Server Domain and Domain Administration Server

By removing an Application Server domain through the provisioning system, you automatically perform the following tasks:

• Uninstall the Domain Administration Server.

• Uninstall all Managed Servers components in the domain.

• Uninstall all cluster components in the domain.

• Remove application components and applications.

Before You Begin

To remove an Application Server domain, you must belong to a user group that has the Run Component Procedures permission on the folder that contains the component. You must also have the Allow on Host Set permission for the host set on which you plan to run the component.

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS 8.1 AppServer infrastructure->SJSAS 8.1 domains click Manage.

3. Under Component Procedures click the Run action next to uninstall: default.

4. Under Current Installations, select the domains that you would like to remove.

5. Click the Run Selected Installations button.

6. Click the Run Plan (Includes Preflight) button.

How to Start a Complete Domain

Starting a complete domain starts the domain's Domain Administration Server if it is not currently running, all clusters in the domain, and all managed server instances in the domain.

Before You Begin

To start an Application Server domain, you must belong to a user group that has the Run Component Procedures permission on the folder that contains the component. You must also have the Allow on Host Set permission for the host set on which you plan to run the component.

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS 8.1 AppServer infrastructure->SJSAS 8.1 domains, click Manage.

3. Under Component Procedures, click the Run action next to startCompleteDomain.

4. Under Current Installations, select the domain that you would like to start.

5. Click the Run Selected Installations button.

6. Click the Run Plan (Includes Preflight) button.

How to Stop a Complete Domain

Stopping a completed domain stops all running clusters and all running managed server instances for a particular domain.

Before You Begin

To stop an Application Server domain, you must belong to a user group that has the Run Component Procedures permission on the folder that contains the component. You must also have the Allow on Host Set permission for the host set on which you plan to run the component.

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS 8.1 AppServer infrastructure->SJSAS 8.1 domains click Manage.

3. Under Component Procedures click the Run action next to stopCompleteDomain.

4. Under Current Installations, select the domain that you would like to stop.

5. Click the Run Selected Installations button.

6. Click the Run Plan (Includes Preflight) button.

How to Start a Domain Administration Server

Before You Begin

To start an Application Server Domain Administration Server, you must belong to a user group that has the Run Component Procedures permission on the folder that contains the component. You must also have the Allow on Host Set permission for the host set on which you plan to run the component.

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS 8.1 AppServer infrastructure->SJSAS 8.1 domains click Manage.

3. Under Component Procedures click the Run action next to startDomainServer.

4. Under Current Installations, select the domains that you would like to start.

5. Click the Run Selected Installations button.

6. Click the Run Plan (Includes Preflight) button.

How to Stop a Domain Administration Server

Before You Begin

To stop an Application Server Domain Administration Server, you must belong to a user group that has the Run Component Procedures permission on the folder that contains the component. You must also have the Allow on Host Set permission for the host set on which you plan to run the component.

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS 8.1 AppServer infrastructure->SJSAS 8.1 domains click Manage.

3. Under Component Procedures click the Run action next to stopDomainServer.

4. Under Current Installations, select the domains that you would like to stop.

5. Click the Run Selected Installations button.

6. Click the Run Plan (Includes Preflight) button.

How to Verify a Domain Administration Server is Running

You can verify that a Domain Administration Server is running on a particular installation.

Before You Begin

To verify a Domain Administration Server is running, you must belong to a user group that has the Run Component Procedures permission on the folder that contains the component. You must also have the Allow on Host Set permission for the host set on which you plan to run the component.

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS 8.1 AppServer infrastructure->SJSAS 8.1 domains click Manage.

3. Under Component Procedures, click the Run action next to verifyDomainServerRunning.

4. Under Current Installations, select the domains that you would like to verify.

5. Click the Run Selected Installations button.

6. Click the Run Plan (Includes Preflight) button.

Managing Sun Java System App Server Clusters

The following are component procedures for Sun Java System App Server 8.1 Cluster Management:

install: default

Creates a cluster on the target host and marks the component as installed in the Sun N1 Service Provisioning System database.

install: markOnly

Marks the component as installed in the Sun N1 Service Provisioning System database. This procedure does not create any dependency on other components.

uninstall: default

Similar to markOnly; marks the component and also dependant components as uninstalled in the Sun N1 Service Provisioning System database.

uninstall: markOnly

Marks the component as uninstalled in the Sun N1 Service Provisioning System database. This procedure does not mark the dependant components as uninstalled in the Sun N1 Service Provisioning System database.

uninstall: delete

Deletes the cluster from the target host. Marks the component as uninstalled, removes the component, and removes dependant components in the Sun N1 Service Provisioning System database.

start

Starts the cluster. The cluster must contain one or more Managed Server components.

stop

Stops the cluster.

verifyClusterRunning

Verifies that the cluster is running.

How to Remove a Sun Java System App Server Cluster

When you remove a cluster, all managed server instances associated with that cluster are also removed.

Before You Begin

To remove a cluster, you must belong to a user group that has the Run Component Procedures permission on the folder that contains the component. You must also have the Allow on Host Set permission for the host set on which you plan to deploy the component.

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS 8.1 AppServer infrastructure->SJSAS 8.1 clusters click Manage.

3. Under Component Procedures, click the Run action next to uninstall: default.

4. Under Current Installations, select the clusters that you would like to remove.

5. Click the Run Selected Installations button.

6. Click the Run Plan (Includes Preflight) button.

How to Start a Sun Java System App Server Cluster

Before You Begin

To start a cluster, you must belong to a user group that has the Run Component Procedures permission on the folder that contains the component. You must also have the Allow on Host Set permission for the host set on which you plan to deploy the component.

A cluster is not a running instance, so when you start the cluster, you are actually starting the managed server instances associated with the cluster.

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS 8.1 AppServer infrastructure->SJSAS 8.1 clusters click Manage.

3. Under Component Procedures, click the Run action next to start.

4. Under Current Installations, select the clusters that you would like to start.

5. Click the Run Selected Installations button.

6. Click the Run Plan (Includes Preflight) button.

How to Stop a Sun Java System App Server Cluster

Before You Begin

To stop a cluster, you must belong to a user group that has the Run Component Procedures permission on the folder that contains the component. You must also have the Allow on Host Set permission for the host set on which you plan to deploy the component.

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS 8.1 AppServer infrastructure->SJSAS 8.1 clusters click Manage.

3. Under Component Procedures, click the Run action next to stop.

4. Under Current Installations, select the clusters that you would like to stop.

5. Click the Run Selected Installations button.

6. Click the Run Plan (Includes Preflight) button.

How to Verify a Sun Java System App Server Cluster is Running

Before You Begin

To verify a cluster, you must belong to a user group that has the Run Component Procedures permission on the folder that contains the component. You must also have the Allow on Host Set permission for the host set on which you plan to deploy the component.

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS 8.1 AppServer infrastructure->SJSAS 8.1 clusters click Manage.

3. Under Component Procedures, click the Run action next to verifyClusterRunning.

4. Under Current Installations, select the clusters that you would like to verify.

5. Click the Run Selected Installations button.

6. Click the Run Plan (Includes Preflight) button.

Managing Sun Java System App Server Instances

The following are component procedures for Sun Java System App Server 8.1 Managed Server Instance Management:

install: default

Creates a server instance on the target host, marks this component as installed in the Sun N1 Service Provisioning System database and creates the dependency.

install: markOnly

Marks the component as installed in the Sun N1 Service Provisioning System database and does not create any dependency.

uninstall: default

Marks the component and dependent components as uninstalled in the Sun N1 Service Provisioning System database.

uninstall: markOnly

Marks the component as uninstalled in the Sun N1 Service Provisioning System database. This procedure does not mark the dependant components as uninstalled in the Sun N1 Service Provisioning System database.

uninstall: delete

Deletes the server instance from the target host. Marks the component as uninstalled, removes the component, and removes dependant components in the Sun N1 Service Provisioning System database.

start

Starts the server instances.

stop

Stops the server instances.

verifyServerRunning

Verifies that the server is running.

How to Remove a Sun Java System App Server Instance

Before You Begin

To remove a server instance you must belong to a user group that has the Run Component Procedures permission on the folder that contains the component. You must also have the Allow on Host Set permission for the host set on which you plan to deploy the component.

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS 8.1 AppServer infrastructure->SJSAS 8.1 Managed Server Instances click Manage.

3. Under Component Procedures, click the Run action next to uninstall: default.

4. Under Current Installations, select the server instances that you would like to remove.

5. Click the Run Selected Installations button.

6. Click the Run Plan (Includes Preflight) button.

How to Start a Sun Java System App Server Instance

Before You Begin

To start a server instance, you must belong to a user group that has the Run Component Procedures permission on the folder that contains the component. You must also have the Allow on Host Set permission for the host set on which you plan to deploy the component.

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS 8.1 AppServer infrastructure->SJSAS 8.1 Managed Server Instances click Manage.

3. Under Component Procedures, click the Run action next to start.

4. Under Current Installations, select the server instances that you would like to start.

5. Click the Run Selected Installations button.

6. Click the Run Plan (Includes Preflight) button.

How to Stop a Sun Java System App Server Instance

Before You Begin

To stop a server instance you must belong to a user group that has the Run Component Procedures permission on the folder that contains the component. You must also have the Allow on Host Set permission for the host set on which you plan to deploy the component.

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS 8.1 AppServer infrastructure->SJSAS 8.1 Managed Server Instances click Manage.

3. Under Component Procedures, click the Run action next to stop.

4. Under Current Installations, select the server instances that you would like to stop.

5. Click the Run Selected Installations button.

6. Click the Run Plan (Includes Preflight) button.

How to Verify a Sun Java System App Server Instance is Running

Before You Begin

To verify a server instance is running you must belong to a user group that has the Run Component Procedures permission on the folder that contains the component. You must also have the Allow on Host Set permission for the host set on which you plan to deploy the component.

Steps

1. From the Common Tasks section in the browser interface, click AppServer 8.1.

2. Under SJSAS 8.1 AppServer infrastructure->SJSAS 8.1 Managed Server Instances click Manage.

3. Under Component Procedures, click the Run action next to verifyServerRunning.

4. Under Current Installations, select the server instance that you would like to verify.

5. Click the Run Selected Installations button.

6. Click the Run Plan (Includes Preflight) button.