Configuring AR System servers that the mid tier uses


You can add, delete, or modify information about servers that Mid Tier uses.

To add a new server

  1. In the Mid Tier Configuration Tool, click AR Server Settings.
    AR_setting.png
    The available fields are as follows:

    Setting

    Description

    Delete/Edit

    Click in the check box to select a server. To select all servers in the list, click Select All; to clear all selections in the list, click Clear All.

    AR Server Name

    The name of the AR System server that Mid Tier is using. The name must be from a server that AR System recognizes. Mid Tier must be able to resolve this server name to an IP address. Mid Tier must also be able to reach the server through the defined port or through port 111, if the server is running over the portmapper.

    Domain Name

    The domain name portion of the fully qualified server name for the AR System server.

    Use Short Name

    Specifies whether the Mid Tier always uses the short name of the AR System server. For example, serverName. This value is set by the Use Short Name check box when adding or editing an AR System server.

    AR Server Admin Password

    The specified password for an AR System account with administrator privileges. Set the Mid Tier Administration Password under the Connection Settings tab in the AR System Administration: Server Information form. (If a password has been entered for a server, asterisks appear in this column instead of the actual password characters.)

    AR Server TPC Port Number

    The port number you previously configured to access the AR System server. If you have not configured a port number, this field is blank.

    AR Server RPC

    The Remote Procedure Call (RPC) protocol number that the server will use. This number can be used for connecting to a private server. If you have not configured an RPC number, this field is blank.

    Pre-Load

    Specifies whether preloading of forms to the system's memory is enabled for the server.

    The Pre-Load is enabled only when you check the Pre-Load check box.

    Cache Update Needed

    Specifies whether you want the cache to be updated automatically.

    • ON — If you select the Perform Check check box from the Edit AR Server page.
    • OFF — If you clear the Perform Check check box from the Edit AR Server page.


    Definition Change Check Interval

    The interval (in seconds) at which cache information is automatically updated. You can specify the interval in the Definition Change Check Interval field from the Edit AR Server page.

    The default value is 86400 seconds. To change the interval, enter the new number of seconds in this field. If you do not want the cache to be updated, clear the Perform Check check box from the Edit AR Server screen.


    Enable Skins

    Specifies whether skins are enabled and made visible for form views.

  2. Click Add Server to open the Add New Server page.
    Add_server.png
  3. In the Server Name field, enter the server name (required).
    If you want to use the subset reserved field (ID 1576) in your workflow and use fully qualified domain names with relative host names, add all the variations of server name and the IP address (if it is used), for example:

    myserver
    myserver.bmc.com
    myserver.labs.bmc.com
    1.160.11.240

    For more information about reserved fields and their use, see Reserved-fields.

  4. If you want the Mid Tier to use the short name of the AR System server instead of the long name (shortName+domainName), even if the domain name is defined, select the Use Short Name check box.
    This includes use for $server$ keyword, URL generation, and so on.
    If the Use Short Name check box is cleared, the Mid Tier will always use the long name of the AR System server, even if the domain name of the AR System server is defined.
  5. Enter an administrator password, port number, and RPC number for the new server.
  6. If you want to validate the password for the server, select the Validate Password check box.
    If you select the check box and you enter the correct password, the server is added to the list of servers that Mid Tier uses. If you enter the wrong password, you cannot edit the server.
  7. To preload forms to the system's memory, select the Pre-Load check box.
  8. To change the interval (in seconds) at which cache information is automatically updated, enter the new number of seconds in the Definition Change Check Interval field. The default value is 86400 seconds.
  9. Select the Perform Check check box if you want the cache to be updated automatically at a time interval specified in the Definition Change Check Interval field value. You can also update the cache manually by clicking Sync Cache on the Cache Settings page. If the check box is:
    • Selected — The cache will be updated automatically at the interval that you specify in the Definition Change Check Interval field.
    • Cleared — The cache will not be updated automatically. If the system is in the process of flushing the cache when you clear the check box, the current cache flush will continue until that session is completed.
  10. To enable and make skins visible for form views, select the Enable Skins check box. 
  11. Click Add Server.

To edit server properties

  1. In the Mid Tier Configuration Tool, click AR Server Settings.
  2. In the Delete/Edit column, select the check box next to the server whose properties that you want to edit.

    You cannot edit the server name. To change the name of a server, delete the server and add it again with the new name. Although the interface appears to allow it, you cannot edit multiple servers at the same time.

  3. Click Edit to open the Edit AR Server page.
  4. Make the necessary changes as described in the procedure above.
  5. Click Save.

To delete one or more servers

  1. In the Mid Tier Configuration Tool, click AR Server Settings.
  2. In the Delete/Edit column of the AR Server Settings page, select the check boxes next to the servers that you want to delete.
    To select all servers, click the Select All link.
  3. Click Delete.

    If a server that you selected to delete is being used as a preference server or a home page server, you must delete it from the General Settings page before you can delete it from this list. For more information, see Configuring-general-mid-tier-settings