To download the OSM package installer:

1. Download JDK 1.8 from the respective website and install it, preferably in the /usr or the /opt directory.

   Note:

   JRE 1.8 is not bundled with the OSM software media pack for any operating system.

2. Download the OSM software media pack for your operating system from the Oracle software delivery website, located at:

   https://edelivery.oracle.com/

   and save it to a temporary directory:

3. Unzip the OSM software media pack.
4. Ensure that the Oracle Database and Oracle WebLogic Server instances that you intend to use for OSM are running.
5. For a Linux system, ensure that you have installed all required software packages, including Software Development Workstation. For information about the available software packages, see the latest Oracle Linux Installation Guide.

OSM is supported on the following operating systems:

Before starting the installation procedure, ensure that the following prerequisites have been satisfied:

You can install the OSM Installer RPM package on Linux as an RPM or DNF file, and on Solaris as a .zip file.

Regardless of the chosen tool, it is recommended that you override the default installation location. This ensures that you can easily access patches and version upgrades in the future. Additionally, overriding the installation location facilitates upgrade preparation and rollback scenarios.

You can use the OSM Installer in either a Centralized manner or a Distributed manner as described below:

When attempting to install a new version of the OSM installer RPM package, DNF automatically handles the process of either downgrading or upgrading to the specific version.

For example:

• If OSM installer build version B2566 is already installed and an older version, say version B2559 is being installed, DNF will replace or downgrade the existing version B2566 to version B2559.
• Conversely, if build version B2559 is already installed and a newer version, say B2577 is being installed, DNF will replace or upgrade the existing version B2559 to version B2577.

#install the RPM package using the dnf command
$ sudo dnf install --installroot=/path/to/desired/installationdir/ /path/to/rpm/osm-installer-7.5.0-1.el8.x86_64.rpm

RPM is a widely used utility for software installation on Linux systems, especially Red Hat Linux. The following is an example that illustrates how to utilize RPM to install the OSM installer:

To unzip the OSM package:

Upon successful installation of the package, you will have access to the osm-installer-version folder, containing components such as:

• db-model
• libs
• scripts
• wdt
• wlsdeploy

The OSM installer runs Discovery Process, which offers an interactive stage to capture the parameter settings necessary for installation activities. This process primarily centers around WLS (WebLogic Server) Domain discovery along with querying the DB to find out if it is RAC. This phase captures all the necessary data for the OSM installation.

To begin this process, you need to run the shell command discover.sh and provide a name for the discovery (called environment) along with a passphrase environment variable that consists of a passphrase. Throughout this process, the installer runs validations to ensure connection to both the admin server and the database server.

Upon successful validation, you specify the remaining OSM settings. Upon completion, a property file named configuration.properties is generated at the location you have specified in the -c option while running the discovery module. If you have not provided the location, then the property file can be found in the default location, which is ~/.osm/configuration. You can modify the configuration.properties file. Ensure that you proceed with caution while making any changes. If you need to update the encrypted properties, then you must rerun the discovery script. You also have the option to make direct changes if you prefer that.

When handling password fields, it is crucial to not input plain text values. The discovery script prompts you for various pieces of information, including details about the database connection, WebLogic Server (WLS) admin credentials, Coherence Cluster settings, and other relevant parameters. Run the $OSM_INSTALLER_HOME/scripts/encrypt.sh encryption script to convert plain text into an encrypted string. Subsequently, you should paste this encrypted string output into the configuration.properties file.

The OSM installer generates the following files and artifacts, which can be found in the $OSM_CFG_HOME/configuration/environment-name directory. If $OSM_CFG_HOME is not defined, then the directory is $HOME/.osm/configuration/environment-name:

To begin the discovery process:

1. Navigate to the osm-installer folder, which becomes available after RPM, DNF or .Zip installation.
2. Locate the scripts folder and run either of the following commands:

   Note:

   It is strongly recommended to use separate directory hierarchies for the OSM installer location and the OSM configuration root directory.

   Use the following command if you are choosing to not use the -p parameter.

   $ export OSM_INSTALLER_HOME=path/to/osm/installation #This is available after RPM or DNF installation.
   $ export PASSPHRASE=passphrase
   $ $OSM_INSTALLER_HOME/scripts/discover.sh -n osm_env_name -c /path/to/rootdir/for/configurations -l $OSM_INSTALLER_HOME

   Use the following command if you are choosing to use the -p parameter.

   $ export OSM_INSTALLER_HOME=path/to/osm/installation #This is available after RPM or DNF installation.
   $ export PASSPHRASE_ENV_NAME=passphrase
   $ $OSM_INSTALLER_HOME/scripts/discover.sh -n osm_env_name -c /path/to/rootdir/for/configurations -l $OSM_INSTALLER_HOME -p PASSPHRASE_ENV_NAME

   Note:

   Here, OSM_INSTALLER_HOME refers to the location where the OSM installer was deployed (using RPM or DNF) or unzipped.
   Use the following options with the script:
   • -n: This is a mandatory parameter. This is the OSM environment name.
   • -c: This is an optional parameter. This is the OSM configuration root directory. If you opt to omit this parameter, then the default configuration directory at ~/.osm/configuration will be used.
   • -l: This is an optional parameter. This is the OSM installer home directory. If you opt to omit this parameter, then the environment variable must be set to contain the full path of the OSM installer root directory.
   • -p: This is an optional parameter. This is a passphrase environment variable that consists of passphrase used to encrypt and decrypt. If you omit this parameter, then the environment variable PASSPHRASE must be set to contain the passphrase string.
   • -h: This parameter is for help.

Furthermore, discovery can be initiated using an existing configuration file, from which the configuration scripts can read the properties to obtain the current contents as default values. This makes it more convenient to modify configuration as the existing values can be accepted as default values until you get to the place where the values need to be changed.

During the discovery process, certain words are reserved for screen flow control and to gracefully exit the process.

To specify configuration properties:

1. Initiate the discovery process as described above.

   This displays the Welcome section.

2. Read through the text in the Welcome section and press Enter.

   The header for the Third Party Readme section is displayed.

3. For the View third party readme property, if you enter false, it skips displaying the third-party related contents and the next section appears. If you enter true, the Readme content appears.

   Enter value for--third-party-readme (View third party readme. (default: true)):

4. Review the readme contents for the third-party components and then press Enter.

   The Database Connection Information section appears.

5. Specify the Oracle Database instance where the OSM database schema will be installed or the existing OSM schemas will be upgraded. This can be a single-instance database or an Oracle Real Application Clusters (RAC) database. If you are installing an Oracle RAC database, specify connection information for the primary database instance. Oracle RAC configuration occurs later in the installation process.

   Note:

   For Oracle RAC One Node, specify only the Service Name.

   • For the database host property, enter the IP address or DNS name of the host where the database listens for requests. For an Oracle RAC database, enter the Single Client Access Name (SCAN).

     --db-host (The Database Host. (default: null)): dbhost

   • For the database port property, enter the port where the database listens for requests.

     --db-port (The Database Port. (default: 1521)): dbport

   • For the database service property, enter the service name of the database. If the database is a pluggable database (PDB) within a container database (CDB), use the service name of the PDB. For example, the name of either the default database service or a service created specifically for OSM.

     -db-service (The Database Service Name. (default: null)): service_name

     For an Oracle RAC database instance with a remote listener (SCAN listener), you must enter both service name and SID. For other types of database, or an Oracle RAC database instance with only local listeners, you can enter either a database service name or SID, but both fields cannot be empty.

     Note:

     If a service is configured for OSM, all WebLogic database transactions are run against that service as expected. However, OSM jobs run by the Notification Engine are submitted to the database through the DBMS_JOB package and are not subject to any restrictions that may have been placed on the service.

   • For the database system identifier property, enter the name (system identifier) of the database instance. If the database is a PDB within a CDB, use the system identifier of the CDB.

     For an Oracle RAC database instance with a remote listener, you must specify the SID and the service name. Otherwise, the WebLogic data source will not be able to override server-side load balancing. See "Listener Considerations for Oracle RAC" for a discussion of listener functionality.

     --db-sid (The Database System Identifier SID. (default:null)): sid

   The Database Administrator Credential Information section appears.

6. Enter the credentials supplied by your Database Administrator for the following parameters:

   • For --db-admin-username, enter the user name for the database administrator user.

   • For --db-admin-password, enter the password for the database administrator user.

   Note:

   If you choose to connect as the sys user and you have not set the O7_DICTIONARY_ACCESSIBILITY database parameter to TRUE, append as sysdba to the value in the User Name field.

   The Database Credential Information section appears.

7. Enter values for the following parameters:

   • Enter the value for the OSM core schema name, in the field.

     --db-osm (The OSM core schema name (default: OSM)): osmschema 

   • Enter the value for the OSM core schema password, in the field.

     --db-osm-password (The OSM core schema password. (default: null)): password 

   • Enter the value for the OSM rule engine schema name, in the field.

     --db-rule-engine (The OSM rule engine schema name. (default: OSMRule)): osmschema_rule

   • Enter the value for the OSM rule engine schema password, in the field.

     --db-rule-engine-password (The OSM rule engine schema password (default: null)): password

   • Enter the value for the OSM report schema name, in the field.

     --db-report (The OSM report schema name. (default: OSMReport)): osmschema_report

   • Enter the value for the OSM report schema password, in the field.

     --db-report-password (The OSM report schema password. (default: null)): password

   The Database Schema Tablespaces section appears

8. Enter values for the following parameters to allocate space for the OSM database schemas.

   • Enter the value for the name of the default tablespace, in the field.

     --db-default-tablespace(The name of the default tablespace [{"name":"OSM","availableSpaceMB":12677},{"name":"SYSAUX","availableSpaceMB":137}] (Required TableSpace : 35MB) (default: OSM)):

   • Enter the value for the name of the temporary tablespace, in the field. This specifies the temporary tablespace for the database schema.

     --db-temp-tablespace(The name of the temp tablespace [{"name":"TEMP","availableSpaceMB":99}] (default: TEMP)):

   • Enter the value for the name of the model data tablespace, in the field. This specifies the model data tablespace for the database schema.

     --db-model-data-tablespace(The name of the model data tablespace [{"name":"OSM","availableSpaceMB":12677},{"name":"SYSAUX","availableSpaceMB":137}] (Required TableSpace : 35MB) (default: OSM)):

   • Enter the value for the name of the model index tablespace, in the field. This specifies the model index tablespace for the database schema.

     --db-model-index-tablespace (The name of the model index tablespace [{"name":"OSM","availableSpaceMB":12677},{"name":"SYSAUX","availableSpaceMB":137}] (Required TableSpace : 35MB) (default: OSM)):

   • Enter the value for the name of the order data tablespace, in the field. This specifies the order data tablespace for the database schema.

     --db-order-data-tablespace (The name of the order data tablespace [{"name":"OSM","availableSpaceMB":12677},{"name":"SYSAUX","availableSpaceMB":137}] (Required TableSpace : 35MB) (default: OSM)):

   • Enter the value for the name of the order index tablespace, in the field. This specifies the order index tablespace for the database schema.

     --db-order-index-tablespace (The name of the order index tablespace [{"name":"OSM","availableSpaceMB":12677},{"name":"SYSAUX","availableSpaceMB":137}] (Required TableSpace : 35MB) (default: OSM)):

   For each tablespace, you are shown how much space you have available and how much space is required. For more information, see "Tablespaces."

   The Database Schema Partition Information section appears.

9. The information gathered here is used to determine whether the database schema is created using partitions.

   • Enter the value for the database partition property. The default value for this is true. If you choose false, this section will be skipped.

     --db-partition (Use Oracle Partitioning features for optimal performance in high volume production environment. (default: true)): 
     Usage: partitionProperties

   • Enter the value for database partition size property. This is the number of orders that will be allowed in a partition. The default value for this is 20000000.

     --db-partition-size (The size of each partition. (default: 20000000)):

   • Enter the value for the database subpartition count property. This is the number of sub-partitions allowed in a partition. The default value for this is 32.

     --db-subpartition-count (The total number of subpartition. Default is 32 ):

     After installation, you can change the values that you selected during the installation process by updating the --db-partition-size and --db-subpartition-count OSM database parameters. However, updates to these parameters do not affect existing partitions.

     Note:

     For more information about partitioning, see OSM System Administrator's Guide.

   Important:

   Oracle strongly recommends partitioning in all production deployments or production test environments, particularly those with high order volumes or any volume of large or complex orders. If you choose not to partition your OSM schema, it could be expensive to later reverse your decision. Changing a non-partitioned schema that has accumulated a large volume of data to a partitioned schema involves time-consuming and resource intensive export/import.

   The Database Timezone Information section appears.

10. The OSM Database Timezone must be set to Non-Daylight Saving time. You can inform OSM of this timezone as an offset in the value of seconds. Enter the value for the database timezone offset in seconds.. The default value is set to -28800.

    --db-timezone-offset-seconds (The database time zone offset in second (default: -28800)):

    Note:

    For more information on timezone settings, see "Configuring Time Zone Settings in the Database" or OSM System Administrator's Guide.

    The Weblogic Server Connection Information section appears.

11. Do the following:

    1. For the weblogic administrator server host property, enter the name or IP address of the machine where WebLogic is installed.

       --weblogic-admin-server-host (The Weblogic Admin Server Host. (default: null)): wlhost

    2. For the weblogic administrator server port property, enter the port where WebLogic is operating. .

       --weblogic-admin-server-port (The Weblogic Admin Server Port. (default: null)): wlport

    3. For the weblogic administrator user name property, enter the name of the WebLogic administrator.

       --weblogic-admin-user-name (The Weblogic Admin User name. (default: null)): wluser

    4. For the weblogic administrator user password property, enter the password of the WebLogic administrator.

       --weblogic-admin-user-password (The Weblogic Admin User Password. (default: null)): password

    5. For the connection to weblogic using SSL property, enter true to use an SSL connection to the WebLogic admin server. The server's SSL port must be enabled to use this feature. By default, a non-SSL connection is used.

       --weblogic-ssl-enabled (Connect to Weblogic via SSL. (default: false)): true

    6. If you are using SSL, for the weblogic port, enter the port number of the WebLogic admin server.

       --weblogic-admin-server-ssl-port(The Weblogic SSL Port. (default: null)): sslport

    7. If you are using SSL, for the keystore file, specify the location of the key store file required for the SSL connection by typing the full path and directory.

       --ssl-keystore-file(SSL Keystore File Name. (default: null)): keystore_file_path

       The keystore file must exist locally in the machine from where the OSM installer is running. The default location of the cacerts key store file is WebLogic_home/server/lib.

    The WebLogic Server (WLS) Deployment Target section appears.

12. For the weblogic deployment target, you can enter the values CL, or AdminServer. Here, CL is the cluster name and it can be anything based on the name provided during domain creation. The screen will detect the cluster name and populate here and you have to enter the value accordingly.

    • If you created a single WebLogic admin server, enter AdminServer.

    • Select the appropriate cluster from the list detected.

    --weblogic-deployment-target(Cluster/Stand-alone Server (detected: CL,AdminServer, current: AdminServer)): CL

13. If you are performing an upgrade and there are differences in the existing JDBC configuration and the proposed JDBC configuration, then the Database Configuration Comparison section is displayed.

    If you specified an Oracle RAC database, the Oracle Real Application Clusters Configuration section is displayed. Go to step 15.

    If you have specified a WebLogic cluster, the WebLogic Cluster Web Service Request Configuration section is displayed. Go to step 22.

14. This section displays the existing JDBC configuration and the proposed new JDBC configuration. You can choose to replace the existing JDBC Data Source Configuration with new connection information. To do that, enter true for the existing weblogic server data source replacement property. If you do not want to, then enter false:

    --existing-wls-ds-replace (Do you want to replace the existing JDBC data source configuration with the new connection information. (default: true)): false

     Enter true or false to continue or enter back to change the database connection information.

    • Below is the new configuration:

      [{"name":"ORCHDB2","is_rac":"Yes","host":"dbhost","port":"dbport","service":"servicename","sid":null,"user":"osmuser"}]

      Note:

      The OSM installer does not perform any data migration. Therefore, if you select this option, all configuration parameters will be reset to their defaults.
    • Below is the existing configuration:

      [{"name":"--","is_rac":"Yes","host":"dbhost","port":"dbport","service":"servicename","sid":"sid1","user":"osmuser"},
      {"name":"--","is_rac":"Yes","host":"dbhost","port":"dbport","service":"servicename","sid":"sid2","user":"osmuser"}]

15. If you specified an Oracle Real Application Clusters (Oracle RAC) database for the primary database instance, the Oracle Real Application Clusters Configuration section is displayed.

    Otherwise, go to step 21.

16. Do one of the following:

    • If the installer has detected that the specified database instance is an Oracle Real Application Clusters (RAC) instance, you can automatically configure additional Oracle RAC database instances for either load balancing or failover. The value for the use Oracle RAC property, in that case, should be true.

       --use-oracle-rac (Use Oracle RAC: (default: true):

    • If you want to configure additional Oracle RAC database instances for load balancing or failover, enter the value true for the use Oracle RAC property.

    •  --use-oracle-rac (Use Oracle RAC: (default: true):

17. Do one of the following:

    1. In the Configure WebLogic JDBC Data Sources section, do the following:

       • If you want to use an additional RAC Database instance now, enter the value now, for the configuring Weblogic JDBC data sources property.

         --rac-config (Configure Weblogic JDBC data Sources.
         now, later (default: now):

         The installer preconfigures the database connections in WebLogic server.

       • If you want to manually use an additional RAC database, after installation completes, enter the value later, for the configuring Weblogic JDBC data sources property.

         
         --rac-config (Configure Weblogic JDBC data Sources.
         now, later (default: now):

         You can add more Oracle RAC database instances manually after the installation. See "Manually Configuring Additional Data Sources for an Oracle RAC Instance" for configuration details.

    2. In the RAC operation mode section, you can choose one of the following options:

       • Load Balancing (Active Active) - Order and Service Management WebLogic Cluster Installations

         The installer groups the WebLogic Server instances according to the number of Oracle RAC database instances. Each group is configured to a separate Oracle RAC database as the primary data source, and the remaining Oracle RAC database instances as secondary data sources.

         This option is available only if OSM is deployed to a WebLogic cluster.

         For this option, enter the value load_balance for the RAC operation mode property.

         --rac-operation-mode (RAC operation mode:
          load_balance, failover (default: load_balance):

       • Failover (Active Passive)

         The installer configures multi data sources and data sources according to the number of Oracle RAC database instances. The first data source of each multi data source connects to the primary database instance specified in step 5, and the subsequent data sources connect to other database instances to be specified. This option preconfigures the database connections in WebLogic for warm standby.

         For this option, enter the value failover for the RAC operation mode property.

         --rac-operation-mode (RAC operation mode:
          load_balance, failover (default: load_balance):

    3. In the Listener Configuration section, do one of the following things:

       • Remote Listener (SCAN Listener)

         To choose this, enter the value remote for the listener configuration property.

         --listener-configuration (Listener Configuration:
          remote, local (default: remote): local

       • Local Listeners

         See "Listener Considerations for Oracle RAC" for information about listener functionality.

         To choose this, enter the value local for the listener configuration property.

         --listener-configuration (Listener Configuration:
          remote, local (default: remote): local

18. For a standalone setup, enter the following values for the Configuring Weblogic JDBC Data Sources and Listener Configuration parameters:

    Enter value for --rac-config (Configure Weblogic JDBC data Sources.
    now, later (default: now):
    Usage:
     
    RAC operation mode: failover
    Enter value for --listener-configuration (Listener Configuration:
     remote, local (default: remote): local

    If you entered the values, --use-oracle-rac true, --rac-config now, and --listener-configuration remote, the Oracle Real Application Clusters Instances - Remote Listener (SCAN Listener) section appears.

19. In the Oracle Real Application Clusters Instances - Remote Listener (SCAN Listener) section, do one of the following:

    • If you selected the remote listener option:

      1. For SCAN Address, you can modify the SCAN address if required. For example, you may need to do this if you entered an incorrect address for the db_host parameter in step 18 C.

      2. For the db_host parameter, you can modify the SCAN port if required. For example, you may need to do this if you entered an incorrect port in the Port field in step 18 C.

      3. Enter the value of the Database Service Name as you did for the primary instance and a unique SID for each additional Oracle RAC instance. For a container database, use the PDB service name and the CDB SID.

         --rac-remote-db-service (The Database Service Name. (default: remote-service)):

      4. If you did not specify the SID of the primary Oracle RAC instance, do so now by entering the value for the Database System Identifier property. For a container database, use the CDB SID.

         --rac-remote-db-sid (The Database System Identifier (SID). (default: null)): sid1

20. If you entered the values, --use-oracle-rac true and --rac-config now and --listener-configuration local, the following sections appear:

    • Additional RAC Count
      Specify the number of additional Oracle RAC instances:

      Note:

      At least two RAC instances should be specified to continue.

      --no-of-additional-rac (Enter the number of additional RAC Instances
              to be added (default: 2)):

    • Oracle RAC Instances
      Specify additional Oracle RAC instances. The instances must be in the same Oracle RAC database as the primary instance.

      1. The host and port: Each row must use a different combination of host and port. For example, if you use the same host, you must use a different port.

         For the RAC Local Database Host property, enter the value.

         --rac-local-db-host(The Database Host. (default: dbhost)):

         For the RAC Local Database Port property, enter the value.

         --rac-local-db-port(The Database Port. (default: 1521)):

      2. The service name or SID: Each row must specify either the same service name as the primary instance or a unique SID. Rows can also specify both service name and SID. Specify the same fields as you did for the primary instance. For example, if you only specified the SID for the primary instance, specify unique SIDs for the additional instances. For a container database, use the PDB service name and the CDB SID.

         For the RAC Local Database Service property, enter the value.

         --rac-local-db-service(The Database Service Name. (default: servicename)):

         For the RAC Local Database System Identifier property, enter the value.

         --rac-local-db-sid(The Database System Identifier (SID). (default: null)): sid1

    All instances must be in the same database.

21. If you selected a WebLogic cluster, the WebLogic Cluster Web Service Request Configuration section is displayed. Update the following parameters:

    • For the Front End Host property, enter the value.

      --front-end-host(Frontend Host. (default: host)):

    • For the Front End http Port property, enter the value.

      --front-end-http-port(Frontend HTTP Port. (default: port)):

    • For the Front End https Port property, enter the value.

      --front-end-https-port(Frontend HTTPS Port. (default: 0)):

    These are for Web Service HTTP requests. The installer automatically populates these fields with the values configured for your WebLogic domain, proxy server, or load balancer.

    If the WebLogic default values of <blank>and 0 appear, update the fields with the correct values. You must update these values to proceed with the installation.

    For information about updating these fields again after installation, see the discussion about how to configure HTTP settings for a cluster in the WebLogic Server Administration Console Help.

22. If you specified a single-instance database in the Database Server Connection Information section, the Database Connection Pool Information section is displayed. Go to step 23.

    If you specified an Oracle RAC database with its SID, the Oracle Real Application Clusters Configuration section is displayed. Go to step 15.

    If you have specified a WebLogic cluster, go to step 25.

    The Database Connection Pool Information section is displayed.

23. If you are not sure how to size the pool at this time, use the default settings. These settings can be tuned later from the WebLogic Server console. Do the following:

    1. For the Initial Capacity property, enter the number of database connections initially reserved in the WebLogic connection pool.

       --init-capacity(Initial Capacity - The number of connections created when the server starts (0 or more). (default: 15)):

       Note:

       In an Oracle RAC configuration, the initial capacity is set to 0 (read-only).

    2. For the Maximum Capacity property, enter the maximum number of database connections reserved in the WebLogic connection pool.

       --max-capacity(Maximum Capacity - The upper limit for the number of database connections (14 or more). (default: 54)):

    3. For the Capacity Increment property, enter the number of connections added when the connection pool maintained by the WebLogic Server is exhausted.

       --capacity-increase(Capacity Increment - The number of connections that will be created when all existing connections are in use (1 or more). (default: 1)):

       Note:

       In an Oracle RAC configuration, this connection pool information will be shared.

    The JMS Store Information section is displayed.

24. For the JMS Store Information property, accept the default setting of file or enter the alternate jdbc.

    --jms-store (Candidates: jdbc, file(default: file):

    If you choose JMS File Store, OSM will use the default WebLogic file-based persistent store as the JMS store. After the installation is complete, Oracle recommends that you configure one custom file store for each managed server and JMS server. For more information, see "Creating and Configuring Persistent File Stores."

    While filestores provide better performance than JDBC stores, the benefit of JDBC stores is that online database backups can obtain consistent snapshots of both OSM data and JMS messages. However, there is currently no mechanism for consistent backup of JDBC stores and transaction logs. For more information about backup strategies, see OSM System Administrator's Guide.

25. If OSM is being deployed to a WebLogic cluster, the WebLogic Coherence Cluster Configuration section is displayed.

    If OSM is being deployed to a single WebLogic server, the OSM Administrator and Deployment Credentials section is displayed. Go to step 27.

26. Accept the settings for the WebLogic coherence cluster that the installer has detected, or create a new coherence cluster by modifying the default values.

    Enter a value for the Unicast Listen Port property.

    --unicast-port(Unicast Listen Port: (default: 17001):

    Enter a value for the Well Known Address property.

    --well-known-address(IP address for the server MS2 where OSM is targeted. (default: host):

    Enter a value for the Well Known Address property.

    --well-known-address(IP address for the server MS1 where OSM is targeted. (default: host):

    The coherence cluster name is generated using the pattern: osmCoherenceClusterN, where N is a number generated by the OSM installer. Ensure that the IP Address value corresponds to the IP address or machine name of the WebLogic Server where the coherence cluster is running.

    Note:

    Oracle recommends using unicast cluster messaging mode. The installer uses unicast mode and does not allow you to use the installer to change the mode to multicast. Even if the target WebLogic cluster is a member of a coherence cluster that uses multicast mode, the installer modifies the cluster messaging mode to unicast. For information about using WebLogic to change the cluster messaging mode to multicast, see "Configuring a Multicast IP Address for the Cluster Messaging Mode."

    The OSM Administrator and Deployment Credentials section is displayed.

    Note:

    If you get the "Well known address with listen address xx.xx.xx.xx is not valid or not reachable” error, launch the installer with a user who has root privileges.

27. The user names and passwords you provide will be used to create initial user accounts with administrator privileges and access to Oracle Communications Design Studio (the deployment tool). Do the following:

    1. For the OSM Administrator Username parameter, enter a username, or use the default admin.

       --osm-admin-username (Admin User Name - User account with Administrator privileges. (default: admin)):

    2. For the OSM Administrator Account Password parameter, enter a password for the OSM Administrator user. The default is null.

       --osm-admin-password (Password - The password for the Administrator user account. (default: null)):

    3. For the OSM Deploy Administrator User parameter, enter a user name or use the default deployAdmin. Design Studio uses this user to deploy cartridges to OSM.

       --osm-deploy-admin-username (Deploy Admin User Name - User account with privileges to deploy. (default: deployAdmin)):

    4. For the OSM Deploy Administrator User Password parameter, enter a password for the Deploy Admin user.

       --osm-deploy-admin-password (Password - The password for the Deploy Admin user account. (default: null)):

    5. Press Enter.

       The OSM WebLogic User Account Passwords section is displayed.

28. You use this section to create passwords for the standard users that are created for the application. The Automation User Name and OSM Core User Name are provided in this section for reference only and are not editable. The passwords you enter must meet the password requirements for your WebLogic domain. Do the following:

    1. For the OSM Automation User Password parameter, enter the password for the oms-automation user. This is the internal automation user, used for processing OSM automation and email notifications.

       --osm-automation-user-password (Automation User Password - The password for the automation user account. (default: null)):

    2. For the OSM Core User Password parameter, enter the password for the oms-internal user. It is used for internal processing when an operation must be performed on behalf of the application rather than on behalf of the user.

       --osm-core-user-password (OSM Core User Password - The password for the OSM core user account. (default: null)):

    3. For the OSM Metrics User Password parameter, enter the password for the oms-metrics user.

       --osm-metrics-user-password (OSM Metrics User Password - The password for the OSM metrics user account. (default: null)):

       Press Enter.

       The WebLogic Coherence Cache Configuration section is displayed.

29. (Optional) To customize the default Coherence Cache Configuration, do the following:

    1. If you want to customize the Coherence Cache Configuration, enter the value true. OSM will use the default Coherence Cache Configuration for the value false.

       --use-custom-coherence-cache-config (Use Custom Coherence Cache
           Configuration. (default: false)): 

    2. Provide the custom Coherence Cache Configuration file path if --use-custom-coherence-cache-config is true. The file path should be from the host where installer is running. You can get the sample file by extracting the oms.ear from $OSM_INSTALLER_HOME/wlsdeploy/applications/security.gar/META-INF/osm-coherence-cache-config.xml.

       For more details, refer to: Configuring and Monitoring Coherence Threads

       Note:

       Do not modify the sample configuration file directly inside oms.ear, this can result in inconsistency if not done properly.

       --coherence-cache-config-file-path (The Coherence Cache Configuration File
           Path):  /path/to/custom/config.xml

       The file validation will happen if using custom configuration and next, the OSM Server Session Information section is displayed.

       Note:

       You must preserve the Coherence Cache Configuration file and ensure it is provided to all subsequent installer runs for this environment (usually for OSM upgrade). The installer remembers the last provided location as default, but you can change that if needed.

30. The information in this section is used to configure your OSM user sessions. Do the following:

    1. For the Session Timeout parameter, enter the time in minutes that Order Management web client and Task web client sessions remain active.

       --osm-session-timeout (Session Timeout - The period of time a user session can remain idle before it expires. range (1-1440 minutes). (default: 45)):

    2. For the Server Domain Suffix parameter, enter the domain suffix for the computers on which the OSM server will run.

       --osm-server-domain-suffix (Server Domain Suffix - The Domain Suffix (e.g. sample.com) for the computers the Order and Service Management Server will run on. (default: oracle.com)):

    3. For the Landing Page parameter, select the first page that Task Web Client users will see after login.

       --osm-landing-page (Landing Page - Specifies the first page that web client users see after logging in.
        Candidates: worklist, about, home, query (default: worklist):

    4. The Order and Service Management Remarks and Attachment Information section is displayed.

31. The information in this section is used to configure the text remarks and file attachments that users can add to OSM orders. Do the following:

    1. For the Maximum Attachment Size parameter, enter the maximum attachment size in MB that can be appended to a remark.

       --osm-max-attachment-size (Maximum Attachment Size - The maximum size of a single attachment, range (1-100 MB). (default: 3)):

    2. For the Remark Change Timeout parameter, enter the length of time in hours that a remark can be edited before it becomes read-only.

       --osm-remark-change-timeout (Remark Change Timeout - The length of time before a remark becomes read-only (-1 or more hours). (default: 1)):

    3. Press Enter.

       The Order and Service Management Notification Emails section is displayed.

32. The information in this section is used to configure the email notifications for OSM. Do the following:

    1. For the Notification Email Server parameter, enter the DNS name or IP address of your email server.

       --osm-notification-email-server (Notification Email Server - The DNS Name or IP address of your email server. (default: 127.0.0.1)):

    2. For the Notification Email Server Port parameter, enter the port on which the email server is listening.

       --osm-notification-email-server-port (Notification Email Server Port - The port of your email server. (default: 993)):

    3. For the Admin Email Address parameter, enter the OSM Administrator's email address.

       --osm-admin-email-address (Admin Email Address - The email address of the Order and Service Management admin. (default: null)):

    4. Press Enter.

       The Task Processor Configuration section is displayed.

33. The information in this section is used to control the rule and delay task evaluation. You can change these settings at any time after installing OSM. See OSM System Administrator's Guide for information about changing these values in oms-config.xml.

    Do the following:

    1. For the Task Processor Interval parameter, enter the number of seconds between task processor polls.

       --osm-task-processor-interval (Task Processor Interval - The interval between task processor polls, range (1 - 60 seconds). (default: 5)):

    2. For the Maximum Rule Processor Count parameter, enter the maximum number of rule task processors used to evaluate rules.

       --osm-max-rule-count (Maximum Rule Processor Count - The maximum number of rule task processors, range (1 - 50). (default: 1)):

    3. For the Maximum Delay Processor Count parameter, enter the maximum number of delay task processors used to evaluate delays.

       --osm-max-delay-processor-count (Maximum Delay Processor Count - The maximum number of delay task processors, range (0 - 50). (default: 1)):

       Note:

       The total number of processors will be adjusted automatically at run time to exceed not more than 10% of the connection pool size. For a non-production environment, you can use the default values.

In the installation phase, you carry out the following tasks:

1. Reading the pre-configured property values and facilitating the creation or upgradation of the OSM database schema.
2. Configuring the WebLogic domain for OSM and deploying the OSM application.

Use the following command if you are choosing to not use the -p parameter.

$ export OSM_CFG_HOME=/path/to/rootdir/for/configurations
$ export FMW_HOME=/path/to/FMW_HOME
$ export PASSPHRASE=passphrase

Run the following command for automating the DB schema creation and OSM deployment in WebLogic domain:

$ $OSM_INSTALLER_HOME/scripts/configOSM.sh -n osm_env_name  -c $OSM_CFG_HOME -l $OSM_INSTALLER_HOME -f $FMW_HOME

Use the following command if you are choosing to use the -p parameter.

Set the environment variable:

$ export OSM_CFG_HOME= /path/to/rootdir/for/configurations
$ export FMW_HOME=/path/to/FMW_HOME
$ export PASSPHRASE_ENV_NAME=passphrase

Run the following command for automating the DB schema creation and OSM deployment in WebLogic domain:

$ $OSM_INSTALLER_HOME/scripts/configOSM.sh -n osm_env_name -c $OSM_CFG_HOME -l $OSM_INSTALLER_HOME -f $FMW_HOME -p PASSPHRASE_ENV_NAME

You can run the script with -h for more details. This script runs the OSM Domain Installer, which creates or upgrades the OSM database schema and also configures the Weblogic domain in online mode. Make sure the Admin server is up and running and all the managed servers are shutdown. Run the script with -h for more details.

You also have the option to install the DB schema and OSM Domain in two separate steps. If one of the components, such as the database, is installed successfully but the Weblogic server failed for some reason, then you can rerun only the Weblogic server component to install it.

Use the following commands if you are choosing to not use the -p parameter.

Set the following environment variables:

$ export OSM_CFG_HOME=/path/to/rootdir/for/configurations
$ export FMW_HOME=/path/to/FMW_HOME
$ export PASSPHRASE=passphrase

$ $OSM_INSTALLER_HOME/scripts/configDB.sh -n osm_env_name -c $OSM_CFG_HOME -l $OSM_INSTALLER_HOME 

You can run the script with -h for more details

To install or upgrade OSM in WebLogic Domain, run the following command:

$ $OSM_INSTALLER_HOME/scripts/configDomain.sh -n osm_env_name -c $OSM_CFG_HOME -l $OSM_INSTALLER_HOME -f $FMW_HOME

You can run the script with -h for more details

Use the following commands if you are choosing to use the -p parameter.

Set the following environment variables:

$ export OSM_CFG_HOME=/path/to/rootdir/for/configurations
$ export FMW_HOME=/path/to/FMW_HOME
$ export PASSPHRASE_ENV_NAME=passphrase

To install the OSM DB schema, run the following command:

$ $OSM_INSTALLER_HOME/scripts/configDB.sh -n osm_env_name -c $OSM_CFG_HOME -l $OSM_INSTALLER_HOME -p PASSPHRASE_ENV_NAME

To install or upgrade OSM in WebLogic Domain, run the following command:

$ $OSM_INSTALLER_HOME/scripts/configDomain.sh -n osm_env_name -c $OSM_CFG_HOME -l $OSM_INSTALLER_HOME -f $FMW_HOME -p PASSPHRASE_ENV_NAME

If you experience any issues with installation, refer to the "Troubleshooting OSM Installation Problems".

To configure threads counts to ensure performance, you can tune these threads in the osm-coherence-cache-config.xml file. Oracle recommends that you customize the osm-coherence-cache-config.xml file for tuning procedures as described in "OSM Pre-Production Testing and Tuning."