Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Reference Manual

## add-resources(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | SEE ALSO

#### NAME

add-resources– creates the resources specified in an XML file

#### SYNOPSIS

`add-resources` ––user admin_user [––passwordfile filename] [––host host_name] [––port port_number] [––secure|`–s`] [––terse=false] [––echo=false] [––interactive=true] [––help] [––target target] xml_file_path

#### DESCRIPTION

The `add-resources` command creates the resources named in the specified XML file. The xml_file_path is the path to the XML file containing the resources to be created. The `DOCTYPE` should be specified as `install_dir/lib/dtds/sun-resources_1_0.dtd` in the `resources.xml` file.

This command is supported in remote mode only.

#### OPTIONS

`–u` `––user`

  The authorized domain application server administrative username.

`–w` `––password`

  The `––password` option is deprecated. Use `––passwordfile` instead.

`––passwordfile`

  This option replaces the `–– password` option. Using the `––password` option on the command line or through the environment is deprecated. The `––passwordfile` option specifies the name of a file containing the password entries in a specified format. The entry for the password must have the AS_ADMIN_ prefix followed by the password name in capital letters. For example, to specify the domain application server password, use an entry with the following format: `AS_ADMIN_PASSWORD`=password, where password is the actual administrator password. Other passwords that can be specified include AS_ADMIN_MAPPEDPASSWORD, AS_ADMIN_USERPASSWORD, AS_ADMIN_SAVEDMASTERPASSWORD, AS_ADMIN_MQPASSWORD, AS_ADMIN_ALIASPASSWORD, and so on.

`–H` `––host`

  The machine name where the domain application server is running. The default value is localhost.

`–p` `––port`

  The port number of the domain application server listening for administration requests. The default port number for Enterprise Edition is 4849.

`–s` `––secure`

  If set to true, uses SSL/TLS to communicate with the domain application server.

`–t` `––terse`

  Indicates that any output data must be very concise, typically avoiding human-friendly sentences and favoring well-formatted data for consumption by a script. Default is false.

`–e` `––echo`

  Setting to true will echo the command line statement on the standard output. Default is false.

`–I` `––interactive`

  If set to true (default), only the required password options are prompted.

`–h` `––help`

  Displays the help text for the command.

`––target`

  In Enterprise Edition, specifies the target for which you are creating the resources. Valid values are

  - `server`, which creates the resources for the default server instance `server` and is the default value

  - `domain`, which creates the resources for the domain

  - cluster_name, which creates the resources for every server instance in the cluster

  - instance_name, which creates the resources for a particular server instance

#### OPERANDS

xml_file_path

  The path to the XML file containing the resource(s) to be created.

  An example XML file follows. Replace `<install_dir>` with the location of your Application Server installation.

      <?xml version="1.0" encoding="UTF-8"?>
      <!DOCTYPE resources PUBLIC
         "-//Sun Microsystems Inc.//DTD Application Server 8.0 Domain//EN"
         "*<install_dir>/lib/dtds/sun-resources_1_0.dtd*">

      <resources>
       <jdbc-connection-pool name="SPECjPool" steady-pool-size="100"
         max-pool-size="150" max-wait-time-in-millis="60000"
         pool-resize-quantity="2" idle-timeout-in-seconds="300"
         is-isolation-level-guaranteed="true"
         is-connection-validation-required="false"
         connection-validation-method="auto-commit"
         fail-all-connections="false"
         datasource-classname="oracle.jdbc.pool.OracleDataSource">
        <property name="URL"
          value="jdbc:oracle:thin:@iasperfsol12:1521:specdb"/>
        <property name="User" value="spec"/>
        <property name="Password" value="spec"/>
        <property name="MaxStatements" value="200"/>
        <property name="ImplicitCachingEnabled" value="true"/>
       </jdbc-connection-pool>
       <jdbc-resource enabled="true" pool-name="SPECjPool"
         jndi-name="jdbc/SPECjDB"/>
      </resources>

#### EXAMPLES

##### Example 1 Using the add-resources command

The following command creates resources using the contents of the XML file `resource.xml`:

    asadmin> add-resources --user admin --passwordfile passwords.txt
    --host localhost --port 4848 resource.xml
    Command add-resources executed successfully.

#### EXIT STATUS

0

  command executed successfully

1

  error in executing the command

#### SEE ALSO

create-jdbc-connection-pool(1), create-jdbc-resource(1), create-jms-resource(1), create-jndi-resource(1), create-javamail-resource(1), create-persistence-resource(1), create-custom-resource(1)

J2EE SDK 1.4 Last Revised 31 Jan 2005

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | SEE ALSO

- © 2010, Oracle Corporation and/or its affiliates