PreviousNext

The dce_config Environment Variables

The following table lists the environment variable names and their values. In the table, the term default refers to the setting assigned to the environment variable by OSF.


dce_config Environment Variables

Variable Value
CACHE_CDS_SERVER The name of the CDS server to cache. It is not required that the cached server be the initial CDS Server. Used during CDS client configuration.
CACHE_CDS_SERVER_IP The IP address of the CDS server to cache.
CELL_ADMIN The principal name of the initial privileged user of the registry database (known as the registry creator). Used during Security server configuration.
CELL_ADMIN_PW The default password assigned to the accounts created when the registry database is created, including the account for the registry creator. The default is -dce-.
CELL_NAME The name of the cell (without the .../) on which the configuration is being performed. Used during Security server configuration
CHANGE_PW Indicates whether dce_config displays Password; must be changed on exiting when the cell administrator password (CELL_ADMIN_PW) is the same as the default password. The default is n. It is recommended that you do not change this value in order to help ensure that the cell administrator is not assigned a commonly known password. This variable is used in conjunction with the DEFAULT_PW variable.
CHECK_TIME Specifies whether to check client and server clock synchronization: y indicates the time will be checked; n indicates it will not. The default is y. If you execute dce_config from a here file, set CHECK_TIME to n since time checking uses a Telnet command that causes input from the here file to be lost. Note that dce_config do not recognize time zones. If you are configuring a cell across time zones, set CHECK_TIME to n
DC_DISPLAY_THRESHOLD Specifies the messages to write to stdout. Possible values are ERROR, WARNING, SUMMARY, DETAIL, VERBOSE, and DEBUG. The default is SUMMARY.
DC_LOG_THRESHOLD Specifies the minimum priority log messages to write to the log file, /tmp/dce_config.log. Possible values are ERROR, WARNING, SUMMARY, DETAIL, VERBOSE, and DEBUG. The default is DEBUG.
DEFAULT_MAX_ID The highest value UNIIX ID for principals. The default value is 32767, which means that only principals with UNIX IDs lower than 32767 can access the cell. It is recommended that you accept the default. Used during Security Server configuration.
DEFAULT_PW Contains the default password used when the registry is created. This variable is used to determine if the cell administrator's password (CELL_ADMIN_PW) is the same as the default password. When the user exits dce_config, the value of DEFAULT_PW and CELL_ADMIN_PW are checked. If they are the same and if the CHANGE_PW variable is set Y, dce_config issues the warning message Password must be changed. The default for this variable is -dce-. If your site has a commonly used and known password, change the DEFAULT_PW variable to that password to help ensure that the cell administrator account is not assigned a commonly known password
DIR_REPLICATE Controls the replication of CDS directories when an additional CDS server is being created at DCE configuration time. The value y will cause dce_config to prompt for more directories to replicate; n will not. The default is n.
DO_CHECKS Controls the display of three prompts. The first is whether the Press <RETURN> to continue, CTRL-C to exit: prompt is returned when dce_config encounters a non-fatal error. This prompt forces the user to acknowledge the error and offers a way to exit dce_config. The second and third prompt occur during master Security server configuration. They prompt for a UNIX ID number at which the Security server will start assigning automatically generated group UNIX IDs and principal UNIX IDs. If this prompt is turned off, the default is the default described in the DEFAULT_MAX_ID and GID_GAP variables. For the DO_CHECKS variable, y displays the prompt; n does not. The default is y.
EXIT_ON_ERROR An indication of whether or not dce_config will exit in the event of a fatal error: y indicates that dce_config exits when it encounters a fatal error; n indicates it will not. The default is n. Setting this variable to Y OR N can help prevent a here file from getting out of sync with dce_config.
GID_GAP The increment above highest currently used GID at which the Security service will start assigning automatically generated GIDs. The value of this variable is used with the LOW_GID variable to set the starting point for UIDs automatically assigned by the Security server. Default is 100. Used in Security server configuration.
HOST_NAME_IP The IP address of node on which dce_config is running.
KEYSEED A character string used to seed the random key generator to create the master key for the master and each slave database. Each database has its own master key and thus keyseed. Used in Security server configuration
LAN_NAME For multiple LAN configurations, the internal name of the LAN (in the LAN profile). Used in CDS server configuration.
LOGFILE The full path name of the log file produced by dce_config. The default is /tmp/dce_config.log
LOW_GID The value at which the Security server will start assigning automatically generated group IDs. The default is the value of the highest group ID currently used on the machine being configured, incremented by the value of GID_GAP. Although there is no restriction that the value of LOW_GID must be higher than the machine's highest group ID, if you supply a LOW_GID that is less than or equal to the highest currently used group ID, dce_config issues a warning message and prompts the user to reenter LOW_GID. Used in master Security server configuration.
LOW_UID The value at which the Security Server will start assigning automatically generated UNIX IDs. The default is the value of the highest UNIX ID currently used on the machine being configured, incremented by the value of UID_GAP. Although there is no restriction that the value of LOW_UID must be higher than the machine's highest UNIX ID, if you supply a LOW_UID that is less than or equal to the highest currently used UNIX ID, dce_config issues a warning message and prompts the user to reenter LOW_UID. Used in master Security server configuration.
MULTIPLE_LAN An indication of whether to configure the node with multiple LAN capabilities: y indicates configure with multiple LAN capabilities, n indicates do not. Used in CDS configuration.
NTP_HOST The name of the host on which the NTP time provider server is running. Used in DTS Time Provider configuration.
PWD_MGMT_SVR The default path name to the Password Management server, which is $DCELOCAL/bin/pwd_strength. Used in Password Management server configuration.
PWD_MGMT_SVR_OPTIONS The default options for the Password Management server (pwd_strength). The value of the variable is set to -v (verbose) at server configuration.
REMOVE_PREV_INSTALL An indication of whether to remove all remnants of previous DCE installations before performing the new install: y indicates remove all remnants; n indicates do not. Be aware that if you set this variable to y, dce_config will automatically remove all installed components each time you install any component, and you must reinstall them all. Used in all component installations.
REMOVE_PREV_CONFIG An indication of whether to remove all remnants of previous configurations before performing the new configuration: y indicates remove all remnants; n indicates do not. Be aware that if you set this variable to y, dce_config will stop and remove all configured components each time you configure any component, and you must reconfigure them all. Used in all component configurations.
REP_CLEARINGHOUSE The name for new clearinghouse. Used in additional CDS server configuration.
SEC_SERVER The name of the machine on the cell's master Security server runs. Used in security client configuration.
SEC_SERVER_IP The IP address for server named in SEC_SERVER.
SYNC_CLOCKS An indication of whether to synchronize all client clocks with the Security server clock: y indicates that client and server clocks will be synchronized; n indicates they will not. If this variable is set to n, and clocks are out of sync by more than the value specified in the TOLERANCE_SEC variable, the user is prompted for whether or not to synchronize them. This variable is valid only if the CHECK_TIME variable is set to y. For DFS machine configurations, this variable should be set to y.
TIME_SERVER Specifies the host that the Security client will try to synchronize its clock against. This host must have a DTS server (dtsd) running on it. The recommended choice for the host is the one running the master Security server (the name specified in the SEC_SERVER variable).
TOLERANCE_SEC The number of seconds a client system clock can differ from the Security server system clock before either the user prompted to synchronize clocks or clocks are synchronized automatically. The default is 120 seconds. Both the Security service and the CDS service require that be no more than a 5-minute difference between the clocks on any two nodes in a cell. For a DFS File Location Database Server, the variable should not be set to less than 90 seconds.
UID_GAP The increment above highest currently used UID at which the Security service will start assigning automatically generated UIDs. The value of this variable is used with the LOW_UID variable to set the starting point for UIDs automatically assigned by the Security server. Default is 100. Used in Security server configuration.
UNCONFIG_HOST_PRESET The name of the node to be unconfigured. Used with the unconfigure option.