Best practices for setting ports with RPC program numbers or queues and threads

Components, such as the reconciliation engine on the Remedy Action Request System server, use the default queues to communicate with other components. You can optimize the performance of these components by configuring them to use specific private queues. You can also set the number threads used for normalization and reconciliation to increase the speed at which jobs are processed.

A queue is denoted by its RPC program number, for example, 390635 or its purpose, such as fast, list, private, and so on. A job is placed in a queue while waiting for an available thread.

Threads enable the server to process concurrent client requests. Each thread within the multi-threaded carries out a client request, and then returns to the queue to process the next request. For more information about queues and threads function in the Remedy AR System server, see  AR System server architecture and scalability  in the Remedy Action Request System online documentation.

To configure ports for queues and threads on the Remedy AR System server

The Remedy Action Request System server receives requests from BMC CMDB. Before you configure the queues in BMC CMDB, you must first configure the queues on the Remedy Action Request System server. Perform the following steps to configure a queue on the Remedy AR System server:  

1. Log in to the Remedy Action Request System server.
2. Select AR System Administration > AR System Administration Console >Server Information > Ports and Queues.
3. Add entries to the Server Queues table.
   To avoid collision or interference with other BMC Remedy products, make sure that the RPC program numbers on your computer are set as shown in RPC program numbers used by BMC CMDB. 
4. Configure the Min Threads and the Max Threads for each port.
   The Reconciliation Engine multithreading lets you break up large jobs into smaller ones and running them concurrently. However, you must limit the number of concurrent threads to twice the number of CPUs in the server.
   
5. Click Apply.
   

6. Restart the Remedy AR System server.

   Note

   Set only as many threads as your database and system resources can reasonably support. The total number of threads cannot exceed the number of database connections available to the Remedy AR System server. 

RPC program numbers used by BMC CMDB

The following table lists the RPC program numbers used by CMDB.

To verify private queues

To avoid collisions with BMC Remedy products, you can use the following methods to examine the private queues on your Remedy AR System server:

• Inspect the ar.conf (UNIX) or ar.cfg (Windows) files for RPC program numbers in use.
  You can find the ar.cfg file in the following locations
  UNIX — ARSystemServerInstallDir/conf/ar.conf
  Windows — ARSystemServerInstallDir\Conf\ar.cfg
  For example, 390626 is used by the Plugin-Loopback-RPC-Socket (with the Report Creator plug-in). You may see entries similar to the following example in the ar.cfg file:

  Private-RPC-Socket: 390601 1 1
  Private-RPC-Socket: 390603 1 1
  Private-RPC-Socket: 390620 8 12
  Private-RPC-Socket: 390626 5 7
  Private-RPC-Socket: 390635 16 20
  Private-RPC-Socket: 390680 2 2
  Approval-RPC-Socket: 390680

• Use the AR_SERVER_INFO_PS_RPC_SOCKET (87) ARGetServerInfo API call to view the RPC program number that the approval server uses when contacting the Remedy AR System. The API call has the following format:

  #include "ar.h"
  #include "arerrno.h"
  #include "arextern.h"
   
  int ARGetServerInfo(
     ARControlStruct *control,
     ARServerInfoRequestList *requestList,
     ARServerInfoList *serverInfo,
     ARStatusList *status)

  For more information, see  ARGetServerInfo  in the Remedy Action Request System online documentation. 

Private queues for normalization and reconciliation

BMC recommends the following minimum and maximum threads for a medium sized setup consisting of two servers, 4 CPU cores, 16 GB RAM, and 120 GB disk space. See  Knowledge article 000114508  for more information. 

Related topics

Communities post on private queues

Communities post on queues and threads

Fine-tuning or adjusting configuration parameters after installing CMDB or other AtriumCore applications (Knowledge article 000096329) (Support login required)

Best practice recommendations to configure the Out of the Box AR System platform (Knowledge article 000114508)

Configuring CMDB synchronization with BMC Discovery through a private queue

BMC Remedy Approval Server configuration file settings