C OSM Installed Components

When you run the various installers and follow the configuration procedures, the system creates and populates a directory structure and installs the components that OSM requires. For information about installing Oracle Communications Order and Service Management (OSM), see OSM Installation Guide.

This appendix describes the OSM directory structure and the components that are automatically configured by OSM Installer.

OSM Directory Structure

Table C-1 lists and describes the OSM directories.

Table C-1 OSM Directories

Directory Description

OSM_home/bin

Contains copies of the oms.ear file and cartridge management web service (cartridge_management_ws) application.

OSM_home/Database

Contains the following database installation files, in the /Database/osm-db-installer-core/install directory:

  • om_$install$plan_actions.csv

  • dbInstaller.log

  • omsmodel_l10n.jar

OSM_home/ProductCartridges

Contains the product cartridges.

OSM_home/SDK

Contains the SDK and SDK samples (optional). The following sub-directories are available in the SDK:

  • Automation: Used by Design Studio for compiling when there are automation plug-ins.

  • CartridgeManagementTool: Used for compiling and deploying task assignment.

  • Compliance: Needed to run the compliance tool. See OSM Installation Guide for more information.

  • Customization: Needed to manage the oms.ear file when updates are required for localization files.

  • Reporting: Needed to run reporting queries.

  • Samples: Contains development samples, for example, web services samples.

  • WebService: Contains web service definition language (WSDL) files.

  • XMLImportExport: Contains command line utilities for metadata management.

    Note: Oracle recommends using Design Studio for cartridge management.

  • XMLSchema: Contains schema definitions for the XML API.

Productized Cartridges

The OSM DB Installer deploys the following cartridge:

  • Job Order cartridge: Enables the job control order feature. For information about using job orders, see OSM Modeling Guide.

WebLogic Installed Components

This section lists and describes the OSM WebLogic installed components and configurations.

WebLogic Deployments

Table C-2 lists the WebLogic deployments.

Table C-2 WebLogic Deployments

Deployment Name Description

cartridge_management_ws

Application used to deploy, undeploy, and query cartridges.

oms

The Order and Service Management application.

WebLogic Configuration

This section lists and describes the WebLogic configuration.

Coherence Clusters

The Installer configures the following coherence cluster:

  • osmCoherenceClusteruniqueid

    where uniqueid is a random four digit number used to generate a unique string.

For information about configuring Oracle coherence for an OSM cluster, see OSM Installation Guide.

Work Managers

See "Using Work Managers to Prioritize Work" for information about work managers.

Table C-3 lists and describes the work managers that are configured.

Table C-3 Configured Work Managers

Name Type Description

osmAutomationWorkManager

Work manager

Used to process work performed by automation tasks.

osmOmClientWorkManager

Work manager

Used to process requests from manual users using the Order Management web client.

osmTaskClientWorkManager

Work manager

Used to process requests from manual users using the Task web client.

osmWsHttpWorkManager

Work manager

Used to process OSM HTTP WebService requests.

osmWsJmsWorkManager

Work manager

Used to process OSM JMS WebService requests.

osmXmlWorkManager

Work manager

Used to process requests coming in from external clients for the OSM XML API.

osmAutomationMaxThreadConstraint Maximum Thread Constraint Used to ensure that the maximum thread size is not more than the JDBC connection pool size.
osmGuiMaxThreadConstraint Maximum Thread Constraint N/A
osmHttpApiMaxThreadConstraint Maximum Thread Constraint N/A
osmJmsApiMaxThreadConstraint Maximum Thread Constraint N/A
osmGuiMinThreadConstraint Minimum Thread Constraint N/A
JMS Servers

The following JMS server is configured:

  • oms_jms_server

JMS Module

The following JMS module is configured:

  • oms_jms_module: Contains the JMS system resources for OSM.

Queues and Topics

Distributed Destinations in a Cluster

In a clustered WebLogic deployment, a distributed destination is created for each queue and topic. This distributed destination then has members created (a queue or topic) on each of the managed servers.

For example, in a clustered deployment that contains two managed servers called MS1 and MS2, the osm_behavior_queue queue has the following:

  • A distributed destination called osm_behavior_queue

  • Two members called oms_jms_server@ms1@osm_behavior_queue and oms_jms_server@ms2@osm_behavior_queue

Table C-4 Queues and Topics Configured for OSM

Name Type JNDI Description

osm_behavior_queue

Queue

mslv/oms/oms1/internal/jms/behaviors

Used to customize task assignment.

osm_cartridge_deploy

Queue

mslv/provisioning/internal/ejb/deployCartridgeQueue

Internal use only.

osm_events

Queue

mslv/oms/oms1/internal/jms/events

Internal use only.

osm_order_events

Topic

mslv/provisioning/external/orderevents

Where order lifecycle events are published.

osm_order_updates

Queue

mslv/provisioning/internal/ejb/orderupdates

Internal use only.

osm_signal_topic

Topic

mslv/oms/oms1/internal/jms/InternalSignalTopic

Internal use only.

osm_ws_cluster_correlates

Queue

oracle/communications/ordermanagement/WebServiceClusterCorrelateQueue

Used to route OSM service requests, in the context of an existing order in a WebLogic Server cluster, to the managed server that owns the order.

osm_ws_cluster_requests

Queue

oracle/communications/ordermanagement/WebServiceClusterRequestQueue

Used to receive requests for order amendments in a WebLogic Server cluster. Can also be used for new order creation requests.

osm_ws_cluster_responses

Queue

oracle/communications/ordermanagement/WebServiceClusterResponseQueue

Used to fetch a correlated message from the web service cluster correlate queue, analyze the original JMS properties, and forward the response to the original JMSReplyTo.

osm_ws_requests

Queue

oracle/communications/ordermanagement/WebServiceQueue

Used to receive order creation and amendment requests in a single-server WebLogic Server environment. Can also be used for new order creation requests for a WebLogic Server cluster.

osmErrorQueue

Queue

oracle/communications/ordermanagement/osm/ErrorQueue

N/A

ErrorQueue Queue oracle/error_queue N/A
Quotas

Quotas are used to control the allotment of system resources available to OSM destinations (queues or topics).

Table C-5 lists and describes the quotas that are configured.

Table C-5 Configured Quotas

Quota Name Destination Name

oms_behavior_queue.Quota

oms_behavior_queue

oms_cartridge_deploy.Quota

oms_cartridge_deploy

oms_events.Quota

oms_events

oms_order_events.Quota

oms_order_events

oms_order_updates.Quota

oms_order_updates

oms_signal_topic.Quota

oms_signal_topic

oms_ws_cluster_correlates.Quota

oms_ws_cluster_correlates

oms_ws_cluster_requests.Quota

oms_ws_cluster_requests

oms_ws_cluster_responses.Quota

oms_ws_cluster_responses

oms_ws_requests.Quota

oms_ws_requests

OrchestrationDependeciesQueue.Quota

OrchestrationDependeciesQueue

osmErrorQueue.Quota

osmErrorQueue

Connection Factories

The following connection factories are configured:

  • osm_connection_factory

  • osmExternalClientConnectionFactory: Use this connection factory to submit OSM Web Service and XML API requests (including order creation) from an external system.

  • oms_events_connection_factory
Destination Key

The following destination key is configured:

  • osmDescendingPriorityDestinationKey

For information about configuring destination keys, see Oracle Fusion Middleware Administration Console Online Help for Oracle WebLogic Server.

JMS Template

A JMS template for the OSM destinations is created. This template applies recommended defaults for the following settings:

  • Redelivery Limit

  • Redelivery Delay

  • Error Destination

The following JMS template is configured:

  • osmJmsTemplate

For information about JMS templates, see Oracle Fusion Middleware Administration Console Online Help for Oracle WebLogic Server.

File T3

The installer configures the following file:

  • Oms_Remote_File_System

For information about configuring the T3 file path to support attachments, see OSM Installation Guide.

Data Sources

OSM Installer configures the following types of data sources:

  • Active Active

  • Active Passive

The Installer also configures the following standalone data source:

  • oms_pool

Table C-6 lists the load balancing data sources configured by the Installer. For information about connecting Oracle RAC with JDBC multi data sources, see OSM Installation Guide.

Table C-6 Load Balancing Data Sources Configured by OSM Installer

Name Type Description

oms_pool_group

Multi

One oms_pool_group is required for each target server for failover.

osm_pool_rac_group

Generic

One osm_pool_rac_group is required for each target server. For example:

osm_pool_rac2_group_b

Table C-7 lists the failover data sources configured by the installer.

Table C-7 Failover Data Sources Configured by OSM Installer

Name Type Description

oms_pool

Multi

One oms_pool data source is configured for the cluster.

osm_pool_rac

Generic

Users and Groups

This section describes the users and groups that are created by the OSM Installer. For information about the users and groups that are created by the WebLogic Server Installer, see Fusion Middleware Securing Resources Using Roles and Policies for Oracle WebLogic Server.

A security realm consists of a set of configured security providers, users, groups, security roles, and security policies that protect WebLogic resources. To access WebLogic resources that belong a security realm, a user must be defined in that realm.

Add users to groups by using WebLogic Server Administration Console. For more information, see "Adding Users to Groups in the WebLogic Server Administration Console."

When OSM is installed, several default accounts are created in WebLogic Security Realm.

Table C-8 and Table C-9 list the users, groups, and their descriptions.

Table C-8 Default Application Accounts

Default Account Description Assigned Groups

Default OSM Administrator account

The OSM Administrator account name and password are specified during OSM installation. The default is admin.

OMS_user_assigner

OMS_workgroup_manager

OMS_client

OMS_xml_api

OMS_ws_api

OMS_ws_diag

oms-automation

Used for processing OSM automation and email notifications.

OSM_automation

osm-internal

Used for internal processing when operation must be performed on behalf of the application rather than on behalf of the user.

Administrators

OSM_automation

Default Design Studio administrator account

The Design Studio administrator account and password for managing OSM cartridges are specified during OSM installation. The default is deployAdmin.

Cartridge_Management_WebService

Table C-9 Default Groups in the Server Security Realm

Group Name Description

Cartridge_Management_WebService

OSM cartridge management access. This group also allows access to the features in the View Cartridges option in the Order Management web client. See OSM Order Management Web Client User's Guide for information about this feature.

This belongs to the Administrator group.

OMS_cache_manager

Monitoring and control of order cache.

OMS_client

Provides access to Order Management, Task, and Order Lifecycle Manager web clients.

OMS_user_assigner

Users in this group can do the following:

  • Associate users with workgroups

  • Manage notifications

  • Manage system events

  • Refresh the metadata cache

OMS_workgroup_manager

Users in this group can do the following:

  • Modify workgroup schedules

  • Delete workgroups

  • Manage notifications

  • Manage system events

  • Refresh the metadata cache

OMS_ws_api

WebService API access

OMS_ws_diag

WebService diagnostic access

OMS_xml_api

XML API access

OSM_automation

This role is granted to the user that is allowed to execute the automation plug-in.

The Installer automatically assigns the oms-automation user to this group, and Design Studio automatically assigns users specified in the Run-As property of the automation plug-in.

OSM_USER_manager Manage user accounts
osmEntityClientGroup Entity UI access
osmRestApiGroup OSM REST API
OMS_log_manager Manage log settings

Database Configuration

The OSM DB Installer creates the following database schemas:

  • Core schema

  • Rule engine schema

  • Reporting schema

Table C-10 shows the roles and permissions that are granted to database schema users.

Table C-10 Roles and Permissions Granted to Database Schema Users

Schema Roles and Permissions

Core

resource

create session

create table

create view

create synonym

create sequence

alter session

unlimited tablespace

create job

create any context

execute on dbms_lock

select on v_$parameter

Rule engine

resource

create session

create table

create view

create synonym

create sequence

alter session

unlimited tablespace

Reporting

resource

create session

create view

create synonym

unlimited tablespace