manageinv

Use the manageinv program to add, remove, and update inventory items.

manageinv may be used to import assigned and unassigned inventory items from RSA Authentication Manager 7.1/8.2 and Vasco IDENTIKEY Server target systems.

Usage

manageinv [-nooverwrite] -add -id <itemID> -type <type> -location <location> [-user <userID>] [-notes "<notes>"] [-target <target>] [-state <state>] [-desc "<description>"]

manageinv -rm -id <itemID> -type <type>

manageinv -rm [-type <type>] | [-location <location>] | [-user <userID>] | [-target <target ID>]

manageinv -add|-rm [<arguments>] -f <filename>

manageinv -add|-rm -target <target> -type <type> -location <location> [-state <state>] -listfile <filename>

Commands are defined using the following arguments:

Argument	Description
-add	Adds inventory items to the database, or updates existing entries.
-rm	Removes inventory items from the database.
-nooverwrite	Checks if the item being added to the inventory already exists or not. If the item already exists then the record is not updated.
-id <ItemID>	The item ID in Bravura Identity .
-type <type>	The type as defined in Bravura Identity . The <type> must be entered in uppercase; for example, -type TOKEN.
-loc <location>	The location as defined in Bravura Identity .
-user <userID>	The ID of the user assigned to the item.
-notes <notes>	Information to be read by Bravura Identity users. Must be enclosed in double quotes.
-desc <description>	Optional description of the item.
-state <state>	The state of the item (see list of available states below).
-target <target ID>	Bravura Security Fabric target system the item belongs to. The <target ID> must be entered in upper case; for example, -target RSAAM.
-f <textfile>	Uses a file listing inventory items to be acted upon. See Adding multiple items.
-listfile <textfile>	Uses a list file from an inventory type target system for items assigned to users or from a listing file generated by listunassigned for unassigned items. See Adding multiple items.

Adding a single item

To add a single item, the item’s ID, type, and location are required. For example:

manageinv -add -id 0000000111 -type TOKEN -loc NY

Optional arguments include:

[-state <state> | -desc <description> | -notes ‘‘<notes>'' | -user <user> |  -target <target>]

Adding multiple items

To add multiple items, either the -f or -listfile options may be specified. Specifying the -f option: When using -f, only this option is required. For example:

manageinv -add -f items.txt

The text file must be in the format:

itemid type location state description notes user target

Where <state> can be any of:

N - Available
V - In stock
R - Reserved
U - Undelivered
A - Assigned
O - Outstanding
P - Approved purchase
o - Ordered
D - Permanently damaged
L - Lost/Stolen
r - In repair
d - Disposed
T - In transit to user
C - Received by user

Use "" for any blank fields. For example, the following text file row adds an unassigned item:

00000000111 TOKEN CALGARY A "rsa token" "Notes for Calgary token" "" TOKEN1

If you specify any of the values for -type, -location, -user, -notes, or -target, those values can be skipped in the text file. For example, if you use the options:

-add -type TOKEN -notes "" -f items.txt

then the text file would be in the format:

itemid location user target

Specifying the -listfile option

When using the -listfile option, the -target, -type, and -loc options are also required.

The -listfile option uses the <target>.db listing file from an inventory type target system to add items that are assigned to users (such as for RSA Authentication Manager 7.1/8.2 or for Vasco IDENTIKEY Server).

For example:

After setting up an RSA Authentication Manager 7.1/8.2 target system, run auto discovery. Use the resulting list file to populate the Inventory items list with the assigned tokens:

manageinv -add -target RSAAM -type TOKEN -loc NY -state A -listfile ..\psconfig\RSAAM.db

The listing file for unassigned items may also be used to add items from a listing file generated by listunassigned .

For example:

To populate the Inventory items list with unassigned tokens from the target system, use the listunassigned program to get a list:

listunassigned.exe -targetid RSAAM

This writes a list of available tokens to a file, RSAAM-unassigned.db in the \<instance>\psconfig\ directory.

Populate the Inventory items list:

manageinv -add -target RSAAM -type TOKEN -loc NY -state N -listfile ..\psconfig\RSAAM-unassigned.db

Removing a single item

To remove a single item, -id and -type are required. For example:

manageinv -rm -id 00000000111 -type TOKEN

Removing multiple items using criteria

You can use any combination of -type, -location, -user, or -target to remove all items with those values. For example:

manageinv -rm -type TOKEN -loc NY

The list files may also be used to remove items found in those files. For example:

manageinv -rm -target RSAAM -type TOKEN -loc NY -listfile ..\psconfig\RSAAM.db

manageinv -rm -target RSAAM -type TOKEN -loc NY -listfile ..\psconfig\RSAAM-unassigned.db

Removing multiple items using a file

To remove multiple items, only the -f option is required. For example:

manageinv -rm -f items.txt