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

## update-connector-security-map(1)

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

#### NAME

update-connector-security-map– creates or modifies a security map for the specified connector connection pool

#### SYNOPSIS

`update-connector-security-map` ––user admin_user [––passwordfile filename] [––host host_name] [––port port_number] [––secure|`–s`] [––terse=false] [––echo=false] [––interactive=true] [––help] ––poolname connector_connection_pool_name [––addprincipals principal_name1`[[, principal_name1]]*` | ––addusergroups user_group1`[[, user_group2]]*`] [––removeprincipals principal_name1`[[, principal_name2]]*`] [––removeusergroups user_group1`[[, user_group2]]*`] [––mappedusername username ] security_map_name

#### DESCRIPTION

Use this command to create or modify a security map for the specified connector connection pool. If the security map is not present, one is created. If a specific security map is specified, the components of the security map (user name, groups, and principals) are provided.

For this command to succeed, you must have first created a connector connection pool using the `create-connector-connection-pool` command.

The enterprise information system (EIS) is any system that holds the information. It can be a mainframe, a messaging system, a database system, or an application.

This command is supported in remote mode only.

#### OPTIONS

If an option has a short option name, then the short option preceeds the long option name. Short options have one dash whereas long options have two dashes.

`–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`

  This option is deprecated in this release.

`––poolname`

  This property specifies the name of the connector connection pool to which the security map that is to be updated or created belongs.

`––addprincipals`

  This property specifies a comma-separated list of EIS-specific principals to be added. Use either the `-addprincipals` or `-addusergroups` options, but not both.

`––addusergroups`

  This property specifies a comma-separated list of EIS user groups to be added. Use either the `-addprincipals` or `-addusergroups` options, but not both at the same time.

`––removeprincipals`

  This property specifies a comma-separated list of EIS-specific principals to be removed.

`––removeusergroups`

  This property specifies a comma-separated list of EIS user groups to be removed.

`––mappedusername`

  This property specifies the EIS username.

`––mappedpassword`

  The `––mappedpassword` option is deprecated. Use `––passwordfile` pointing to a file that contains an entry in the following format: `AS_ADMIN_MAPPEDPASSWORD`=mapped-password. If not specified using the `passwordfile` option, the user will be prompted for this password by the asadmin command-line tool.

#### OPERANDS

security_map_name

  name of the security map to be created or updated.

#### EXAMPLES

##### Example 1 Using `update-connector-security-map`

It is assumed that the connector pool has already been created using the `create-connector-pool` command.

    asadmin> update-connector-security-map --user admin
    --poolname connector-pool1 --addprincipals principal1, principal2
    securityMap1
    Command update-connector-security-map executed successfully

#### EXIT STATUS

0

  command executed successfully

1

  error in executing the command

#### SEE ALSO

delete-connector-security-map(1), list-connector-security-maps(1), create-connector-security-map(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