This documentation applies to the 8.1 version of Remedy Action Request System, which is in "End of Version Support."

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

Setting log files options

Use the Log Files tab from the AR System Administration: Server Information form to set one or more of the log files. BMC Remedy AR System creates log files or forms containing information about system activity.

After being activated, logging starts immediately. You can activate logging at any time.


Do not keep logging turned on continuously. Log files can consume increasing amounts of disk space as messages accumulate unless you limit the log file size. Monitor your disk resources carefully while logging is active. After you activate logging for workflow objects, logs are created for only those workflow objects that are processed after that activation.

Note: This does not apply to the Always On Logging feature, as this feature stores a very limited amount of information in the memory at any given time.

Location of the log files

On the Log Files tab, the default location for log files is:

  • (Windows) ARSystemInstallDir\Arserver\Db
  • (UNIX) ARSystemInstallDir/db

You can enter a different location. You can also specify the same location and file for multiple types of logging so that all data is logged to a single file.

Log forms considerations

If you choose to log activity to a form, you can query the log form like any other BMC Remedy AR System form.

During server installation, all the predefined log forms are imported into the ARSystemInstallDir\AR SystemserverName\ARServer\SystemForms\en directory. The definition file names begin with LogForm. They are treated as system forms and are recovered from this definition file whenever the AR System server restarts.

Each supported log type has a separate form, and a common form (AR System Log: ALL) accommodates all types of logging information. You can specify whether the information should be logged to a specific form or the common form.

The log forms are identified with their reserved fields. This enables administrators to rename the forms at any time using BMC Remedy Developer Studio. Request IDs can be used to sort the log entries when troubleshooting.

The following options in the AR System server configuration file help identify the forms to which information is being logged:

Types of logs

The following table lists the types of logs you can create.

Types of logs

Type of log


Default file name

Default form name


Logs information about all API calls made by all clients.
This information is logged on entry and exit of every API call.


AR System Log: API


Logs information about escalation activity.
This information includes the escalations that executed, whether the escalation qualification found any matches, and any escalation actions taken.


AR System Log: Escalation


Logs information about filter activity for each operation.
This information includes the filters that tried to execute and all filter actions performed.


AR System Log: Filter


Logs SQL commands sent to the database.
This information is logged for each SQL command issued, including a time stamp and the user name of the user performing the operation.


AR System Log: SQL


Logs information about threads being started and restarted on the server.


AR System Log: Thread


Logs information about connection activity for each user.
This information includes whether the user can obtain a license and when each floating license is released. This enables you to keep an audit trail of user activity to help you determine whether you need more floating licenses.


AR System Log: User


Logs detailed information about user registration and about the generation and delivery of alerts.


AR System Log: Alert

Full Text Index

Logs information about full text search indexer activity.


AR System Log: Full Text Index

Server Group

Logs information about server group activity.
Records information about the starting and stopping of operations, the evaluation of other servers, and the timing of each event.


AR System Log: Server Group


On UNIX systems, logs all arforkd activity (a process that reduces the amount of memory an AR System server uses when forking new processes).
This file is not subject to the maximum file size specified in the Maximum Log-File Size field.


No form is created for arforkd.


If you are licensed for Distributed Server Option (DSO), logs information about DSO server activity. See BMC Remedy Distributed Server Option logging.


No form is created for DSO.

Plug-In Server

Logs the events of plug-ins that AR System uses. For more information about plug-ins, see Enabling Plug-ins.


No form is created for the plug-in server.

For more information, see Analyzing logs.

To set log files or forms

  1. In a browser, open the AR System Administration Console, and click System > General > Server Information.
    The AR System Administration: Server Information form appears.
  2. Click the Log Files tab.

    AR System Administration: Server Information form — Log Files tab (for BMC Remedy AR System version 8.1, 8.1 Service Pack 1, and 8.1 Service Pack 2)
    (Click the image to expand it.)

    AR System Administration: Server Information form — Log Files tab (from BMC Remedy AR System version 8.1 Service Pack 2 hot fix 201501221220)

    (Click the image to expand it.)

  3. Select the check box next to each log that you want to create.
  4. Select the type of log to create: File or Form.


    When the Form option is selected, various LogFiles.txt are created under the ar_install_dir/bin directory on UNIX. Because this behavior is as designed, you must provide read-write access to the ar_install_dir/bin directory to make sure that this functionality works correctly.

  5. In the Name field, specify the full path to the log file or the name of the form.


    When naming log files, do not use special characters such as a forward slash (tick) or a question mark (question) . Use alphanumeric characters only.

  6. To view a log file or form for any selected log, click View.
    Log forms are opened in the Search mode.
  7. Edit the other options, as needed: 

    Log Files tab fields

    Field Name


    DSO Log LevelSpecifies the level of logging for Distributed Server Option (DSO). The options are:
    • Error — Only error messages.
    • Warning — Error and warning messages.
    • Info — Status, error, and warning messages

    Plugin Log Level

    Specifies the level of logging for the plug-in server. The options are:

    • All — All log information. The default value is 100.
    • Finest — Code-level information. The default value is 400.
    • Finer — Logs tasks as they are executed within the system. The default value is 500.
    • Fine — Internal exceptions. The default value is 600.           
    • Config — Configuration, status, severe, and warning messages. The default value is 700.
    • Info — Status, severe, and warning messages. The default value is 800.
    • Warning — Severe and warning messages. The default value is 900.
    • Severe — Only severe messages. The default value is 1000.
    • Off — None. The default value is 10000.

    Log-File Creation

    Defines how logs are created. The options are

    • Create Backup — Creates new log files, and the contents of the previous log files are written to logName.bak files.
    • Append to Existing — Log files and their contents are preserved, and new information is appended to them.

    Client-Side Logging Group

    Defines the group that can use logging options in AR System clients. Logging options are disabled for users who are not members of this group. For more information about client logging, see Enabling logs.

    Maximum Log-File Size (byte)

    Defines the maximum size (in bytes) for the log file. A value of 0 (the default) specifies no limit. Except for 0, the log file size cannot be set to less than 4096. When the log file reaches the maximum, new information wraps to the top of the file, overwriting the old information. If you do not specify a maximum size limit, you run the risk of running out of disk space on your system. This setting does not apply to the arforkd.log file.

    Maximum BackupsDefines the maximum number of backup (.bak) log files to be allowed when the log file reaches the Maximum Log-File Size value and a new log file is created. By default, the number of backup log files allowed is 1, and the maximum number of backup log files allowed is 999.

    Buffer Logged Lines

    Buffers logged lines instead of having them immediately written to disk. Selecting this option decreases the impact to AR System performance when logging is enabled. See Buffering log output.

    Log Per Thread

    Creates per-thread log files. Selecting this option decreases the impact to AR System performance when logging is enabled. See Thread log.

    In-Memory Log Size (byte)

    (Only applicable from BMC Remedy AR System version 8.1 Service Pack 2 hot fix 201501221220)

    Defines the in-memory log size (in bytes). The default size of the file is 5 MB. If you set the value to 0 MB, this feature is turned off.

    For more information, see Always On Logging.

    Dump to File

    (Only applicable from BMC Remedy AR System version 8.1 Service Pack 2 hot fix 201501221220)

    Click Dump to File to save the Always On Logging (AOL) logs to a file. A pop-up window displays the path and the file name in which the information is saved. The file in which this information is saved is decided by the AR System server.

    Note: Saving the information to the file flushes the current contents of the in-memory logging.

    For more information, see Always On Logging.

  8. Click Apply.

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.