seini Utility—Manage Configuration Files

Reference Guide › Utilities › seini Utility—Manage Configuration Files

seini Utility—Manage Configuration Files

Valid on UNIX

The seini utility manages CA ControlMinder database and initialization files for any host. For any host, the seini utility can do the following:

Display the path of the CA ControlMinder database
Display the path of an initialization (.ini) file
Display the contents of a token from an initialization file
Set the value of a specific token in a specific section of an initialization file
Delete a specific token from a specific section of an initialization file

The seini utility also displays all tokens in any of the other .ini files. The name of the initialization file must always end in the suffix .ini. You can work on an .ini file from any remote host as long as you have WRITE and ADMIN privileges.

If you do not specify any switch, seini displays the paths of the database and the seos.ini file.

Note: The seini utility can only update the seos.ini file when seosd is not running, or when a rule in the database specifically permits it.

seini can perform an intelligent token and section search, by including certain tokens in the seos.ini file. This feature checks for spelling errors by comparing each token or section with the one you specified until it finds an exact or partial match (within a 25% error margin). If it finds the relevant token or section, seini performs the specified operation; otherwise it displays an error message.

Note: The intelligent search feature works only on the host where you invoke the seini utility.

This command has the following format:

seini [-d] [host]

seini [-i] [host]

seini [-H host] \

{[-f [host.]section.token [ini_file]] | \
[-r [host.]section.token [ini_file]] | \
[-s [host.]section.token value [ini_file]] | \
[-sn [host.]section.token value [ini_file]]}

‑d [host]

Displays the path of the database on the remote host. If you do not specify a host, seini displays the path of the local host.

‑f [host.]section.token [ini_file]

Displays the value of the token in the section of the specified initialization file on a specified host. If seini cannot find the specified section or token, an empty line appears. You must separate the host, section, and token names with a period (.). If you do not specify the ini_file, CA ControlMinder searches the seos.ini file for the section and token. To display information about the local machine, omit the host parameter.

‑g section

Displays a list of tokens in the defined section.

-h

Displays the help for this utility.

‑H [host]

Specifies the remote host to be used with the -f, -r, -s, and -sn flags.

‑i [host]

Displays the pathname of the initialization file seos.ini. If you do not specify a host, seini displays the pathname on the local host.

‑r [host.]section.token [ini_file]

Deletes the token from the section of the initialization file in the specified host. If you do not specify the ini_file, CA ControlMinder deletes the token from the seos.ini file.

To delete information on the local machine, specify the section and token names only.

‑s [host.]section.token value [ini_file]

Sets the value of the token in the section of the initialization file in the specified host. If you do not specify the ini_file parameter, CA ControlMinder sets the value in the seos.ini file. If the section or token does not exist, and you specified a remote host, CA ControlMinder creates that section or token.

To create a section or token on the local machine, use the ‑sn switch.

‑sn [host.]section.token newValue [ini_file]

Sets the value of the token in the section of the initialization file in the specified host. If you do not specify the ini_file parameter, CA ControlMinder sets the value in the seos.ini file. If the section or token does not exist, and you specified the local host, CA ControlMinder creates that section or token.

To create a section or token on a remote machine, use the ‑s switch.

Examples: Using seini

To find out where the seos.ini initialization file is located on the local computer, use the following command:
```
seini -i
```
To find out the value of the trace configuration setting in the [seosd] section, use the following command:
```
seini ‑f seosd.trace_file
```
To set the value of the trace_to configuration setting in the [seosd] section, use the following command:
```
seini ‑s seosd.trace_to file
```
The command output should look like this:
```
The token seosd.trace_to now set to file (was file,stop)
```

selang Utility—Run the CA ControlMinder Command Line

The selang utility invokes a command shell that provides access to the CA ControlMinder database and the native environment. The database is updated dynamically by issuing selang commands from within the command shell.

Note: The result of the command's execution is sent to the standard output unless you include the ‑o option.

This command has the following format on UNIX:

selang [{-c command|-f file}] [{-d path|-p pmdb}] [-o file] [-r file] [-s] \
[-u user pass]
selang [-l] [-o file] [-r file] [-s] [-u user pass]

This command has the following format on Windows:

selang [{-c command|-f file}] [{-d path|-p pmdb}] [-o file] [-r file] [-s] [-v]
selang [-l] [-o file] [-r file] [-s] [-v]

‑c command

Specifies the selang command to execute. After selang executes the command, it exits.

If command contains any spaces, enclose the entire string in quotation marks. For example:

selang ‑c "showusr rosa"

‑d path

Specifies that selang commands update the database in the defined path.

Note: You can only specify a local database.

‑f file

Specifies that selang commands are read from the defined file rather than from the terminal's standard input.

As selang executes the commands in the input file, the line number of command being executed appears on the screen. The selang prompt does not appear on the screen. After selang executes the commands in file, it exits.

-h

Displays the help for this utility.

‑l

Specifies that selang updates the default local database, usually ACInstallDir/seosdb (where ACInstallDir is the directory where you installed CA ControlMinder).

You do not need to specify this option with -d or -p.

Note: This option replaces selang. It is only valid when seosd is not running, and only an CA ControlMinder administrator with sufficient native privileges to update the database files can execute it.

‑o file

Specifies that selang output is written in the specified file. Each time you invoke selang, it creates a new, empty file. If you specify the name of an existing file, selang writes over the information currently in the file.

‑p pmdb

Specifies that selang commands update the database of the defined PMDB, which must be in the local station (this is the database in the PMDB subdirectory). Changes to the database are not propagated to subscribers.

Note: This option is not valid if either sepmdd or seosd is running on the specified PMDB and is not the same as using the hosts command.

Important! Do not make changes that require propagation in this mode. If you use native mode when making updates, CA ControlMinder updates only the native host files (as defined in the CA ControlMinder configuration options).

‑r file

Specifies that selang reads the commands from the defined file. The file should consist of commands in normal selang syntax, separated by semicolons or line breaks. After executing the commands in file, selang prompts the user for input.

If you do not define a file for this option, selang uses the .selangrc file in your home directory.

‑s

Specifies that selang opens in silent mode, without displaying the copyright message.

‑u user pass

(UNIX only) Specifies a username and password for running selang.

To use this option, you must set the check_password token in the seos.ini file to yes; this causes CA ControlMinder to prompt you with “Enter your password” when you run selang -u. You have three attempts to login.

The token no_check_password_users in the [lang] section of the seos.ini file contains a list of users that bypass the password checking during a login to selang.

Note: If the check_password token is set to no (the default), selang does not require any passwords.

-v

(Windows only) Writes command line to output.

Usage notes:

If -h is used, all other options are ignored.
You cannot use the -c option with the -f option.
You cannot use the -d option with the -p option.
If you specify -d or -p, you do not need to specify -l.

More information:

hosts Command—Connect to a Remote CA ControlMinder Terminal