BRM Technical Overview

BRM Server Configuration

CAGBU Enablement Team

Safe harbor statement

The following is intended to outline our general product direction. It is intended for information
purposes only, and may not be incorporated into any contract. It is not a commitment to deliver any
material, code, or functionality, and should not be relied upon in making purchasing decisions. The
development, release, timing, and pricing of any features or functionality described for Oracle’s
products may change and remains at the sole discretion of Oracle Corporation.

2 Copyright © 2020, Oracle and/or its affiliates

Locating the configuration files

BRM Home Directory

sys/ apps/
server, system BRM
files, Applications
configuration files
(pin.conf)

cm/ eai_js dm_oracle/ test/ pin_billd/

Connection Payload Gen Oracle Data Utilities and billing
Manager EM Manager testing applications
Java Server

pin.conf Infranet.properties pin.conf pin.conf pin.conf

4 Copyright © 2020, Oracle and/or its affiliates

Configuring BRM processes

Application Tier Bus. Process Tier Object Tier Data Tier

BRM Data API TM

API
Applications API Manager Database
CM

BRM Applications Connection Manager Data Managers External Systems

pin.conf or pin.conf pin.conf

Infranet.proper
ties cm location dm1 location
cm config dm1 config
app config ES1 location
cm location eai_js location
dm1 location

Infranet.properties

eai_js location
eai_js config

5 Copyright © 2020, Oracle and/or its affiliates

Syntax of pin.conf file entries

[hostname] [program] [keyword] [one or more values]

#--------------------------------------------------------
# Example pin.conf entry
#--------------------------------------------------------
- nap cm_name cabernet # CM session leader hostname
- nap cm_port 11000 # CM session leader port number

• hostname: Processes running on the server named hostname should

read the entry
- A value of “-” means “any”; that is processes running on any server

• program: Processes named program should read the entry

- A value of “-” means “any” (that is, any process or application)
- A value of “nap” means “networked application” (that is, any BRM application)

6 Copyright © 2020, Oracle and/or its affiliates

Syntax of pin.conf file entries

[hostname] [program] [keyword] [one or more values]

#--------------------------------------------------------
# Example pin.conf entry
#--------------------------------------------------------
- nap cm_name cabernet # CM session leader hostname
- nap cm_port 11000 # CM session leader port number

• keyword: A string value that the process locates programmatically

- Entries are read “programmatically” with the pin_conf function

• value: A data value read by the process

- The cm_port entry has an additional tag pin; Facilities Module (FM) with
matching tag is linked to that Connection Manager (CM).

7 Copyright © 2020, Oracle and/or its affiliates

CM pin.conf file

• Provides entries for:

- Configuring the CM at startup. For example:
◦ Host name and port number
◦ Path and file name of the pinlog file and error logging level
- Locating Data Managers (DMs); for example, database number, host name, and port number for each DM
- FM functionality; for example, the path and filename of FM shared libraries with which the CM should link
- Configurable FM values; for example the default business policy values

• Entries with a process name of cm are read when the CM process is started.

• Entries with a process name of fm_xxx are read in real time when the FM is called.

8 Copyright © 2020, Oracle and/or its affiliates

CM pin.conf file example

# Hostname and port number

- cm cm_name localhost
- cm cm_ports 11005 pin

# Path/filename of pinlog file and error logging level

- cm cm_loglevel 3
- cm cm_logfile ${PIN_LOG_DIR}/cm/cm.pinlog

# Database #, hostname, port number for each DM

- cm dm_pointer 0.0.0.1 ip localhost 21005

# Path/filename of FM shared libraries with which the CM should link

- cm fm_module /opt/portal/7.5/lib/fm_cust.so fm_cust_config – pin

# Configurable FM Values
- fm_cust_pol country USA
- fm_bill timestamp_rounding 1

9 Copyright © 2020, Oracle and/or its affiliates

Syntax of Infranet.properties file entries

[infranet.keyword] = [value]

#--------------------------------------------------------
# Example Infranet.properties entry
#--------------------------------------------------------
infranet.server.portNr=26005
infranet.log.file= ${PIN_LOG_DIR}/js/js.pinlog
infranet.log.name=PCMJavaServer
infranet.log.level=3

• infranet.keyword - a string value that the process is looking for programmatically

• value - a data value read by the process

10 Copyright © 2020, Oracle and/or its affiliates

Infranet.properties: Example for eai_js

# java servers port number

infranet.server.portNr=26005

# the log file that the java server will log msgs to
infranet.log.file= ${PIN_LOG_DIR}/eai_js/eai_js.pinlog

# application name that the java server will use in its log msgs
infranet.log.name=PCMJavaServer

# log level
infranet.log.level=1

# defines the Publish Handler

infranet.opcode.handler.PUBLISH_GEN_PAYLOAD =
com.portal.eai.PublishHandler

#defines config file for payload generator

infranet.eai.configFile =
/edvmr1p0/pin5/opt/portal/7.5/sys/eai_js/payloadconfig_ifw_sync.xml

11 Copyright © 2020, Oracle and/or its affiliates

DM pin.conf file

Provides entries for:

• Configuring the DM at startup, including:

- Host name, port number, and database number
- Path and file name of pinlog file
- Queue Manager parameters
- Entries with a process name of dm are read when the DM process is started
•
External system connection information:
- Depends on external system, possibly an ID, username, password, etc.

• Configurable external system values:

- Default values, depend on external system requirements

12 Copyright © 2020, Oracle and/or its affiliates

DM pin.conf file example

# Hostname, port number, and database number

- dm dm_name localhost
- dm dm_port 21005
- dm dm_db_no 0.0.0.1 / 0

# Path/filename of pinlog file

- dm dm_logfile ${PIN_LOG_DIR}/dm_oracle/dm_oracle.pinlog

# Number of DM front ends

- dm dm_n_fe 1
Initially set to 0 to disable
# DM Data Dictionary access entries
customizations
- dm dd_write_enable_fields 1
- dm dd_write_enable_objects 1

13 Copyright © 2020, Oracle and/or its affiliates

Starting BRM processes

Application Tier Bus. Process Tier Object Tier Data Tier

BRM Data API TM

API
Applications API Manager
Database
CM

EAI Java Server Account

Sync API TM
DM
Disc Pipeline

pin_ctl start process

rtp cm eai_js dm_ifw_sync dm_oracle

Start Start processes in this order Start

BRM Apps BRM DB
14 Copyright © 2020, Oracle and/or its affiliates
Stopping BRM processes

Application Tier Bus. Process Tier Object Tier Data Tier

BRM Data API TM

API
Applications API Manager
Database
CM

EAI Java Server Account

Sync API TM
DM
Disc Pipeline

pin_ctl stop process

rtp cm eai_js dm_ifw_sync dm_oracle

Stop Stop processes in this order Stop

BRM Apps BRM DB

15 Copyright © 2020, Oracle and/or its affiliates

BRM Cloud Native

• Config maps are used to for the following files:

- Pin.conf
- Infranet.properties
- Pipeline registry

• Config maps are mounted as file inside the PODs

• File format is unchanged

16 Copyright © 2020, Oracle and/or its affiliates