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)
```