System Administration Commands                      idsconfig(1M)



NAME
     idsconfig - prepare an iPlanet Directory Server (iDS) to  be
     populated with data and serve LDAP clients

SYNOPSIS
      /usr/lib/ldap/idsconfig [-v] [-i inputconfigfile]
          [-o outputconfigfile]


DESCRIPTION
     Use the idsconfig tool to set up an iPlanet Directory Server
     (iDS). You can specify the input configuration file with the
     -i option on the command line. Alternatively, the tool  will
     prompt  the  user  for  configuration information. The input
     configuration  file is created  by  idsconfig  with  the  -o
     option on a previous run.


     The first time a server is set up, the user is prompted  for
     all  the required information.  Future installations on that
     machine can use the configuration file previously  generated
     by idsconfig using the -o option.


     The  output  configuration  file  contains   the   directory
     administrator's  password  in  clear  text. Thus, if you are
     creating an  output  configuration  file,  take  appropriate
     security precautions.


     You should back up the directory server's configuration  and
     data prior to running this command.

OPTIONS
     The following options are supported:

     -i inputconfigfile     Specify the file name for  idsconfig
                             to  use  as  a  configuration  file.
                             This file will be read by idsconfig,
                             and  the values  in the file will be
                             used to configure  the  server.   Do
                             not  manually edit inputconfigfile.
                             The inputconfigfile  is  only  par-
                             tially   validated,   as   idsconfig
                             assumes that the file was created by
                             a  previous  invocation  of the com-
                             mand.


     -o outputconfigfile    Create a configuration file.





SunOS 5.11          Last change: 18 Oct 2001                    1






System Administration Commands                      idsconfig(1M)



     -v                      Verbose output.


OPERANDS
     The following operands are supported:

     inputconfigfile     Name of configuration file for  idscon-
                          fig to use.


     outputconfigfile    Configuration file created  by  idscon-
                          fig.


EXAMPLES
     Example 1 Prompting the User for Input


     In the following example, the user is prompted for  informa-
     tion to set up iDS.


       example# idsconfig



     Example 2 Creating an Output Configuration File


     In the following example, the user is prompted for  informa-
     tion  to  set up iDS, and an output configuration file, con-
     fig.1, is created when completed.


       example# idsconfig -o config.1



     Example 3 Setting up iDS Using the  Specified  Configuration
     File


     In the following example, iDS is set up by using the  values
     specified  in  the configuration file, config.1. The verbose
     mode is specified, so detailed information will print to the
     screen.


       example# idsconfig -v -i config.1






SunOS 5.11          Last change: 18 Oct 2001                    2






System Administration Commands                      idsconfig(1M)



EXIT STATUS
     The following exit values are returned:

     0     Successful completion.


     >0    An error occurred.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWnisu                    
    
     Interface Stability          Evolving                    
    


SEE ALSO
     ldap(1),  ldapadd(1),  ldapdelete(1),  ldaplist(1),  ldapmo-
     dify(1),  ldapmodrdn(1),  ldapsearch(1),  ldapcachemgr(1M),
     ldapaddent(1M),       ldapclient(1M),        suninstall(1M),
     resolv.conf(4), attributes(5)


























SunOS 5.11          Last change: 18 Oct 2001                    3