How can I configure multiple C plugin servers?

Version 2
    Share This:

    This document contains official content from the BMC Software Knowledge Base. It is automatically updated when the knowledge article is modified.


    PRODUCT:

    Remedy AR System Server


    COMPONENT:

    AR System Server


    APPLIES TO:

    ARSystsm 7.6.04 Sp2 , 8.x, 9.x



    QUESTION:

    I need to setup a new C plugin server to run a specific plugin.  How can I do that?


    ANSWER:

    From the documentation for 7.6.04 SP2, the following instructions will apply to 7.6.04 SP2, 8.x, and 9.x
     

    Support for multiple plug-in server

    You can configure plug-ins (out-of-the-box and user-defined) to run on multiple plug-in servers. To use this feature, load out-of-the-box plug-ins and user-defined plug-ins in different plug-in servers. 

    To configure multiple plug-in servers, you must add a plug-in server instance and configure the server to use plug-ins.  
    NOTE
    You are not required to use multiple plug-in servers for BMC Remedy AR System.
    However, BMC recommends you configure multiple plug-in servers to increase the server availability and to identify a plug-in issue, if an issue occurs.
      
    To configure multiple plug-in servers, you must add a plug-in server instance and 
    configure the server to use plug-ins.  
    NOTE
    The feature is available only for C plug-ins, not Java plug-ins.
      
    Adding a new plug-in server instance
    To add a new instance of plug-in server, add an entry in the armonitor.conf or 
    armonitor.cfg file. For example:  
    “<ARSystemServerInstallDir>\arplugin.exe” --unicode -i "<ARSystemServerInstallDir>" -p <portNumber> -m 
    The plug-in server instance uses the specified port number.  
      ■ If you do not specify a port number, the plug-in server uses either the port number specified in the ar.conf or ar.cfg file, or uses a portmapper, if applicable. 
      
      ■ If you specify an incorrect port number, the plug-in server does not start and a server start-up error (ARERR 8798) is updated in the arerror.log file. 
      
    A new error number (ARERR 8798) has been added to BMC Remedy AR System. The following message appears when you use an invalid plug-in port number in the armonitor.conf or armonitor.cfg file. 
    ARERR 8798 - AR Plugin Server Startup Error - Invalid Plugin Port 

    Configuring a plug-in server to use the new plug-ins
    Perform the following steps to configure the plug-in server. 

    To configure a plug-in server to use plug-ins
    1 Specify the port number of the new plug-in server instance with the plug-in file name in the ar.conf or ar.cfg file. For example,  
    Plugin: VendorForm7604_build002.dll;9092
      
    If you do not specify a port number, the plug-in loads by using the default plug-in server (the port number specified in the ar.conf or ar.cfg file, or by using a portmapper). 

    2 Define an alias name for the new plug-in server in the following format:  
    Server-Plugin-Alias: aliasName realName hostName[:portNumber]
    For example:  
    Server-Plugin-Alias: ARSYS.ARDBC.QA.QAVENDORFORM ARSYS.ARDBC.QA.QAVENDORFORM iBMC-BJKV7BS.adprod.bmc.com:9092
       
      By default, the alias name should be the plug-in original name. If you do not specify an alias name, the plug-in is not available for use and ARERR 8755 error occurs.  
      
    After you configure multiple plug-in servers, following log file changes occur. 

    A new log file is generated for each new plug-in server instance. For example:  
      ■ arplugin.log (for default plug-in server) 
      
      ■ 9092_arplugin.log (for non-default plugin server —<portNumber>_arplugin.log) 
      
    Every plug-in log file contains an entry to specify its associated port number and process ID. There might be multiple plug-in server processes with same name in multiple plug-in server environments. The process ID helps to identify the process associated with a particular plug-in server  instance. For example:  
    Plug-In Server Port: 9092 Process ID: 6272  

     


    Article Number:

    000129715


    Article Type:

    FAQ/Procedural



      Looking for additional information?    Search BMC Support  or  Browse Knowledge Articles