Previous Topic: dbmgr UtilityNext Topic: dbmgr -dump Function—Display Database Information


dbmgr -create Function—Create a Database

The dbmgr -create function generates a new empty database. Use this function only at installation time, or when you want to create a database or PMDB. CA ControlMinder creates the database in the current directory.

Note: If you want to add user‑defined classes to the new database, first run the seclassadm utility after creating the new database.

This command has the following format:

dbmgr {-create|-c} {-c[q]|-h} [-d] [-f filename] \
[-n] [-o] [-t terminalNames] \
[-u userName [,userName...]] [-ux userName [,userName...]]\
[-v] [-w] [-k] [-n pathName]
-create|-c

Executes the database creation function of the dbmgr utility.

-c

Prompts you for whether you want to create a new database.

-cq

Creates a new database without prompting you first.

‑h

Displays the help for this function.

‑d

Prints database layout documentation. The output contains a full description of the structure and property formats used in the database.

‑f filename

Defines a file to direct output to, instead of the standard output device.

-k

Specifies to run the coexistence utility when the database creation completes.

-n pathName

(UNIX Only). Defines the full pathname of the CA ControlMinder database to back up.

When you are creating a new database, a basic class scheme is generated. When you are adding new classes to the database using the seclassadm utility, the class information is stored in a file in the database directory. To back up a specific database with its class scheme (such as a policy model database), specify its location with the -n option. The user-defined class information is taken from that location. If you do not specify the -n option, the class information file is searched for in the local directory were the database is to be created. If it is not found there, the file is taken from the active CA ControlMinder security database directory.

‑o

Adds Unicenter TNG classes to an existing database.

‑t terminalName

Defines a comma-separated list of terminals, from which the superusers can manage the local database, to create in the database.

-u userName [,userName...]

Defines a comma-separated list of users to create in the database. These users are defined as CA ControlMinder security administrators.

If the -t option is specified, these users are authorized to manage the local database from the defined terminals.

See also the -ux parameter.

-xu userName [,userName...]

Defines a comma-separated list of enterprise users to be defined as CA ControlMinder security administrators.

If the -t option is specified, these users are authorized to manage the local database from the defined terminals.

If no users are created dbmgr -create creates a user in the database that corresponds to root on UNIX, or Administrator on Windows, with the ADMIN, AUDITOR, and IGN_HOL attributes.

‑v

Disables the progress messages.

‑w

Creates a new database that includes Unicenter TNG classes.

Note: The -v and -d options cannot be used together.

Example: Create a new database on Windows

If at the system prompt c:\temp>, enter the following command:

dbmgr ‑c ‑c ‑u user1 ‑t myterminal.company.com

When you confirm that you want to create the database, the utility creates a new database in the c:\temp directory. It creates the user user1 in the database, who has the ADMIN, AUDITOR, and IGN_HOL attributes, and can administer the database from the terminal myterminal.company.com.

Example: Create a new database on UNIX

If at the \tmp\db directory, enter the following command:

dbmgr ‑c ‑cq -d -f dbLayout

The utility creates a new database in the \tmp\db directory. It also creates a file (dbLayout) that contains the database layout documentation. By default, it creates the user root in the database, and assigns it the ADMIN, AUDITOR, and IGN_HOL attributes.

More information:

eACoexist Utility—Detect and Register Coexisting Trusted Programs

seclassadm Utility—Administer CA ControlMinder Classes