This documentation supports the 21.05 version of BMC Helix ITSM. To view an earlier version, select the version from the Product version menu.

Configuring the appquery plugin for a private RPC server queue


To assist with improving performance, you can create a private RPC server queue and configure the appquery plugin to support it.

To create a private RPC server queue

  1. In the AR System Administration Console, select System > General > Server Information >Ports and Queues.
  2. Use the private RPC program number from one of the following ranges (for example, 390685):
    • 390621 - 390634
    • 390636 - 390669
    • 390680 - 390694

      Important

      Refer to the list of private RPC queues that are already created in the Ports and Queues tab and ensure that the selected RPC program number is not already in use.

  3. Change Min Threads to 4 and Max Threads to 6.
    You can configure Min Threads and Max Threads based on server load and the number of concurrent users. Use the preceding values to start. An administrator can tune these parameters later, depending upon the server load.
  4. Click Apply.
  5. Confirm that the ar.cfg contains the RPC program number that you just added:
    1. Open the ar.cfg file by using a text editor. The default path for ar.cfg is C:\Program Files\BMC Software\ARSystem\Conf\ar.cfg.
    2. Verify the RPC program number that you just added (for example, 390685) in the ar.cfg file.
    3. If the corresponding changes are not reflected, add them manually in the text editor:

      arcfg.png


To configure the appquery (conquery) plugin

  1. Stop the AR System server.
  2. Open the pluginsvr_config.xml file.
    The default path for this file is C:\Program Files\BMC Software\ARSystem\pluginsvr\ pluginsvr_config.xml.
  3. Change the Private-RPC-Socket value which the same as the RPC program number in step 3 of the previous procedure.

    <plugin>

         <name>REMEDY.ARDBC.APPQUERY</name>

         <type>FilterAPI</type>

         <code>JAVA</code>

         <filename>C:\Program Files\BMC Software\ARSystem\pluginsvr\qry\conquery.jar</filename>

         <classname>com.bmc.itsm.conquery.ardbc.conquery.Query</classname>

         <pathelement type="location">C:\Program Files\BMC Software\ARSystem\pluginsvr\qry\conquery.jar</pathelement>

         <pathelement type="location">C:\Program Files\BMC Software\ARSystem\pluginsvr\foundation_shared\ITSMCommonUtils.jar</pathelement>

         <pathelement type="path">C:\Program Files\BMC Software\ARSystem\pluginsvr\qry</pathelement>

         <userDefined>

           <server_name>vw-pun-asp-pr20</server_name>

           <server_port>0</server_port>

           <Private-RPC-Socket>390685</Private-RPC-Socket>

         </userDefined>

      </plugin>

     <plugin>
  4. Restart the AR System server.
  5. Verify the private RPC queue:
    1. In the AR System Administration Console, and select System > General > Server Information.
    2. Select the Port and Queues tab.


 

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