Diff for /admin/quickstart.sdf between versions 1.1 and 1.2

version 1.1, 1999/05/01 20:11:03 version 1.2, 1999/05/02 23:19:23
Line 9  simple and quick way to get started only Line 9  simple and quick way to get started only
 seriously, you should read the rest of this guide.  seriously, you should read the rest of this guide.
   
   
 ^ {{B:Get the software}}. {{I:Slapd}} is part of the OpenLDAP distribution, which  ^ {{B:Get the software}}.
   . {{I:Slapd}} is part of the OpenLDAP distribution, which
 you can retrieve using this URL:  you can retrieve using this URL:
 .  
 .{{CMD[jump="ftp://ftp.openldap.org/pub/OpenLDAP/openldap-release.tgz"]ftp://ftp.openldap.org/pub/OpenLDAP/openldap-release.tgz}}  ..{{URL: ftp://ftp.openldap.org/pub/OpenLDAP/openldap-release.tgz}}
 .  
 .If you are reading this guide, you have probably already done this.  .If you are reading this guide, you have probably already done this.
 .    
   
 + {{B:Untar the distribution}}. Pick a place for the LDAP source to live, cd  + {{B:Untar the distribution}}. Pick a place for the LDAP source to live, cd
 there, and untar it. For example:  there, and untar it. For example:
 .  
 .{{EX: cd /usr/local/src}}  .{{EX: cd /usr/local/src}}
 .{{EX: gunzip -c openldap-release.tgz | tar xvfB -}}  .{{EX: gunzip -c openldap-release.tgz | tar xvfB -}}
 .{{EX: cd ldap}}  .{{EX: cd ldap}}
 +{{B: Configure the software}}.  
 .  + {{B: Configure the software}}.
 .You will have to edit two files to configure things for your site.  . You will have to edit two files to configure things for your site.
 .  
 .{{EX: vi Make-common}}  .{{EX:vi Make-common}}
 .{{EX:vi include/ldapconfig.h.edit}}  .{{EX:vi include/ldapconfig.h.edit}}
 .  
 .Read the comments in Make-common and configure things  
 .appropriately. If you have the Berkeley DB package installed, or the  
 .GDBM package, you should set the LDBMBACKEND variable  
 .accordingly. Otherwise, the defaults should be OK to get you started.  
 .  
 .In the include/ldapconfig.h.edit file, be sure to set the DEFAULT_BASE  
 .and LDAPHOST variables to something appropriate for your site.  
 .Other than that, the defaults should work OK.  
   
   . Read the comments in Make-common and configure things
   appropriately. If you have the Berkeley DB package installed, or the
   GDBM package, you should set the LDBMBACKEND variable
   accordingly. Otherwise, the defaults should be OK to get you started.
   
   . In the include/ldapconfig.h.edit file, be sure to set the DEFAULT_BASE
   and LDAPHOST variables to something appropriate for your site.
   Other than that, the defaults should work OK.
   
   + {{B:Install the software}}.
   . From the top level LDAP source directory, type:
   
 +{{B:Install the software}}. From the top level LDAP source directory,  
 type:  
 .  
 .{{EX: su}}  .{{EX: su}}
 .{{EX: make install}}  .{{EX: make install}}
 .  
 .Examine the output of this command carefully to ensure everything is  
 .installed properly.  
 .  
   
   . Examine the output of this command carefully to ensure everything is
   installed properly.
   
   
   + {{B:Make a configuration file}}.
   . Create a file called myslapd.conf and
   enter the following lines into it. See Section 5 for more details on this
   file.
   
 +{{B:Make a configuration file}}. Create a file called myslapd.conf and  
 .enter the following lines into it. See Section 5 for more details on this  
 .file.  
 .  
 .{{EX:referral ldap://ldap.openldap.org}}  .{{EX:referral ldap://ldap.openldap.org}}
 .{{EX:database ldbm}}  .{{EX:database ldbm}}
 .{{EX:suffix "o=<YOUR ORGANIZATION>, c=US"}}  .{{EX:suffix "o=<YOUR ORGANIZATION>, c=US"}}
 .{{EX:rootdn "cn=<YOUR NAME>, o=<YOUR ORGANIZATION>, c=US"}}  .{{EX:rootdn "cn=<YOUR NAME>, o=<YOUR ORGANIZATION>, c=US"}}
 .{{EX:rootpw secret}}  .{{EX:rootpw secret}}
 .  
 .Be sure to replace "<YOUR ORGANIZATION>" with the name of your  
 .organization and "<YOUR NAME>" with your name. If you are not in  
 .the US, replace "US" with your two-letter country code. The rootdn  
 .and rootpw lines are only required if later you want to easily add or  
 .modify entries via LDAP.  
 .  
   
   .Be sure to replace "<YOUR ORGANIZATION>" with the name of your
   organization and "<YOUR NAME>" with your name. If you are not in
   the US, replace "US" with your two-letter country code. The rootdn
   and rootpw lines are only required if later you want to easily add or
   modify entries via LDAP.
   
   + {{B:Create a database}}.
   . This is a two-step process. Step A is to create
   a file (we'll call it myldif) containing the entries you want your database
   to contain. Use the following example as a guide, or see Section 7.3 for
   more details.
   
 +{{B:Create a database}}.  This is a two-step process. Step A is to create  
 .a file (we'll call it myldif) containing the entries you want your database  
 .to contain. Use the following example as a guide, or see Section 7.3 for  
 .more details.  
 .  
 .{{EX:dn: o=<YOUR ORGANIZATION>, c=US}}  .{{EX:dn: o=<YOUR ORGANIZATION>, c=US}}
 .{{EX:o: <YOUR ORGANIZATION>}}  .{{EX:o: <YOUR ORGANIZATION>}}
 .{{EX:objectclass: organization}}  .{{EX:objectclass: organization}}
Line 83  type: Line 82  type:
 .{{EX:sn: <YOUR LAST NAME>}}  .{{EX:sn: <YOUR LAST NAME>}}
 .{{EX:mail: <YOUR EMAIL ADDRESS>}}  .{{EX:mail: <YOUR EMAIL ADDRESS>}}
 .{{EX:objectclass: person}}  .{{EX:objectclass: person}}
 .  
 .You can include additional entries and attributes in this file if you want,  .You can include additional entries and attributes in this file if you want,
 .or add them later via LDAP.  or add them later via LDAP.
 .  
 .Step B is to run this file through a tool to create the slapd database.  .Step B is to run this file through a tool to create the slapd database.
 .  
 .{{EX:$(ETCDIR)/ldif2ldbm -f myslapd.conf -i myldif}}  .{{EX:$(ETCDIR)/ldif2ldbm -f myslapd.conf -i myldif}}
 .  
 .Where myslapd.conf is the configuration file you made in step 6, and  
 .myldif is the file you made in step 7A above. By default, the database  
 .files will be created in /usr/tmp. You may specify an alternate directory  
 .via the directory option in the slapd.conf file.  
 .  
   
   .Where myslapd.conf is the configuration file you made in step 6, and
   myldif is the file you made in step 7A above. By default, the database
   files will be created in /usr/tmp. You may specify an alternate directory
   via the directory option in the slapd.conf file.
   
   + {{B:See if it works}}.
   . You can use any LDAP client to do this, but our
   example uses the ldapsearch tool.
   
 +{{B:See if it works}}.You can use any LDAP client to do this, but our  
 .example uses the ldapsearch tool.  
 .  
 .{{EX:ldapsearch -h 127.0.0.1 -b 'o=<YOUR ORGANIZATION>, c=US' 'objectclass=*'}}  .{{EX:ldapsearch -h 127.0.0.1 -b 'o=<YOUR ORGANIZATION>, c=US' 'objectclass=*'}}
 .  
 .This command will search for and retrieve every entry in the database.  . This command will search for and retrieve every entry in the database.
 .Note the use of single quotes around the filter, which prevents the "*"  Note the use of single quotes around the filter, which prevents the "*"
 .from being interpreted by the shell.  from being interpreted by the shell.
 .  
 .You are now ready to add more entries (e.g., using {{I:ldapadd}}(3) or  . You are now ready to add more entries (e.g., using {{I:ldapadd}}(3) or
 .another LDAP client), experiment with various configuration options,  another LDAP client), experiment with various configuration options,
 .backend arrangements, etc. Note that by default, the {{I:slapd}} database  backend arrangements, etc. Note that by default, the {{I:slapd}} database
 .grants {{EX:READ}} access to everybody. So if you want to add or modify  grants {{EX:READ}} access to everybody. So if you want to add or modify
 .entries over LDAP, you will have to bind as the rootdn specified in the  entries over LDAP, you will have to bind as the rootdn specified in the
 .config file (see Section 5.2.2), or change the default access control  config file (see Section 5.2.2), or change the default access control
 .(see Section 5.3).  (see Section 5.3).
 .  
   
   
 The following sections provide more detailed information on making,  The following sections provide more detailed information on making,
 installing, and running slapd.  installing, and running slapd.
   
 PB:  
   
   

Removed from v.1.1  
changed lines
  Added in v.1.2


______________
© Copyright 1998-2020, OpenLDAP Foundation, info@OpenLDAP.org