This documentation supports the 9.1 version of Remedy Action Request System.

To view the latest version, select the version from the Product version menu.

Configuration form

The UDM:Config regular form contains connection details for the Atrium Integrator repository and Atrium Integrator engine. The repository is created when the AR System server is installed, and the parameters are configured with default settings from the AR System server. The settings are stored in the UDM:Config form fields and can be modified by users with AR System administrator level access. 

You need to update the UDM:Config form if you are performing one of the actions listed below:

ActionDetails
Configure UDM in a server group

A server group environment consists of two or more servers that share the same database and are designated as part of a server group.
Server groups are designed to provide failover operations for crucial operations. They can also provide scalability and load balancing.

Notes:

  • Before configuring the UDM:Config form for a server group environment, you must rank the Atrium Integrator servers
    by using the AR System Server Group Operation Ranking form. If you assign ranking 1 to a server, that server becomes primary
    server and runs the jobs. If the primary server fails, the secondary server (failover server) runs the jobs. Failover server is the server
    to which you assigned ranking 2. If you do not assign ranking to the servers in a server group environment, jobs run on the server which
    receives the request first. For details, see Setting failover rankings for servers and operations
  • BMC recommends you to select a non-user facing server (admin server) as a primary server.
Configure UDM in a non-server group environment

In a non-server group environment, a single server exists. In case of server failure, jobs stop running.

Note: You need not rank the single server by using the AR System Server Group Operation Ranking form.

Restore the database

When you perform database restore, the data might contain references to the production server which may not be applicable
in the new upgrade environment. In this case, you have to update the server name references. For details,
see Updating the destination server names after migration

Note: Update the Atrium Integrator Server Name field in the UDM:Config form when you restore the database.  

Note

After updating the UDM:Config form, You must restart the AR System server for the changes to take effect. 

UDM:Config form

Updating the UDM:Config form

The UDM:Config form includes the following sections:

SectionFields
Repository Connection Details
  • Private RPC Program Number — A private RPC queue for all operations (such as, load and save) on the repository.
    The default value is 0 for no private RPC queue.
  • API Timeout Normal (seconds) — The API time for all operations (such as, load and save) on the repository. The default value is 7200 seconds.
Atrium Integrator Engine Connection Details

Update the fields in this section if you are configuring UDM in a server group or a non-server environment.
For details, see

Updating the Atrium Integrator Engine Connection Details 

FieldDescriptionServer group environmentNon-server environment
Atrium Integrator Server Name

The name of the server hosting the Atrium Integrator. By default this is the AR System server name.

Note: BMC recommends you not to use server alias name, host name, and IP addresses.

Even when you select a server in the Atrium Integrator Engine Server Name which is not ranked 1 in the AR System Server Group Operation Ranking form, the system runs the jobs on the server which is ranked 1. 

The server name mentioned in the Atrium Integrator Engine Server Name must match with the value specified in the Server-Connect-Name parameter in the ar.cfg form.

As a single server exists in a non-server environment, the Atrium Integrator jobs run on the single server.

The server name mentioned in the Atrium Integrator Engine Server Name must match with the value specified in the Server-Name parameter in the ar.cfg form.

Host 

The host name assigned to the server hosting the Atrium Integrator server. By default, this is the AR System server host name.

The Host name mentioned in the UDM:Config form must match with the diserver or carte server host name mentioned in the armonitor.cfg form.

As an example, you can see the AR server name mentioned in the armonitor.cfg file below.

The recommendation is same for server group and non-server environment .

Failover Server NameThe failover server is the server which is ranked as 2 in the AR System Server Group Operation Ranking form. The failover server substitutes the primary server in case of an outage or a failure and the system runs the jobs on the failover server.
  • You need not select or enter the server name in this field.
  • BMC recommends you to enable the diserver or carte plugin in the armonitor.cfg file for all the servers existing in your server group environment. When a primary server fails, the jobs can run on the secondary server if the diserver or carte plugin is enabled for the secondary server. 
  • Even if you select or enter a failover server name in the UDM:Config form, the system overwrites this name and considers the server ranked as 2 on the AR System Server Group Operation Ranking form.
There is no failover server in the non-server environment. In case of server failure, jobs stop running.
Is Default

This field indicates if the server name specified in the Atrium Integrator Server Name field is the default server.

  • After ranking the servers in the server group, the Is Default check box in the UDM:Config form is automatically selected for the server which is ranked as 1 in the AR System Server Group Operation Ranking form.
  • If the primary server fails, the failover server starts running the jobs. In such instances, the system automatically updates the Is Default value for the failover server. When the primary is up, the system updates the Is Default field value for the primary server.

The field value set to Yes by default.

PortThe server port assigned to the Atrium Integrator server.The default port value must be 20000.The default port value must be 20000.

Example: Configuring UDM in a server group environment 

The below graphics display the settings in the UDM:Config form for the 3 AR servers existing in your server group environments:

Server 1Server 2Server 3
  • In the above example, jobs always run on the primary server NEWSC-PD-AR-01. Even if you trigger the jobs from the secondary or a third server, the jobs always run on the primary server.  
  • In the above example, the diserver or carte plugin is enabled for all the 3 servers.

Related topics

armonitor.conf or armonitor.cfg

Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Doug Blair

    Couple questions about this page:

    1.  The above screen shot does not match the product shipped with 9.1, which includes a default checkbox and a failover server field. I assume a server goes in there but is it an AR server or an AI server?
    2. What is the difference between the "name of the server hosting the Atrium Integrator" and the "host name assigned to the server hosting the Atrium Integrator server?"  And should these be short server names or FQDN's?
    3. In an AR server group, how many records should be in this form? One per AR server or just one for the server on which AI runs? Should there be additional records if the server group may be reached by multiple public aliases (e.g "remedy.company.com" and the local alias of just "remedy")
    4. Are the RPC Number and API timeout fields required to have a value (e.g. 0 or 7200) even if it is the default?

    Thanks!

    Doug 

    Jun 15, 2016 07:09
  2. Sirisha Dabiru

     Hi Doug Blair,

    I am updating the UDM:Config form graphic and the description of the fields. Will get back to you soon with the updated info and answers to your questions.

    Regards,

    Sirisha

     

    Murali Viswanathan

    Jun 16, 2016 12:34
  3. Bhupendra Rajpurohit

    Any updates on points 3 & 4 as asked by Doug blair ?

    Regards,

    Bhupendra

    Jan 12, 2017 06:30
  4. Jan Sierens

    The text on the screenshot server 1,2,3 seems to be unreadable (too small).

    "Atrium Integrator Server Name" and "host" are not necessarily the same; can you provide more generic examples?

    Any updates on the questions posed by Doug points 3 & 4 ?

    Apr 16, 2018 04:44