Progressive Request Reports Sequential Requests

4-12 Oracle Fusion Middleware Oracle Process Manager and Notification Server Administrators Guide ■ Register and unregister an Oracle instance with a WebLogic domain for management using the Fusion Middleware Control Console. ■ Update an Oracle instance or system component registration with the WebLogic domain. This section includes the following topics: ■ General Syntax ■ Alternative Syntax for Provisioning Commands ■ Common Arguments ■ Commands

4.3.4.1 General Syntax

opmnctl provisioning commands are invoked using the following syntax: opmnctl command [-argName1 value1] [-argName2 value2] ... The following provisioning commands are supported: ■ createinstance ■ createcomponent ■ deleteinstance ■ deletecomponent ■ registerinstance ■ unregisterinstance ■ updateinstanceregistration ■ updatecomponentregistration

4.3.4.2 Alternative Syntax for Provisioning Commands

Provisioning commands can also be invoked with the syntax used by other opmnctl commands: opmnctl command [argName1=value1] [argName2=value2] ... This alternate syntax follows the Attributes style refer to Section 4.3.1.2 and accepts argument names presented in lower case. The alternate syntax is provided to allow greater uniformity between opmnctl commands. Any opmnctl provisioning commands can be entered using either syntax. For example, the following commands are equivalent: opmnctl createcomponent -componentType OHS -componentName ohs1 Note: The opmnctl provisioning commands must use the following naming conventions: 1. Name must begin with a letter and contain only alphanumerics, hyphen- and underscore_ characters. 2. Name must be no more than 30 characters long. 3. Name must be at least 4 characters long. opmnctl Commands 4-13 opmnctl createcomponent componenttype=OHS componentname=ohs1 Both syntax styles can be combined within the same command.

4.3.4.3 Common Arguments

The following arguments generally apply to all provisioning commands, with the exception with component specific arguments that apply only to component-related commands: ■ Adminserver Arguments ■ Logging Arguments ■ Oracle Instance Arguments ■ Component Specific Arguments

4.3.4.3.1 Adminserver Arguments administrative server Adminserver arguments

denote how opmnctl should contact the Adminserver of the Oracle WebLogic Server domain. The Adminserver values are stored in the Oracle instance as defaults for subsequent commands. opmnctl does not use or require the Adminserver values for a non-registered Oracle instance. See Section 4.3.4.4.1 about the createinstance command for creating a non-registered instance. The Adminserver arguments are: ■ -adminHost : the Weblogic Adminserver host. The default value is the last successful command for the Oracle instance or local host. ■ -adminPort : the Weblogic Adminserver port. The default value is the last successful command for the Oracle instance; or 7001. ■ -adminProtocol : Weblogic Adminserver protocol. The default value is the last successful command for the Oracle instance; or t3. ■ -adminUsername : the Weblogic Adminserver login user name. The default value is the last successful command for the Oracle instance; otherwise you are prompted to type in their login user name. ■ -adminPasswordFile : the location of the file containing the administrative user admin user password. The default value is the last successful command for the Oracle instance; otherwise you are prompted to type in your admin user password.

4.3.4.3.2 Logging Arguments By default, opmnctl logs the detailed provisioning errors

and exceptions in the ORACLE_ INSTANCE diagnosticslogsOPMNopmnprovision.log file. For certain errors during execution of the createinstance command, specifically when the provision.log file has not been created yet, the detailed exception is indicated on the console. Log file locations can be specified using the -logFile argument. ■ -logFile : the location of provisioning log file. ■ -logLevel : the logging level of provisioning log. For example, INFO or FINER.

4.3.4.3.3 Oracle Instance Arguments The -oracleInstance and -instanceName

arguments are used primarily for the createinstance command. After the Oracle instance is created, the ORACLE_INSTANCEbinopmnctl directory provides a default Oracle instance home. The Oracle instance name is determined automatically.