dce_config(1m) Open Software Foundation dce_config(1m)
NAME [Toc] [Back]
dce_config - Configures and starts up DCE
SYNOPSIS [Toc] [Back]
dce_config [-i] [-e environment_file] [-c command_file]
OPTIONS [Toc] [Back]
-i The -i option tells dce_config to look in the /etc directory
of the install area (which is generally /opt/dce1.0/etc) for
the component scripts it needs to run. After you have
invoked dce_config once with the -i option, you do not need
to use the option again.
-e The -e option causes dce_config to source environment_file
at startup. environment_file is a user-created file that
sets the DCE and DFS variables that specify responses to the
dce_config user prompts. Note that if you do not specify the
-e option, dce_config looks for the /etc/dce_config.conf
file and sources it if it exists. If the file does not
exist, it uses shell variable settings if they are set.
-c The -c option causes dce_config to source command_file at
startup. command_file is a user-created shell script that
initiates configuration processing.
DESCRIPTION [Toc] [Back]
The dce_config shell command invokes a menu-driven interface that
configures and starts up DCE. The dce_config command displays a
hierarchy of menus and invokes individual configuration routines
according to users' menu selections.
The configuration menu consists of initial cell configuration,
additional server configuration, and DCE client configuration. The
security server and the first CDS server constitute initial cell
configuration.
If you use specify an environment file with the -e option and a
command file with the -c option, you can completely automate
dce_config processing.
The Command File [Toc] [Back]
The command file consists of config command lines that specify the
component to configure and, for DFS, the type of server.
A sample command file, config.cmd, is provided by with the DCE source.
You can copy the file and use it as supplied or you can use it as
guide to creating your own environment file. The sample file is not
copied to the install tree during DCE installation.
Hewlett-Packard Company - 1 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
dce_config(1m) Open Software Foundation dce_config(1m)
The config lines are in the form:
config component
{
client |
gda |
sec {client | server | replica} |
cds {client | server | replica} |
dts {clerk | local | global | ntp-provider | null-provider}
dfs {client | scm | privatefs | fs | fldb}
}
Where
component Is one of the following values:
+ client-DCE client configuration
+ gda-GDA configuration
+ sec-Security configuration of any one of the following:
-- client-Security client machine
-- server-Security master server machine
-- replica-Security replica machine
+ cds-CDS configuration of any one of the following:
-- client-CDS client machine
-- server-CDS initial server machine
-- replica-Additional CDS server machines
+ dts-DTS configuration of any one of the following:
-- clerk- DTS clerk machine
-- local-DTS local server machine
-- global-DTS global server machine
Hewlett-Packard Company - 2 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
dce_config(1m) Open Software Foundation dce_config(1m)
-- ntp-provider-DTS NTP time provider machine
-- null-provider-DTS null time provider
+ dfs-DFS configuration of any one of the following:
-- client-DFS client specify
-- scm-System Control machine
-- privatefs-Private File Server machine
-- fs-File Server machine
-- fldb-File Location Database Server machine
The Environment File [Toc] [Back]
The Environment file sets the DCE and DFS variables. The file entries
are in the form:
variable=value
To change a value, simply replace it with the new value.
A sample environment file, config.env, is provided with the DCE
source. You can copy the file and use it as supplied or you can use it
as guide to creating your own environment file. The sample file is
not copied to the install tree during DCE installation.
The DCE and DFS Variables [Toc] [Back]
The table titled "dce_config Environment Variables" lists the DCE
variables you can set for dce_config processing. The table titled
"dfs_config Environment Variables" lists the DFS variables you can
set. In the tables, the term default refers to the original setting
assigned to the variable.
Table 0-0. dce_config Environment Variables
Hewlett-Packard Company - 3 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
dce_config(1m) Open Software Foundation dce_config(1m)
____________________________________________________
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.
____________________________________________________
Hewlett-Packard Company - 4 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
dce_config(1m) Open Software Foundation dce_config(1m)
CHANGE_PW Indicates whether or not
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 or not
to check client and
server clock
synchronization: y
indicates the time will
be checked; n indicates
it will not. The default
is y.
____________________________________________________
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.
____________________________________________________
Hewlett-Packard Company - 5 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
dce_config(1m) Open Software Foundation dce_config(1m)
DEFAULT_MAX_ID The highest value UNIIX
ID for principals. The
default value is
2147483646, which means
that only principals with
UNIX IDs lower than
2147483646 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 assword
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.
____________________________________________________
Hewlett-Packard Company - 6 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
dce_config(1m) Open Software Foundation dce_config(1m)
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 or not 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.
____________________________________________________
Hewlett-Packard Company - 7 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
dce_config(1m) Open Software Foundation dce_config(1m)
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 in order 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.
____________________________________________________
Hewlett-Packard Company - 8 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
dce_config(1m) Open Software Foundation dce_config(1m)
LAN_NAME For multiple LAN
configurations, the
internal name of the LAN
(in the LAN profile).
Used in CDS server
configuration.
____________________________________________________
LOGFILE The full pathname 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.
____________________________________________________
Hewlett-Packard Company - 9 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
dce_config(1m) Open Software Foundation dce_config(1m)
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
or not 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 pathname to
the Password Management
server, which is
$DCELOCAL/bin/pwd_strength.
Used in Password
Management server
configuration.
____________________________________________________
Hewlett-Packard Company - 10 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
dce_config(1m) Open Software Foundation dce_config(1m)
PWD_MGMT_SVR_OPTIONS The default option or
options for the Password
Management server
(pwd_strength). The
value of the variable is
set to -v (verbose) at
server configuration.
____________________________________________________
REMOVE_PREV_CONFIG An indication of whether
or not 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 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 the cell's master
Security server runs.
Used in security client
configuration.
____________________________________________________
SEC_SERVER_IP The IP address for server
named in SEC_SERVER.
____________________________________________________
Hewlett-Packard Company - 11 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
dce_config(1m) Open Software Foundation dce_config(1m)
SYNC_CLOCKS An indication of whether
or not 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).
____________________________________________________
Hewlett-Packard Company - 12 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
dce_config(1m) Open Software Foundation dce_config(1m)
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. |
|_____________________|_____________________________|
Table 0-0. dfs_config Environment Variables
Hewlett-Packard Company - 13 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
dce_config(1m) Open Software Foundation dce_config(1m)
________________________________________________
Variable Value
________________________________________________
AGG_FS_TYPE The type of filesystem
for the aggregate to be
exported. Possible
values are native meaning
the native file system
(e.g. UFS, JFS) or
episode meaning the
Episode (LFS) file
system.
________________________________________________
AGG_DEV_NAME The device name of the
aggregate to be exported,
________________________________________________
AGG_MOUNT_PATH The mount path for the
aggregate (e.g.
/usr/users).
________________________________________________
AGG_NAME The name to be used for
the aggregate to be
exported (e.g. user.jlw).
________________________________________________
AGG_ID The unique numerical
aggregate ID for the
exported aggregate.
________________________________________________
CACHE_SIZE_RAM The number of bytes to
use for an in-memory
cache.
________________________________________________
CACHE_SIZE_DISK The number of bytes to
use for a local disk
cache.
________________________________________________
CACHE_DIR_DISK The pathname of the
directory to use for a
local disk cache.
________________________________________________
CLIENT_CACHE_LOC An indication of whether
the cache is stored in
memory or on disk.
machine values are mem
meaning the cache is
stored in memory or disk
meaning the cache is
stored on the local
disk.
________________________________________________
Hewlett-Packard Company - 14 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
dce_config(1m) Open Software Foundation dce_config(1m)
CONFIG_NFS_GATEWAY An indication of whether
| | or not to configure the |
| | DFS client as an NFS |
| | gateway. Possible values |
| | are y and n; n is the |
| | default. |
|___________________|___________________________|
|EPI_FORMAT_PART | An indication of whether |
| | or not to format a disk |
| | partition as an Episode |
| | aggregate. Possible |
| | values are y to format |
| | the partition or n to |
| | not. |
|___________________|___________________________|
|EPI_FORCE_INIT | An indication of whether |
| | or not to force the |
| | initialization of a |
| | partition as an Episode |
| | aggregate, possibly |
| | losing data. Possible |
| | values are y or the |
| | initialization or n to |
| | not. |
|___________________|___________________________|
|INIT_LFS | An indication of whether |
| | or not to initialize the |
| | LFS (using epiinit). |
| | Possible values are y to |
| | initialize or n to not. |
|___________________|___________________________|
|LOAD_LFS_KEXT | An indication of whether |
| | or not to load the LFS |
| | kernel extensions. |
| | Possible values are y to |
| | load or n to not. |
|___________________|___________________________|
|ROOT_FILESET_NM | The name of the DFS root |
| | fileset. |
|___________________|___________________________|
|SCM_NAME | The name of the system |
| | control machine to be |
| | used during |
| | configuration. |
|___________________|___________________________|
Component Scripts [Toc] [Back]
The dce_config script calls component scripts that reside in the
/opt/dcelocal/etc directory (or in the etc directory of the install
area) with symbolic links to /etc. In a custom configuration script,
you can call the component scripts directly and supply the required
Hewlett-Packard Company - 15 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
dce_config(1m) Open Software Foundation dce_config(1m)
input via the environment variables. The names and functions of the
component scripts follows:
+ dce_shutdown-Shuts down all DCE server processes (auditd, dtsd,
cdsadv, cdsd, and secd), except for DFS processes (dfsd) via the
dcecp or other control programs. This script must be run on the
machine running the daemon processes. You must be root or
another privileged user to run the script. You should always run
the script before reconfiguring DCE.
If the dce_shutdown script cannot shut down a daemon gently, it
sends a kill signal to all the DCE daemons. If for any reason
you do not want to use a control program, you can execute the
script manually. The dce_shutdown script run with its -f option
will find and kill the DCE daemons. This behavior is the same as
that of the dce.clean script, which was included in DCE R1.0.3
and previous releases. DCE R1.1 does not include the dce.clean
script, but provides the name as a symbolic link to the
dce_shutdown script for the user's convenience.
+ dfs.clean-Kills DFS server processes. This script must be run on
the machine running the processes. It should be run before
reconfiguring DCE. (Note that some DFS daemon processes cannot
be killed by dfs.clean.)
+ dce.rm [install]-Removes all data and configuration files created
by DCE servers after initial configuration except for data and
files created by DFS servers. This script must be run on the
machine running the processes. It should be run before
reconfiguring DCE. If you invoke the script with the install
parameter, the script removes the binary files added during
installation.
+ dfs.rm [install]-Removes data and configuration files created by
DFS servers after initial configuration. This script must be run
on the machine running the processes, and dced must be running on
that machine. The dfs.rm script should be run before
reconfiguring DCE. If you invoke the script with the install
parameter, the script removes the binary files added during
installation. Note that this script invokes the dce.clean
script.
+ dce.unconfig hostname-Removes all DCE clients on hostname from
the Security and Directory service databases. It should be run
before reconfiguring a client machine.
+ dfs.unconfig hostname-Removes the DFS client on hostname from the
Security and Directory service databases. It should be run
before reconfiguring a client machine.
Hewlett-Packard Company - 16 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
dce_config(1m) Open Software Foundation dce_config(1m)
+ dce_com_env-Sets environment variables.
+ dce_config_env-Calls the dce_com_env script that sets the
environment variables.
+ dce_com_utils-Contains common functions used by dce_config and
dfs_config.
+ dce_config_utils-Contains internal routines used by dce_config
scripts.
+ dfs_config-Configures a machine as a DFS server or client.
+ rc.dce-Starts DCE daemons. This script cannot be run remotely;
it must be run on the machine on which the daemons are being
started.
+ rc.dfs-Starts DCE daemons. This script cannot be run remotely;
it must be run on the machine on which the daemons are being
started.
Privilege Required [Toc] [Back]
You must have root authority to run the dce_config command.
EXIT VALUES [Toc] [Back]
In case of an error, this command repeats requests for correct input.
The user can exit the program from any menu.
RELATED INFORMATION [Toc] [Back]
Books: OSF DCE Administration Guide
Hewlett-Packard Company - 17 -OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96 [ Back ] |
