General Syntax Alternative Syntax for Provisioning Commands

4-14 Oracle Fusion Middleware Oracle Process Manager and Notification Server Administrators Guide The Oracle instance arguments are: ■ -oracleInstance : the Oracle instance root directory. This directory is only required when the opmnctl command is not executed from the Oracle instance home. ■ -instanceName : this command option is used for assigning an Oracle instance name when the Oracle instance is created or to verify the Oracle instance name afterward. For the createinstance command, if the instanceName is not provided directly, the last directory name of the -oracleInstance is used as the Oracle instance name.

4.3.4.3.4 Component Specific Arguments Commands that target a single component can

accept arguments specific to the component type. For example, the -wcAdminPasswordFile argument is accepted when creating an Oracle Web Cache component but not when creating an OHS component. These arguments are syntactically optional but must be understood to ensure proper configuration. For details covering these specific arguments and how they should be used, refer to the Oracle Fusion Middleware Administrators Guide. A list of the arguments applicable to a system component can be displayed by including the component type when executing the opmnctl usage command. For example: opmnctl usage createcomponent -componentType OHS

4.3.4.4 Commands

This section describes the create series of commands. It includes the following sections: ■ createinstance ■ createcomponent ■ deleteinstance ■ deletecomponent ■ registerinstance ■ unregisterinstance ■ updateinstanceregistration ■ updatecomponentregistration

4.3.4.4.1 createinstance The createinstance command creates an Oracle instance

and registers It uses the following arguments: ■ Adminserver ■ Logging ■ Oracle Instance ■ -adminRegistration : the registration status for the created Oracle instance. Supported values are ON registered and OFF non-registered. The default value is ON. opmnctl Commands 4-15 ■ -opmnRemoteHost : the OPMN remote host. The default value is the computer canonical host name. ■ -opmnLocalPort: the OPMN local port value. The default port value is 6700 if the port is available. ■ -opmnRemotePort : the OPMN remote port value. The default port value is 6701 if the port is available. For example: opmnctl createinstance -oracleInstance foobarinst1 -adminHost myadminserver -adminPort 7001 or opmnctl createinstance -oracleInstance foobarinst1 -adminRegistration OFF

4.3.4.4.2 createcomponent The createcomponent command creates a component

within an Oracle instance. The created component is consistent with the Oracle instance in regard to its registration state. The createcomponent command uses the following arguments: ■ Adminserver ■ Logging ■ Oracle Instance ■ Component Specific Arguments ■ -componentType : the system component type ■ -componentName : the system component name For example: opmnctl createcomponent -componentType OHS -componentName ohs1 -proxyPort 8888 It is important to note that different system components feature different sets of arguments that are available for configuration. In the above command example, the -proxyPort usage is specific to the OHS component. For more information about component specific arguments refer to Section 4.3.4.3.4 . 4.3.4.4.3 deleteinstance The deleteinstance command deletes an Oracle instance and unregisters the Oracle instance and associated system components. A successful Oracle instance deletion removes all files of the Oracle instance except for the default provision.log file. For example: opmnctl deleteinstance The deleteinstance command uses the following arguments: ■ Adminserver ■ Logging ■ Oracle Instance ■ -force : The -force argument forces the opmnctl deleteinstance command to proceed regardless of discrepancies in the Oracle instance. The command is enabled only with a value of true. The default value is false.