Oracle® Web Services Manager Deployment Guide 10g (10.1.3.3.0) Part Number E10298-01 |
|
|
View PDF |
The chapter provides an overview of the capabilities of the Oracle Web Services Manager (Oracle WSM) wsmadmin
commands.
Registering the required enforcement components.
Installing additional applications, and enforcement components.
Once you have installed Oracle WSM, use the information in this chapter to help use the Oracle WSM Configuration Assistant to configure and customize your installation to your topology requirements.
Location of the WSMADMIN commands
Execute the wsmadmin command from the following directory:
ORACLE_HOME
\owsm\bin
Using the wsmadmin start Command to Start the Oracle WSM Server
For the standalone Oracle WSM installation, the Oracle WSM server should be started using the wsmadmin start
command. See "start".
Note:
Oracle WSM does not work if the bundled application server is started independently.If you have installed Oracle WSM as part of the Oracle Application Server 10g release 3 (10.1.3.1.0) release, refer to Oracle Application Server Administrator's Guide for more information on starting the server.
The following is the syntax for the wsmadmin
command:
wsmadmin
operation parameters
The following are the valid values for operation
:
The commands are case-sensitive. Each operation is described in the following pages.
In order to execute many of the WSMADMIN commands, you must supply a password for the application server, the database server, or both. When you execute the command, you will be prompted to provide the required password. When you provide the password in this manner, the password is encoded and secure.
There may be times when you need to automate a process and provide the password without direct user input. In such situations, you can provide passwords on the command line using the following syntax:
-Doc4jAdminPassword=
password
– Use this parameter to supply the password for Oracle Application Server.
-DDBPassword=
password
– Use this parameter to supply the password for Oracle Database Server.
Caution:
When you provide the password on the command line, it is not secure and can be viewed by any Oracle WSM user.You can also supply the password to a script using input redirection operators.
This operation uses the JAR and JSP source files to build the J2EE application WAR or EAR files that are deployed.
Syntax
wsmadmin buildApps
Usage
The values for the installed applications are saved to the install.properties
file during the Oracle WSM installation. After you have performed the buildApps
operation, you need to perform the deployApps
operation. There may be situations when you need to individually build and deploy your applications. For example, you may need to perform the following manual tasks between the buildApps
and deployApps
operations:
Version the Oracle WSM application archives before they are deployed
Prepare the application archives to be deployed manually
When you have finished building applications with the buildApps
operation, use deployApps
to deploy the application archives using the standard settings.
This operation generates new application configuration files based on the values in the install.properties
file.
Syntax
wsmadmin configApps
Usage
Use this operation before running buildApps
or deploy
. Performing this operation does not affect JSSO-enabled applications. You may use this operation to change a database password and then redeploy the application.
This operation reads the following properties from the install.properties
file:
Table C-1 install.properties Used During configApps
Attribute Name | Description |
---|---|
|
Select the Application Server type as |
|
Specify the HTTP host name. |
|
Specify the HTTP port. |
|
Specifies the name of the container to deploy the application. |
|
Specify the value as |
|
Name of the proxy server. |
|
Port number of the proxy server. |
|
List of hosts where you may not connect using the proxy server. You can create a list separated by a vertical bar (|), and use the asterisk (*), for wildcard matching. |
|
Set the value to |
|
Specify the driver type, either |
i |
Specify the machine name where the database is installed or the IP address. |
|
Specify the port number for the database. |
|
Specify the database user ID. |
|
Specify the password for the database. |
|
Specify the location of the SQL Server JDBC JAR files. |
Performing this operation overwrites the existing files and creates the following files:
ORACLE_HOME
\owsm\bin\agent.properties
ORACLE_HOME
\owsm\bin\coresv.properties
ORACLE_HOME
\owsm\config\ccore\logging.xml
ORACLE_HOME
\owsm\config\ccore\logging.xml
ORACLE_HOME
\owsm\config\ccore\ui-config-installer.properties
ORACLE_HOME
\owsm\config\clientagent\clientagent-config-installer.properties
ORACLE_HOME
\owsm\config\clientagent\logging.xml
ORACLE_HOME
\owsm\config\coreman\logging.xml
ORACLE_HOME
\owsm\config\coreman\monitor-config-installer.properties
ORACLE_HOME
\owsm\config\gateway\gateway-config-installer.properties
ORACLE_HOME
\owsm\config\gateway\logging.xml
This operation creates all the files necessary to configure all the applications, including the subset of files created when you use the copyDBConfig
operation.
You need to redeploy the applications to propagate the changes.
This operation copies the database configuration parameters into the configuration directory property files.
Syntax
wsmadmin copyDBConfig
Syntax
Use this operation before buildApps
or deploy
. This operation reads the following values from the coresv.properties
file:
Table C-2 coresv.properties Used During copyDBConfig
Attribute Name | Description |
---|---|
|
Location of the database URL. |
|
Type of database driver, |
|
User ID used to login to the database. |
|
Encrypted password used to log in to the database. |
After reading the values, the operation modifies the following coresv.properties
files:
ORACLE_HOME
\owsm\bin\agent.properties
ORACLE_HOME
\owsm\bin\coresv.properties
ORACLE_HOME
\owsm\config\ccore\ui-config-installer.properties
ORACLE_HOME
\owsm\config\clientagent\clientagent-config-installer.properties
ORACLE_HOME
\owsm\config\coreman\monitor-config-installer.properties
ORACLE_HOME
\owsm\config\gateway\gateway-config-installer.properties
You need to redeploy the applications to propagate the changes.
This operation is a test tool that generates the data you can view on the Oracle WSM Monitor. Use wsmadmin dataGenerator
to view the following types of data:
Syntax
wsmadmin dataGenerator
Usage
Use wsmadmin dataGenerator
to view the following types of data:
ping data
flow data
invocation data.
The following properties are exclusively for the Oracle WSM Monitor. This operation reads the following values from the coresv.properties
file:
This operation loads SQL scripts generated by the dataloadConfigure
operation into the primary Oracle WSM Database.
Syntax
wsmadmin dataload
Usage
The dataload
operation checks whether the data already exists in the database before loading the data into the Oracle WSM Database. If data exists, then the operation exits.
You must perform the dataloadConfigure
operation before performing dataload
. The two operations dataload
and dataloadConfigure
provide the flexibility to customize the data before loading it into the database.
The initialize
operation combines the dataload
and dataloadConfigure
operations.
The dataload
operation reads the following attributes from the coresv.properties
file:
Table C-4 coresv.properties Used During dataload
Attribute name | Description |
---|---|
|
Location of the database URL. |
|
Type of database driver, |
|
User ID used to log in to the database. |
|
Encrypted password to log in to the database. |
You will be prompted to provide a password to Oracle WSM Database. For alternate ways to provide WSMADMIN passwords, see "Passwords for WSMADMIN Commands".
This operation generates SQL scripts that are used to create the database schema and load seed data.
Syntax
wsmadmin dataloadConfigure
Usage
The database files are created in ORACLE_HOME
\owsm\db
. The dataloadConfigure
operation reads the following attributes from the coresv.properties
file:
Table C-5 coresv.properties Used During dataloadConfigure
Attribute name | Description |
---|---|
|
Location of the database URL. |
|
Type of database driver, |
|
User ID used to log in to the database. |
|
Encrypted password to log in to the database. |
Perform the dataload
operation after you have performed dataloadConfigure
. For more information, see "dataload" .
The initialize
operation combines the dataload
and dataloadConfigure
operations.
This operation builds, deploys, and binds components to an OC4J application engine.
Syntax
wsmadmin deploy
component
Parameters
component
– Name of the component being deployed. The valid values are:
all
– Deploys all components
control
– Deploys the Web Services Manager Control
gateway
– Deploys the Oracle WSM Gateway
monitor
– Deploys the Oracle WSM Monitor
policymanager
– Deploys the Oracle WSM Policy Manager
Usage
Use this operation to build, deploy, bind controls, gateways, monitors, or policy manager instances. You can perform these tasks on all the components at the same time. Perform this operation to deploy applications without customizing them before deployment. To customize applications before deploying, see "buildApps" .
You will be prompted to provide a password to Oracle Application Server. Use the OC4J system administrator password. For alternate ways to provide WSMADMIN passwords, see "Passwords for WSMADMIN Commands".
If you are using Oracle Process Manager and Notification Server (OPMN) to manage Oracle WSM and you deploy Oracle WSM Policy Manager, then you must restart the OPMN process on the OC4J instance where the Oracle WSM components are installed. If you do not restart OPMN, you will get an error when you try to log in to Web Services Manager Control.
This operation deploys components to an OC4J application engine.
Syntax
wsmadmin deployApps
component
Parameters
component
– Name of the component being deployed. The valid values are as follows:
all
– Deploys all components
control
– Deploys the Web Services Manager Control
gateway
– Deploys the Oracle WSM Gateway
monitor
– Deploys the Oracle WSM Monitor
policymanager
– Deploys the Oracle WSM Policy Manager
Usage
Use this operation to deploy instances of Web Services Manager Control, Oracle WSM Gateway, Oracle WSM Monitor, or Oracle WSM Policy Manager. You can deploy all of the components at once using the all
parameter or you can deploy the individual components. Use this operation after using the buildApps
operation. For more information see "buildApps". The deployApps
operation reads the following attributes from the coresv.properties
file:
Table C-6 coresv.properties Used During deployApps
Attribute Name | Description |
---|---|
|
Location of the OC4J container. |
|
Location of the external OC4J installation. |
|
Host name for the external OC4J installation. |
|
Port number for the external OC4J installation. |
|
Port number for the administrator of the external OC4J installation. |
|
Administrator's user name for the external OC4J installation. |
|
Location of the OC4J instance. |
You will be prompted to provide a password to Oracle Application Server. Use the OC4J system administrator password. For alternate ways to provide WSMADMIN passwords, see "Passwords for WSMADMIN Commands".
If you are using Oracle Process Manager and Notification Server (OPMN) to manage Oracle WSM and you deploy Oracle WSM Policy Manager, then you must restart the OPMN process on the OC4J instance where the Oracle WSM components are installed. If you do not restart OPMN, you will get an error when you try to log in to Web Services Manager Control.
This operation encodes passwords in a property file.
Syntax
wsmadmin encodePasswords
propertyFile properties
Parameters
propertyFile
– Name of the specified file
properties
– List of passwords that will be encoded
Usage
You can separate multiple passwords with a colon (:). However, spaces are not permitted.
This operation exports data from the Oracle WSM Database to a file.
Syntax
wsmadmin exportDBData
Usage
The exported tables are stored as XML files. You may perform this operation for the following reasons:
To back up your Oracle WSM data.
To store your data before moving your data to different location.
Note:
Check that the PATH environment variable is set to the location where SQL*Plus is installed.The exportDBData
operation reads the following attributes from the coresv.properties
file:
Table C-7 coresv.properties Used During exportDBData
Attribute Name | Description |
---|---|
|
Default location where you want to store your Oracle WSM Database file is |
You will be prompted to provide a password to Oracle WSM Database. For alternate ways to provide WSMADMIN passwords, see "Passwords for WSMADMIN Commands".
When you execute the command, the following message is displayed:
"Warning!!! The data in the input directory will be deleted. Are you sure you want to continue? Y-Yes N-No:"
Select Y
to proceed with the data export.
This operation displays the list of wsmadmin
operations.
Syntax
wsmadmin help
operation
Parameter
operation
– Any valid wsmadmin
operation described in this appendix. See "Syntax of the WSMADMIN Commands" for a complete list of wsmadmin
operations.
Usage
If you execute the command wsmadmin help,
you get a list of the valid operations you can perform with the command. To get help for a specific operation, including any arguments that the operation accepts, specify the name of the operation with the operation
variable.
This operation imports data from a file into the Oracle WSM Database.
Syntax
wsmadmin importDBData
Usage
Confirm that the following requirements have been met:
Ensure that SQL*Plus is installed before performing this operation.
Verify that the PATH environment variable is set to the location where SQL*Plus is installed.
The importDBData
operation reads the following attributes from the coresv.properties
file:
Table C-8 coresv.properties Used During importDBData
Attribute Name | Description |
---|---|
|
Default location from where you want to transfer data to your Oracle WSM Database is |
You will be prompted to provide a password to Oracle WSM Database. For alternate ways to provide WSMADMIN passwords, see "Passwords for WSMADMIN Commands".
This operation initializes the primary database.
Syntax
wsmadmin initialize
Usage
Use this operation to initialize and create the schema for an Oracle Lite database. However, to initialize an Oracle database, the schema must exist prior to using this operation. If you need to customize the data that is loaded into the database, use the dataload
Configure and dataload
operations. For more information, see "dataloadConfigure", and "dataload" .
The initialize
operation reads the following attributes from the coresv.properties
file:
Table C-9 coresv.properties Used During dataload
Attribute Name | Description |
---|---|
|
Location of the database URL. |
|
Type of database driver, |
|
User ID used to log in to the database. |
|
Encrypted password for logging in to the database. |
|
Value that imports only the data, or the schema and the data. |
You will be prompted to provide a password to Oracle WSM Database. For alternate ways to provide WSMADMIN passwords, see "Passwords for WSMADMIN Commands".
This operation is invoked by the installer automatically at the end of the installation procedure.
Syntax
wsmadmin install
Usage
The installer invokes this command at the end of the Oracle WSM configuration. If required, the configuration procedure includes the initialization of the bundled OC4J and Oracle Lite components. It also builds and deploys the J2EE applications, such as the Web Services Manager Control, Oracle WSM Policy Manager, and Oracle WSM Monitor. This single operation invokes and performs all the following operations:
configApps
installOLite
installOC4J
initialize
encodePasswords
You will be prompted to provide passwords to Oracle WSM Database and Oracle Application Server. For the application server password, provide the OC4J system administrator password. For alternate ways to provide WSMADMIN passwords, see "Passwords for WSMADMIN Commands".
This operation builds and installs the J2EE agent based on the properties in the agent.properties
file.
Syntax
wsmadmin installAgent
Usage
The installAgent
operation requires the following attribute from the agent.properties
file:
Table C-10 agent.properties Used During installAgent
Attribute Name | Description |
---|---|
|
Type of agent can be either a client or server agent. |
Note:
See Chapter 6, "Installing Oracle WSM Agents", for more information on setting properties for each type of agent.You will be prompted to provide a password to Oracle Application Server. Use the OC4J system administrator password. For alternate ways to provide WSMADMIN passwords, see "Passwords for WSMADMIN Commands".
This operation installs the bundled OC4J application server included with the standalone installation.
Syntax
wsmadmin installOC4J
Usage
This operation initializes the OC4J server ports for Oracle WSM. When this operation runs for the first time, it sets the OC4J administrator password.
You will be prompted to provide a password to Oracle Application Server. Use the OC4J system administrator password. For alternate ways to provide WSMADMIN passwords, see "Passwords for WSMADMIN Commands".
This operation installs the bundled Oracle Lite database included with the basic installation.
Syntax
wsmadmin installOLite
Usage
This operation performs the following functions:
Reads the install.db.*
attribute in the install.properties
file
Adds database entries to %WinDir%/OCBC.ini
Creates and updates %WinDir%/POLITE.ini
Creates a service for the Oracle Lite database, under the Windows Services Administrative Tool
You will be prompted to provide a password for the system user for the Oracle WSM Database (orawsm) instance. For alternate ways to provide WSMADMIN passwords, see "Passwords for WSMADMIN Commands".
Use this operation to manage user groups in the database.
Syntax
wsmadmin manageUserGroups
parameter
Parameters
parameter
– User or group name. The valid values are as follows:
addUser
addGroup
addUserGroup
deleteUser
deleteGroup
deleteUserGroup
Usage
The manageUserGroups
operation requires certain attributes from the manageUserGrops.properties
file. See the Oracle Web Services Manager Administrator's Guide for information about the changes you need to make to the properties file.
You will be prompted to provide a password to Oracle WSM Database. For alternate ways to provide WSMADMIN passwords, see "Passwords for WSMADMIN Commands".
Use this operation to encode a password associated with a user to the specified password file. This is used with file-based authentication.
Syntax
wsmadmin md5encode
htpasswdfile username
Parameters
htpasswdfile
– Name of the file containing the user name and password
username
– User name in the text file
Usage
Run the md5encode command for each user name and password. You will be prompted to enter the password for the user specified at the command line. Each encrypted result gets appended to the end of the file. The following are examples in an htpasswdfile file:
johndoe:{MD5}JMnhX1KvxHwiW3V+e+4fnQ==
janedoe:{MD5}dqIXO+Y5M1TnL/pNbfEDCg==
This operation migrates the Oracle WSM 10.1.2 properties and database settings to Oracle WSM 10.1.3.1.0.
Syntax
wsmadmin migrate
OWSM_10.1.2_dir
Parameters
OWSM_10.1.2_dir
– Directory where Oracle WSM 10.1.2 is installed
Usage
You will be prompted to provide passwords to Oracle WSM Database and Oracle Application Server. For the application server password, provide the OC4J system administrator password. For alternate ways to provide WSMADMIN passwords, see "Passwords for WSMADMIN Commands".
For more information about the wsmadmin migrate command, see Oracle Web Services Manager Upgrade Guide.
This operation starts the OC4J application engine and the Oracle Lite database server included with the basic installation.
Syntax
wsmadmin start
Usage
The start
operation reads the following attributes from the coresv.properties
file:
Table C-11 coresv.properties Used During start
Attribute Name | Description |
---|---|
|
Location of the OC4J container. |
|
Host name of the OC4J installation. |
|
Port number of the proxy server. |
|
Names of the host machines that should not exchange data using the proxy. |
Use this operation if you intend to use startOLite
followed by startOC4J
.
This operation starts the OC4J application engine included with the basic installation.
Syntax
wsmadmin startOC4J
Usage
The startOC4J
operation reads the following attributes from the coresv.properties
file:
Table C-12 coresv.properties Used During start
Attribute Name | Description |
---|---|
|
Location of the OC4J container. |
|
Host name of the OC4J installation. |
|
Port number of the proxy server. |
|
Names of the host machines that should not be accessed through the proxy. You can enter multiple host names, and use the vertical bar (|) character to separate them. |
This operation starts the Oracle Lite database server include in the basic installation.
Syntax
wsmadmin start
OLite
This operation stops the OC4J application engine and the Oracle Lite database server included with the basic installation.
Syntax
wsmadmin stop
Usage
This operation reads the oc4j.j2ee.home
attribute in the coresv.properties
file.
You will be prompted to provide a password to Oracle Application Server. Use the OC4J system administrator password. For alternate ways to provide WSMADMIN passwords, see "Passwords for WSMADMIN Commands".
The stop
operation combines the operations stopOC4J
and stopOLite
.
This operation stops the OC4J application engine included with the basic installation.
Syntax
wsmadmin stopOC4J
Usage
You will be prompted to provide a password to Oracle Application Server. Use the OC4J system administrator password. For alternate ways to provide WSMADMIN passwords, see "Passwords for WSMADMIN Commands".
This operation stops the Oracle Lite database server included with the basic installation.
Syntax
wsmadmin stop
OLite
This operation unbinds and undeploys the specified components from an OC4J instance.
Syntax
wsmadmin undeploy
component
Parameters
component
– Name of the component being deployed. The valid values are as follows:
all
– Deploys all components
control
– Deploys the Web Services Manager Control
gateway
– Deploys the Oracle WSM Gateway
monitor
– Deploys the Oracle WSM Monitor
policymanager
– Deploys the Oracle WSM Policy Manager
Usage
The undeploy
operation reads the following attributes from the install.properties
file:
Table C-13 coresv.properties Used During undeploy
Attribute Name | Description |
---|---|
|
Host name for the OC4J installation. |
|
Administrator's username for the OC4J installation. |
|
Location of the OC4J instance. |
You will be prompted to provide a password to Oracle Application Server. Use the OC4J system administrator password. For alternate ways to provide WSMADMIN passwords, see "Passwords for WSMADMIN Commands".
The installer invokes this operation automatically when uninstalling the Oracle WSM product.
Syntax
wsmadmin uninstall
Usage
The deconfiguration procedure includes uninstalling the OC4J and Oracle Lite components. It also uninstalls the J2EE applications. The operation will not uninstall the OC4J components if you do not supply the password. This operation performs the functions of all the following operations:
Runs uninstallOC4J
. If you do not supply the password, OC4J is not uninstalled. You need to uninstall OC4J manually.
Runs uninstallOLite
Deletes configuration files
Note:
This operation does not clean up the database. You have to perform this step separately.You will be prompted to provide a password to Oracle Application Server. Use the OC4J system administrator password. For alternate ways to provide WSMADMIN passwords, see "Passwords for WSMADMIN Commands".
This operation deactivates the OC4J application server included with the basic installation.
Syntax
wsmadmin uninstallOC4J
Usage
This operation performs the functions of the following operations:
undeployAll
stopOC4J
You will be prompted to provide a password to Oracle Application Server. Use the OC4J system administrator password. For alternate ways to provide WSMADMIN passwords, see "Passwords for WSMADMIN Commands".
This operation uninstalls the Oracle Lite database server included with a Basic Oracle WSM installation.
Syntax
wsmadmin
uninstallOLite
Usage
This operation performs the following tasks:
Stops the Oracle Lite database server and removes the service from the system
Removes the database entries from %WinDir%/OCBC.ini
Clears %WinDir%/POLITE.ini
This operation upgrades the Oracle WSM Database.
Syntax
wsmadmin upgrade
database_type
Parameters
database_type
– Must be oracle
, since this version of Oracle WSM only supports the Oracle database
Usage
You will be prompted to provide a password to Oracle WSM Database. For alternate ways to provide WSMADMIN passwords, see "Passwords for WSMADMIN Commands".
This version of Oracle WSM only supports the Oracle database.