N1 Grid Service Provisioning System User's Guide and Release Notes for the Sun Java System App Server Plug-In 1.0

Managing Sun Java Enterprise System Application Server Resources

This section describes how to manage Sun Java Enterprise System Application Server resources: JMS resources, JDBC resources, and thread pools.

Managing Java Messaging Service (JMS) Resources

ProcedureHow to Install a JMS Resource on a Host

Steps
  1. From the Common Tasks section in the browser interface, click Sun Java System AS 8.

  2. Under SJSAS AppServer Resources->SJSAS 8.1 JMS Resource click Manage JMS Resources.

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

  4. In the Plan Parameters area, select the variable settings for the JMS Resource you want to install.

    • If the variable settings have been established for this component, select the appropriate settings from the menu.

    • If the settings are not available from the menu, click Select From List.

      The Select Variable Settings From List window displays.

      • To create a new set of variable settings, select Create Set.

        The following list provides commonly-updated variables for the Install component.

        variable set name

        Required. A name for the new variable set you create.

        installIdentifier

        A unique ID to associate the JMS Resource with an Install component.

        domainName

        The domain name in which this JMS Resource will be located

      • To use variable components from another component, click Import Set.

        For more information about importing variable sets, see “How to Run a Plan” in N1 Grid Service Provisioning System 5.0 Operation and Provisioning Guide.

  5. Select the target host.

  6. Deselect the Target Host Set checkbox.

  7. If you want to run a detailed check (preflight) before installing, select Perform Detailed Preflight.

  8. Click Run Plan (includes preflight).

ProcedureHow to Create a JMS Resource

Steps
  1. From the Common Tasks section in the browser interface, click Sun Java System AS 8.

  2. Under SJSAS AppServer Resources->SJSAS 8.1 JMS Resource click Manage JMS Resources.

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

  4. Select the installation on which you want to create the JMS resource.

  5. Under Plan Variables:

    1. Select the resource type. It can be one of:

      • Topic

      • Queue

      • ConnectionFactory

      • TopicConnectionFactory

      • QueueConnectionFactory

    2. Enter the JNDI name for the resource.

    3. Enter the target cluster or server name where the resource will be created.

    4. (Optional) Enter a description of the resource.

    5. Enter any JMS properties, separated by colons (:).

      Valid property names are:

      • ClientId

      • AddressList

      • MessageServiceAddressList

      • UserName

      • Password

      • ReconnectEnabled

      • ReconnectAttempts

      • ReconnectInterval

      • AddressListBehavior

      • AddressListIterations

  6. Click Run Plan (includes preflight).

ProcedureHow to Delete a JMS Resource

Steps
  1. From the Common Tasks section in the browser interface, click Sun Java System AS 8.

  2. Under SJSAS AppServer Resources->SJSAS 8.1 JMS Resource click Manage JMS Resources.

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

  4. Select the installation on which you want to delete the JMS resource.

  5. Under Plan Variables:

    1. Enter the JNDI name of the resource you want to delete.

    2. Enter the target name of the resource you want to delete.

  6. Click Run Plan (includes preflight).

Managing Java Database Connectivity (JDBC) Resources

ProcedureHow to Install a JDBC Resource on a Host

Steps
  1. From the Common Tasks section in the browser interface, click Sun Java System AS 8.

  2. Under SJSAS AppServer Resources->SJSAS 8.1 JDBC Resource click Manage JDBC Resources.

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

  4. In the Plan Parameters area, select the variable settings for the JDBC Resource you want to install.

    • If the variable settings have been established for this component, select the appropriate settings from the menu.

    • If the settings are not available from the menu, click Select From List.

      The Select Variable Settings From List window displays.

      • To create a new set of variable settings, select Create Set.

        The following list provides commonly-updated variables for the Install component.

        variable set name

        Required. A name for the new variable set you create.

        installIdentifier

        A unique ID to associate the JDBC Resource with an Install component.

        domainName

        The domain name in which this JDBC Resource will be located

      • To use variable components from another component, click Import Set.

        For more information about importing variable sets, see “How to Run a Plan” in N1 Grid Service Provisioning System 5.0 Operation and Provisioning Guide.

  5. Select the target host.

  6. Deselect the Target Host Set checkbox.

  7. If you want to run a detailed check (preflight) before installing, select Perform Detailed Preflight.

  8. Click Run Plan (includes preflight).

ProcedureHow to Create a JDBC Resource

Steps
  1. From the Common Tasks section in the browser interface, click Sun Java System AS 8.

  2. Under SJSAS AppServer Resources->SJSAS 8.1 JDBC Resource click Manage JDBC Resources.

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

  4. Select the installation on which you want to create the JDBC resource.

  5. Under Plan Variables:

    1. Set the name of the Connection Pool.

    2. Enter the JNDI name for the resource.

    3. Enter the target cluster or server name where the resource will be created.

    4. (Optional) Enter a description of the resource.

    5. Enter any JDBC properties, separated by colons (:).

  6. Click Run Plan (includes preflight).

ProcedureHow to Delete a JDBC Resource

Steps
  1. From the Common Tasks section in the browser interface, click Sun Java System AS 8.

  2. Under SJSAS AppServer Resources->SJSAS 8.1 JDBC Resource click Manage JDBC Resources.

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

  4. Select the installation on which you want to delete the JDBC resource.

  5. Under Plan Variables:

    1. Enter the JNDI name of the resource you want to delete.

    2. Enter the target cluster or server instance name of the resource you want to delete.

  6. Click Run Plan (includes preflight).

ProcedureHow to List JDBC Resources

Steps
  1. From the Common Tasks section in the browser interface, click Sun Java System AS 8.

  2. Under SJSAS AppServer Resources->SJSAS 8.1 JDBC Resource click Manage JDBC Resources.

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

  4. Select the installation on which you want to list the JDBC resources.

  5. Under Plan Variables enter the target cluster or server instance name of the resource you want to delete.

  6. Click Run Plan (includes preflight).

ProcedureHow to Create a JDBC Connection Pool

Steps
  1. From the Common Tasks section in the browser interface, click Sun Java System AS 8.

  2. Under SJSAS AppServer Resources->SJSAS 8.1 JDBC Resource click Manage JDBC Resources.

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

  4. Select the installation on which you want to create the connection pool.

  5. Under Plan Variables:

    1. Set the name of the Connection Pool.

    2. (Optional) Enter a description of the connection pool.

    3. Enter the JDBC data source resource manager for your connection pool.

    4. Enter the interface the data source class implements.

      Valid entries are:

      • DataSource

      • ConnectionPoolDataSource

      • XADataSource

    5. Enter the minimum number of connections created by the pool.

    6. Enter the maximum number of connections maintained by the pool.

    7. Enter the number of connections to be removed when the time out timer expires.

    8. Enter the maximum number of seconds a connection can be idle in the pool.

    9. Enter the transaction isolation level for the connection pool.

      Valid entries are:

      • read-uncommitted

      • read-committed

      • repeatable-read

      • serializable

      If the entry is blank, the default isolation level of the JDBC driver is used.

    10. Specify whether the connections should be validated before being allocated to an application. Valid entries are true or false.

    11. Enter any attribute name/value pairs for the JDBC driver.

  6. Click Run Plan (includes preflight).

ProcedureHow to Delete a JDBC Connection Pool

Steps
  1. From the Common Tasks section in the browser interface, click Sun Java System AS 8.

  2. Under SJSAS AppServer Resources->SJSAS 8.1 JDBC Resource click Manage JDBC Resources.

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

  4. Select the installation on which you want to delete the JDBC resource.

  5. Under Plan Variables:

    1. Enter the name of the connection pool you want to delete.

    2. Specify whether all connector resources associated with the connection pool should also be deleted. Valid entries are true or false.

  6. Click Run Plan (includes preflight).

ProcedureHow to List JDBC Connection Pools

Steps
  1. From the Common Tasks section in the browser interface, click Sun Java System AS 8.

  2. Under SJSAS AppServer Resources->SJSAS 8.1 JDBC Resource click Manage JDBC Resources.

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

  4. Select the installation on which you want to list the JDBC resources.

  5. Click Run Plan (includes preflight).

Managing Thread Pool Resources

ProcedureHow to Install a Thread Pool Resource on a Host

Steps
  1. From the Common Tasks section in the browser interface, click Sun Java System AS 8.

  2. Under SJSAS AppServer Resources->SJSAS 8.1 Threadpool Resource click Manage Threadpool Resources.

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

  4. In the Plan Parameters area, select the variable settings for the Thread Pool Resource you want to install.

    • If the variable settings have been established for this component, select the appropriate settings from the menu.

    • If the settings are not available from the menu, click Select From List.

      The Select Variable Settings From List window displays.

      • To create a new set of variable settings, select Create Set.

        The following list provides commonly-updated variables for the Install component.

        variable set name

        Required. A name for the new variable set you create.

        installIdentifier

        A unique ID to associate the thread pool resource with an Install component.

        domainName

        The domain name in which this thread pool resource will be located

      • To use variable components from another component, click Import Set.

        For more information about importing variable sets, see “How to Run a Plan” in N1 Grid Service Provisioning System 5.0 Operation and Provisioning Guide.

  5. Select the target host.

  6. Deselect the Target Host Set checkbox.

  7. If you want to run a detailed check (preflight) before installing, select Perform Detailed Preflight.

  8. Click Run Plan (includes preflight).

ProcedureHow to Create a Thread Pool Resource

Steps
  1. From the Common Tasks section in the browser interface, click Sun Java System AS 8.

  2. Under SJSAS AppServer Resources->SJSAS 8.1 Threadpool Resource click Manage Threadpool Resources.

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

  4. Select the installation on which you want to create the connection pool.

  5. Under Plan Variables:

    1. Enter the thread pool ID.

    2. Enter the maximum number of threads in the thread pool servicing requests.

    3. Enter the minimum number of threads in the thread pool servicing requests.

    4. Enter the idle time out value, in seconds, after which idle threads will be returned to the pool.

    5. Enter the total number of work queues serviced by the thread pool.

    6. Enter the cluster or server instance name on which the thread pool will be created.

  6. Click Run Plan (includes preflight).

ProcedureHow to Delete a Thread Pool Resource

Steps
  1. From the Common Tasks section in the browser interface, click Sun Java System AS 8.

  2. Under SJSAS AppServer Resources->SJSAS 8.1 Threadpool Resource click Manage Threadpool Resources.

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

  4. Select the installation on which you want to delete the thread pool.

  5. Click Run Plan (includes preflight).

ProcedureHow to List Threadpools on a Target

Steps
  1. From the Common Tasks section in the browser interface, click Sun Java System AS 8.

  2. Under SJSAS AppServer Resources->SJSAS 8.1 Threadpool Resource click Manage Threadpool Resources.

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

  4. Select the installation on which you want to list the thread pools.

  5. Under Plan Variables enter the target cluster or server instance name on which you want to list the thread pools.

  6. Click Run Plan (includes preflight).