arcache.exe or arcache

The arcache utility executes the AR System interface that lets you update an entry in the access control cache for a user or group, and lets you distribute your change to the specified AR System servers. This program is generally used in a multiple server environment with centralized access control. The program is also used for error recovery in a single server environment.

Filters that execute on submit and modify to the User and Group forms are typically used to run this program. Changes to those forms update the local cache automatically. The filters make sure that all changes to user or group information are distributed across the system.

If the server is running on a specific port and arcache cannot obtain the port information from the portmapper, you must set the ARTCPPORT variable. For example, if the port number is 2020, type the following command at a command prompt:

set ARTCPPORT=2020

At a UNIX prompt, type:

setenv ARTCPPORT 2020

Synopsis

arcache {-U|-G}{a|d} -e entryID [-g groupList] [-i groupID]
[-c groupCategory] [-q "computedGroupQqualification"]
[-t groupType] [-lw writeLicense] [-m mailAddress] [-n name]
[-p password] [-x notifyMech] [-d] [-u authenticationAliasName]
[-H groupID] [-V overlayid]

Options

You can specify the following options in any order on the command line:

Environment

ARCONFIGDIR
(UNIX only) Specifies the directory where the ar.conf file and other AR System configuration files are stored. The arsystem script sets ARCONFIGDIR to ARSystemServerInstallDir/conf, and you should not need to change this value. However, arsystem does not modify ARCONFIGDIR if a preset value is found.

Examples

Add a user, Sam Johnson, to the access control cache of all AR System servers. Use 000000000000104 as the Request ID, samj@bmc.com as the default email address, and notifier as the default alert mechanism. The syntax is as follows:

arcache -Ua -e000000000000104 -n "Sam Johnson" -m "samj@bmc.com" -x 1

No password or group membership is specified for this user.

Add an admin user with a fixed license. The syntax is as follows:

arcache -Ua -eTEMP999 -lw 1 -n "TEMPADMIN" -p "" -g "1;"

To add a group ID, group type, and specify a computed group with a qualification, the syntax is as follows:

arcache -Ga -e000000000000106 -n "TEMPADMIN" -i 8989 -t 2 -c 2 -q "\"Administrator\" OR 'Sunnyvale'"

You can disable arcache with a setting in the AR System Administration: AR System Configuration Generic UI form. When the setting is active you can still run arcache, but it has no effect on the server, and the cache does not get flushed. For more information, see Disable-User-Cache-Utilities at Configuration-settings-C-D.