these are NOT generic install instructions. They are a step-by-step guide to
making ldapdns work for you.

let me say first: you will be happiest if you use a package (preferably,
building it yourself). rpm -e ldapdns is a whole lot easier than the alternative
but if need be, ldapdns doesn't create any special libraries, using the
default install:
	rm -f /usr/local/bin/ldapaxfr-conf
	rm -f /usr/local/bin/ldapdns-conf
	rm -f /usr/local/bin/ldapaxfr
	rm -f /usr/local/bin/ldapdns
	rm -rf /var/lib/ldapdns
then remove ldapdns from your startup scripts. don't know how to do that? go
get an operating system with packages that I support, or find someone to help.

------------------------------------------------------------------------------


1. type "make"

2. decide how you want to run ldapdns;

	DAEMONTOOLS		- installing ala djb.
	REDHAT			- how to create .rpm packages
	DEBIAN			- how to create .deb packages
	SOLARIS			- why there aren't any .pkg packages
	BSDISH			- how to get running on a *BSD or slackware
	UNIXISH			- for all other unixes
	WINDOWS			- why there isn't a windows build procedure

DAEMONTOOLS

if you're a user of other djb software, you'll want daemontools support.

3. "make install"

4. use ldapdns-conf to create the service

5. link the service using ln -s /path/to/ldapdns/dir /service/ldapdns

6. that's it! ldapdns should startup within 5 seconds. use this time to
   make ldapdns useful by giving it the password to the directory. It goes
   in $ROOT/root/password

now go read README.configure


REDHAT

think redhat means linux?
you may want to go get RPM's for your system. if you want to build your own,
then these instructions will still be helpful.

3. STOP RIGHT HERE. go read README.using-rpm

4. create /var/lib/ldapdns/root/password - put your LDAP password in here
   if appropriate

5. are you going to accept AXFR/TCP requests?
   create /var/lib/ldapdns/axfr with the appropriate access controls.
   there's a sample one in sample/axfr
   then type:
	chkconfig --add ldapaxfr

6. okay, you did that? now type:
	chkconfig --add ldapdns

now go read README.configure


DEBIAN

3. STOP RIGHT HERE. go read README.using-debian

4. create /var/lib/ldapdns/root/password - put your LDAP password in here
   if appropriate

5. add /etc/init.d/ldapdns to the appropriate runlevels (usually 2)

6. if you're going to accept AXFR/TCP requests, also add /etc/init.d/ldapaxfr
   to the appropriate runlevels and edit /var/lib/ldapdns/axfr

if nothing worked, you didn't read README.using-debian -- I do not know what
I am doing here. I have gotten many requests for debian support, so I gave up
20 minutes of my day to cobble together a debian package.

if you have too many problems, use the regular UNIXISH instructions below.

but if everything is okaay: go read README.configure


SOLARIS (and other systems using .pkg)

i cannot yet help you create solaris PKG files. the truth is that
I simply do not know how. i don't own any functioning sparcs, and I have
way too much respect for the x86 systems that I do have to run something
as slow and cruddy as solaris on them.

i am aware that openbsd/freebsd/netbsd also support packages similar to
these packages used by solaris. I do not know how they are the same and
how they are different.

however, if ultralinux turns you off, then you may want to investigate
how to do this. my UNIXISH guide (See below) should get you started.


BSDISH (openbsd, freebsd, slackware)

this is not as easy as you might think.  I highly recommend that
all users of a bsdish system use djb's daemontools.

3. "make install"

4. take a good hard look at what I've created in sysvinit/. Add what you
think is appropriate to your /etc/rc* scripts.

5. copy the sample configuration script into /etc/ldapdns.conf
   -- they're in sample/ldapdns.conf -- check it for configuration details

6. create your $ROOT directory. the default is /var/lib/ldapdns

7. create /var/lib/ldapdns/root/password - put your LDAP password in here
   if appropriate

8. are you going to accept AXFR/TCP requests?
   create /var/lib/ldapdns/root/axfr with the appropriate access controls.
   there's a sample one in sample/axfr

9. cross your fingers... reboot your system.

this procedure requires more thinking than any other. bsdish startup scripts
are awful, and anyone who says that they think they like them has never tried
to maintain more than a handful of systems _or_ tried to build an installer for
those systems.

now go read README.configure



UNIXISH (hp-ux, aix, etc)

don't like djb? or just afraid?
no matter. ldapdns is flexible even if you are not.

you can use ldapdns with a standardish unixish system.


3. "make install"

4. copy the sysvinit/* into /etc/init.d/

5. copy the sample configuration script into /etc/ldapdns.conf OR
   /etc/sysconfig/ldapdns (whichever is appropriate) -- they're in
   sample/ldapdns.conf -- check it for configuration details

6. create your $ROOT directory. the default is /var/lib/ldapdns

7. create /var/lib/ldapdns/root/password - put your LDAP password in here
   if appropriate

8. are you going to accept AXFR/TCP requests?
   create /var/lib/ldapdns/root/axfr with the appropriate access controls.
   there's a sample one in sample/axfr

9. link /etc/init.d/ldapdns into the appropriate runlevels for starting,

this procedure will require modifications based on your unix. not all unix
are created equal.

now go read README.configure


WINDOWS

i'm not going to dignify this with real instructions. come on now, you use
your system because you think your systems are easy to use?

if someone were to port ldapdns to windows, I would probably be disappointed.
Your efforts could have been better spent elsewhere.

with that said: if someone does infact someday get ldapdns to build under
windows, I will welcome patches.



i welcome binary packages (solaris, RPM's, dpkg, zips, etc).
i also welcome ldapdns being included in a binary-only distribution. feel free
to contact me regarding details/changes needed for YOUR binary distribution.


