wls_deploymw

Description

Deploys the Enterprise Security middleware to a BEA WebLogic server.

NoteAfter deploying Enterprise Security to a WebLogic server, the administrator must perform the additional configuration steps described in “Deploying and configuring security in WebLogic”.

Syntax

wls_deploymw --enkfile file_name --security_dir secure_dir 
                 --shared_dir share_dir --wls_admin_password password
                 --wls_admin_username user_name -- wls_dir directory
[--database_type sybase_ase | sybase_asa | oracle]
[--entldb_password password] 
[--entldb_username user_name] 
[--jdbc_admin_password password]
[--jdbc_admin_username user_name] 
[--jdbc_driver driver] 
[--jdbc_url URL] 
[--sybase_asa asa_service_name
[--wls_admin_host host_name] 
[--wls_admin_port port] 
[--wls_domain_dir directory] 
[--wls_servername server]
[--wls_systemuser systemUser]

Argument

Datatype

Default value

Description

* enkfile

string

Encryption key file to use; must be a readable file.

* security_dir

string

Enterprise Security installation directory.

* shared_dir

string

Sybase shared directory.

* wls_admin_password

string

Password for the user identified by wls_admin_username.

* wls_admin_username

string

User name for the WebLogic administrator.

* wls_dir

string

WebLogic installation directory.

database_type

choice

sybase_ase

The database type. This value is used to determine the default values for the jdbc_url and jdbc_driver arguments.Acceptable values are:

  • sybase_ase (the default)

  • sybase_asa

  • oracle

entldb_password

string

dbopswd

Password of the user specified by entldb_username.

entldb_username

string

acdbdbo

User name for connecting to the database. This user should have read and write privileges on the security database only.

jdbc_admin_password

string

The password for the user identified by jdbc_admin_username.

jdbc_admin_username

string

sa

The user name for connecting to the database for administrative purposes (creating databases, tables, and so on).

jdbc_driver

Java class name

com.sybase.jdbc2.jdbc.SybDriver

Additional JDBC driver to register before attempting to connect to the database.

If you add Oracle drivers to the SECURETOOL_CLASSPATH environment variable, they are loaded automatically.

jdbc_url

string

jdbc:sybase:Tds:host: 5000/acdb

JDBC URL to use when connecting to the database.

sybase_asa

string

acdb

The SERVICENAME connection property to use when connecting to a Sybase ASA database.

wls_admin_host

string

localhost

Name of the machine where WebLogic is running.

wls_admin_port

integer

7001

WebLogic connection port.

wls_domain_dir

string

WebLogic domain root directory; must be an existing directory. If you use standard WebLogic paths, this value is usually detected automatically.

wls_servername

string

The name of the WebLogic server in which to install the software. Reads the value from the WLS_SERVERNAME_ARGDESC environment variable.

wls_systemuser

string

SybaseSecurity SystemIdentity (all one word)

The user name for making privileged method calls. This user must be created within the WebLogic administration system before Enterprise Security is deployed. Sybase recommends that you create a strong password for this user.

Returns

Return value

Indicates

0

The command ran successfully; the result is true/success.

1

The command failed.

Examples

Example 1

This command line example deploys the Enterprise Security middleware to WebLogic. The arguments provide the name of the encryption key file, the installation location of Enterprise Security, the location of the Sybase shared directory, the WebLogic administrator’s user name and password, and the WebLogic server installation directory.

securetool wls_deploymw --enkfile C:\Sybase\Security\.enk
   --security_dir C:\Sybase\Security --shared_dir C:\Sybase\Shared-1_0
   --wls_admin_username admin --wls_admin_password bea
   --wls_dir C:\WebLogic\Server

See also

wls_deploysm wls_removemw