Utility programs for Lotus Notes

The following programs are shipped with Connector Pack.

didtovault

Use the didtovault program to move ID files from the Bravura Security s DID table to a Lotus Notes ID vault. This program is installed with Bravura Security Fabric .

Usage

didtovault.exe -s <server> -t <target> -vault <vault>
               [-ai <IDfile> -ap <password>]
               [-all | -ei <longID> | -ui <longID>]
               [-r] [--retries <N>] [-verbose]

Argument	Description
-s <server> — --server <server>	The name of the Domino server containing the ID vault. (required)
-t <target> — --target <target>	The target system ID of the Domino server. (required)
-vault <vault>	Specify the name of the vault database, including relevant path information as required. For example, `IBM_ID_VAULT\vault.nsf` (required)
-ai <IDfile> — --adminfile <IDfile>	An administrator’s ID file with permission to access the Notes ID vault. Must be used in conjunction with the - -adminpass option.
-ap <password> — --adminpass <password>	The password for the administrator’s ID. Must be used in conjunction with the --adminfile option.
-all	Move all accounts; this is default behavior. This option cannot be used with --userid or --excludeid .
-ei <longID> — --excludeid <longID>	Exclude the specified account ID of a specific user in the DID table; specify an account using the longid. Use --excludeid multiple times to specify multiple users. All users that are not specified with --excludeid are processed. This option cannot be used with -all or --userid .
-ui <longID> — --userid <longID>	Move the specified account ID of a specific user in the DID table; specify an account using the longid. Use --userid multiple times to specify multiple users. Only users that are specified with --userid are processed. This option cannot be used with -all or --excludeid .
-r — --remove	Remove ID files from the DID table upon successful transfer.
--retries <N>	Specify the number of retry attempts for failed inserts. Specify a value between 0 and 1000; the default is 3.
-verbose	Write verbose output.

Examples

Move all users to the vault:

didtovault.exe -ai admin.id -ap p455w0rD -s 10.0.1.68 -t LOTUS4 -all -vault "IBM_ID_VAULT\vault.nsf" -verbose

Move specified users to the vault:

didtovault.exe -ai admin.id -ap p455w0rD -s 10.0.1.68 -t LOTUS4 -ui "CN=user1 vault/O=hrnyc" -vault "IBM_ID_VAULT\vault.nsf" -verbose

Exclude specified users from being moved to the vault:

didtovault.exe -ai admin.id -ap p455w0rD -s 10.0.1.68 -t LOTUS4 -vault "IBM_ID_VAULT\vault.nsf" -verbose -ei "CN=user1 vault/O=hrnyc"

Remove users from the DID table after a successful move:

didtovault.exe -ai admin.id -ap p455w0rD -s 10.0.1.68 -t LOTUS4 -ui "CN=user1 vault/O=hrnyc" -vault "IBM_ID_VAULT\vault.nsf" -verbose -r

Exclude specified users from being moved to the vault, then delete the successfully moved DIDs:

didtovault.exe -ai admin.id -ap p455w0rD -s 10.0.1.68 -t LOTUS4 -ei "CN=user1 vault/O=hrnyc" -vault "IBM_ID_VAULT\vault.nsf" -verbose -r

dumpdmno

The dumpdmno program is used to dump a Lotus Notes database.

Usage

dumpdmno.exe -d <server>!!<databasename> [-ai <adminfile> -ap <password>]-a <attribute> [-all][-preserve] -o <outputfilename> [--instance <instance>][-verbose]

Table 1. dumpdmno arguments

Argument	Description
-d <server>!!<database>	The server address and database name separated by !!.
-ai <adminfile>	The administrator’s Notes ID file. Provide the path to the file. Used with -ap.
-ap <password>	Administrator ID password. Used with -ai.
-a <attribute>	Used to specify an attribute to dump. You can specify multiple attributes.
-all	Used to dump all fields in the specified .nsf database.
-preserve	Preserves columns for attributes that are not found.
-o <outputfilename>	The output file to dump the database information to.
–instance <instance>	The name of the Bravura Security Fabric instance on which to run this utility to get log information. If not specified, the program looks for the default instance.
-verbose	Write a verbose dump of a table.

Examples

dumpdmno -d win2k4!!psidfile.nsf -ai c:\idfiles\admin.id -ap haikou02-o c:\tmp\domino -a UserID -a Password

nidcopy

Use the nidcopy program to check for differences between a Lotus Notes ID file on a user’s local workstation and a file in a shared folder. If there are differences, nidcopy copies the newest file and overwrites the older version. No action will occur if there are no differences between files on different locations or the shared folder is empty.

Requirements

This program is a Win32 executable and run on the Bravura Security Fabricserver.

The shared folder must have at a minimum Change and Read permissions set for "everyone".

To enable logging for this program, you must add a system environment variable, IDM_SUITE_INSTANCE, to define the instance to log; for example: IDM_SUITE_INSTANCE = default . See your operating system documentation to learn how to do this. The program will be logged in <Program Files path>\Bravura Security\Bravura Security Fabric\Logs\<instance> idmsuite.log.