Unsupported content This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Recommended AR Application System application server configuration settings

Note

The following AR server threads can be manually inserted into their respective configuration files. Program restart is necessary if configurations are changed in the configuration files directly.

Set Delay-Recache-Time

Value: 5 minutes (300 seconds)
Location: <ar_install_dir>/conf/ar.cfg
Parameter: Delay-Recache-Time: 300
Limitation: Generic
Manual Steps: None

Max-Entries-Per-Query

Value: 0
Location: <ar_install_dir>/conf/ar.cfg
Parameter: Max-Entries-Per-Query: 0
Limitation: Generic
Manual Steps:

  1. Open the AR System Administration Server Information.
  2. Select the Configuration tab.
  3. In the Max Entries Returned By GetList field, enter 0.
  4. Click OK.

Next-Id-block-size

Value: 100
Location: <ar_install_dir>/conf/ar.cfg
Parameters: Next-ID-Block-Size: 100
Limitation: Generic
Manual Steps:

  1. Open the AR System Administration Server Information.
  2. Select the Configuration tab.
  3. In the Next Request ID Block Size field, enter 100.
  4. Click OK.

Server-Side-Table-Chunk-Size

Value: 1000
Location: <ar_install_dir>/conf/ar.cfg
Parameters: Server-Side-Table-Chunk-Size: 1000
Limitation: Generic
Manual Steps:

  1. Open the AR System Administration Server Information.
  2. Select the Configuration tab.
  3. In the Server Table Field Chunk Size field, enter 1000.
  4. Click OK.

Unqualified searches

Value: Uncheck
Location: <ar_install_dir>/conf/ar.cfg
Parameter: Allow-Unqual-Queries: F
Limitation: Generic / company policy determined
Manual Steps:

  1. Open the AR System Administration Server Information.
  2. Select the Configuration tab.
  3. Uncheck Allow Unqualified Searches.
  4. Click OK.

Development cache mode

Value: Uncheck
Location: <ar_install_dir>/conf/ar.cfg
Parameter: Cache-Mode: 0
Limitation: Production only
Manual Steps:

  1. Open the AR System Administration Server Information.
  2. Select the Configuration tab.
  3. Uncheck Development Cache Mode.
  4. Click OK.

Turn off all logging

Value: Uncheck Logging (API/SQL/Filter) along with other logging
Location: <ar_install_dir>/conf/ar.cfg
Parameter: Debug-mode: 0
Limitation: Generic / Production only
Manual Steps:

  1. Open the AR System Administration Server Information.
  2. Select the Log Files tab.
  3. Ensure that none of the options are selected.
  4. Click OK.

Submitter Mode

Value: Locked
Location: <ar_install_dir>/conf/ar.cfg
Parameter: Submitter-Mode: 1
Limitation: Generic / company policy determined
Manual Steps:

  1. Open the AR System Administration Server Information.
  2. Select the License tab.
  3. Select Locked for Submitter Mode.
  4. Click OK.
  5. Restart the BMC Remedy AR System server.

Thread Recommendations

Configure the Fast and List queue values in ar_install_dir/conf/ar.cfg with the following parameters and values:

  • Private-RPC-Socket: 390601 1 1
  • Private-RPC-Socket: 390603 1 1
  • Private-RPC-Socket: 390620 6 6
  • Private-RPC-Socket: 390626 3 3
  • Private-RPC-Socket: 390635 6 6

Note

Fast and List thread settings are hardware configuration based limitations.
 There is no configuration file to configure the Customer Access Interface (CAI) plug-in registry value. Entry is saved in the database. Do manual steps 7-9.

Manual Steps

  1. Log in to the User Tool as an Administrator.
  2. Access the BMC Remedy AR System Administration Console.
  3. Select System > General > Server Information
  4. Enter the Port and Queues information in the Server Information dialog box.
  5. For each type of thread, modify the min threads and max threads for the RPC program as listed in the following chart. Note that the queue for Loopback and CAI Thread is shared.
  6. Click OK.
  7. Open the CAI Plug-in Registry form in new mode.
  8. Create an entry with the following values:
    • Private Queue #*: 390626
    • Number of Threads*: 3
  9. Click Save.
  10. Restart the BMC Remedy AR System server for the CAI Plugin threads to take effect.

Note

CAI plug-in registry setting is a hardware configuration limitation and dependent on fast/list thread settings.

Fast and List Thread Settings

 

 ~|=

Queue Number

 ~|=

Purpose

 ~|=

No. of Threads

 ~|=

Comments

Private-RPC-Socket: 390601

PAlert Queue

1

None

Private-RPC-Socket: 390603

Escalation Queue

1

Ensure that escalations use these threads.

Private-RPC-Socket: 390620

Fast Queue

6

None

Private-RPC-Socket: 390626

Loopback Socket Queue / CAI Thread

3

Uses the same queue as CAI to share threads, so only one entry is needed. Create the entry in the CAI Plug-in Registry form with that private queue number matching number of threads.

Private-RPC-Socket: 390635

List Queue

6

Set min and max to the same number.

Following is an example of the BMC Remedy AR System Server Information screen and the CAI Plugin Registry screen. The values must match.

AR System Admin Server CAI Plugin registry screen.png

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*