.TA p
.TH pddcesetup 1M
.SH NAME
.C pddcesetup
\- configure DCE for the HPDPS
.SH SYNOPSIS 
.C     pddcesetup 
[
.C force
]

.SH DESCRIPTION

The 
.C pddcesetup
command
is used to configure DCE information for the HP Distributed Print Service
(HPDPS).

pddcesetup must be run on each HP-UX host in your DCE cell that
will execute the HPDPS in the Extended Environment.  If a host will run the
HPDPS in the Basic Environment only, not in the Extended Environment, then
execution of
.C pddcesetup
is not needed on that host.  If you do not intend to
execute the HPDPS in a DCE cell, or do not wish to use DCE services in
conjunction with the HPDPS, then each host must execute the HPDPS in the
Basic Environment, and execution of
.C pddcesetup
is not needed on any of the hosts in your network.
.C pddcesetup
must be executed once on each host in your DCE cell that will execute an
HPDPS client daemon, spooler, or supervisor in the Extended Environment.
.C pddcesetup
must be executed before starting any of these HPDPS components on that
host.

The first time that
.C pddcesetup
executes in your DCE cell, it will prompt for and create various DCE
security identities and CDS namespace entries that are then configured
for the entire cell.  On subsequent executions of
.CR pddcesetup ,
only local information needed by the local host is configured; the DCE
security identities and CDS namespace entries have already been created
for the cell.

If the parameter
.C force
is given, then 
.C pddcesetup 
will give you the option
to fully recreate security identities and CDS directories.  This option is
useful if DCE has been only partially configured, or if configuration is
accidentally removed after creation.  If the 
.C force
parameter is not
given, then 
.C pddcesetup
quickly checks to see if it appears the DCE
information has already been configured, and if so, 
.C pddcesetup
does not attempt to configure any of this information.

The host on which 
.C pddcesetup
is executed must already be configured as a DCE client or server, using DCE
command-line utilities or the SAM program.  You must also be DCE logged in
using an account with sufficient administrator privileges to modify DCE
security and namespace information.  The DCE login of the cell
administrator for your cell is normally used for this purpose (the default
DCE login name is
.CR cell_admin ).
.pp

The HPDPS DCE information created by
.C pddcesetup
is:

.nf
     o Accounts adm_user and pd_server.

     o Principals adm_user and pd_server.

     o Groups pd_admin and pd_operator.

     o CDS namespace directories and links.

     o Initial Access Control List entries.

     o Local key table entries for principal pd_server.
.fi
.SH EXAMPLE

An example execution follows.  This example illustrates the execution of
pddcesetup for the first time in a DCE cell.

.nf
\# pddcesetup

Checking whether your host is configured in a DCE cell.

Verifying your DCE login.
You are DCE logged in as <your login>.

Checking whether HPDPS security identities have already been configured
in your cell.

DCE security identities needed for the HPDPS have not yet been
configured in your DCE cell.  The security identities that must be
configured are:

     Accounts   adm_user and pd_server
     Principals adm_user and pd_server
     Groups     pd_admin and pd_operator

Are you ready to configure these identities now (y/n)? y

The new groups and accounts about to be created must be members of a DCE
"organization".  You may use an existing organization if you have
already defined one.

Do you wish to create a new DCE organization (y/n)? y
Please enter the name of the new organization: <organization name>

Creating organization <organization name>.

Creating group pd_admin.

Creating group pd_operator.

Creating principal pd_server.

Creating principal adm_user.

Adding new principals to groups and organizations.

pddcesetup is ready to create DCE accounts pd_server and adm_user.  To
accomplish this, you must enter the password for the DCE account under
which you are currently logged in.  If not entered correctly, an attempt
to create the new accounts will generate the error message "data
integrity error".

Please enter the password for your current DCE login account: <password>

Please choose a unique password for new account adm_user.  This account
will be used by HPDPS administrators.

Please enter the password for account adm_user: <password>
Please re-enter the password for account adm_user: <password>

Creating account adm_user.

Please choose a unique password for the pd_server account. This password
is used by the HPDPS client daemon, spooler, and supervisor to
automatically DCE login to account pd_server.

Please enter the password for account pd_server: <password>
Please re-enter the password for account pd_server: <password>

Creating account pd_server.

Creating HPDPS directories and links in the DCE CDS namespace.

Creating initial HPDPS Access Control List entries.

Adding entry for pd_server to the local key table.

pddcesetup: DCE setup is complete.
.fi

.SH SEE ALSO
dce_config(1M), dce_login(1M)
.br
.I HP Distributed Print Service Administration Guide
.\"
.\" toc@\f3pddcesetup(1M)\f1@@@configure DCE for the HP Distributed Print Service
.\" 
.\" index@\f1pddcesetup \- configure DCE for the HP Distributed Print Service@@@\f3pddcesetup(1M)\f1
.\"
