1these are NOT generic install instructions. They are a step-by-step 2guide to making ldapdns work for you. 3 4let me say first: you will be happiest if you use a package (preferably, 5building it yourself). rpm -e ldapdns is a whole lot easier than the 6alternative but if need be, ldapdns doesn't create any special 7libraries, using the default install: 8 rm -f /usr/local/bin/ldapaxfr-conf 9 rm -f /usr/local/bin/ldapdns-conf 10 rm -f /usr/local/bin/ldapaxfr 11 rm -f /usr/local/bin/ldapdns 12 rm -rf /var/lib/ldapdns 13then remove ldapdns from your startup scripts. don't know how to do 14that? go get an operating system with packages that I support, or find 15someone to help. 16 17------------------------------------------------------------------------------ 18 19 201. type "make" 21 222. decide how you want to run ldapdns; 23 24 DAEMONTOOLS - installing ala djb. 25 REDHAT - how to create .rpm packages 26 DEBIAN - how to create .deb packages 27 SOLARIS - why there aren't any .pkg packages 28 BSDISH - how to get running on a *BSD or slackware 29 UNIXISH - for all other unixes 30 WINDOWS - why there isn't a windows build procedure 31 32DAEMONTOOLS 33 34if you're a user of other djb software, you'll want daemontools support. 35 363. "make install" 37 384. use ldapdns-conf to create the service 39 405. link the service using ln -s /path/to/ldapdns/dir /service/ldapdns 41 426. that's it! ldapdns should startup within 5 seconds. use this time to 43 make ldapdns useful by giving it the password to the directory. It 44 goes in $ROOT/root/password 45 46now go read README.configure 47 48 49REDHAT 50 51think redhat means linux? 52you may want to go get RPM's for your system. if you want to build your 53own, then these instructions will still be helpful. 54 553. STOP RIGHT HERE. go read README.using-rpm 56 574. create /var/lib/ldapdns/root/password - put your LDAP password in 58 here if appropriate 59 605. are you going to accept AXFR/TCP requests? 61 create /var/lib/ldapdns/axfr with the appropriate access controls. 62 there's a sample one in sample/axfr 63 then type: 64 65 chkconfig --add ldapaxfr 66 676. okay, you did that? now type: 68 69 chkconfig --add ldapdns 70 71now go read README.configure 72 73 74DEBIAN 75 763. STOP RIGHT HERE. go read README.using-debian 77 784. create /var/lib/ldapdns/root/password - put your LDAP password in 79 here if appropriate 80 815. add /etc/init.d/ldapdns to the appropriate runlevels (usually 2) 82 836. if you're going to accept AXFR/TCP requests, also add 84 /etc/init.d/ldapaxfr to the appropriate runlevels and edit 85 /var/lib/ldapdns/axfr 86 87if nothing worked, you didn't read README.using-debian -- I do not know 88what I am doing here. I have gotten many requests for debian support, so 89I gave up 20 minutes of my day to cobble together a debian package. 90 91if you have too many problems, use the regular UNIXISH instructions 92below. 93 94but if everything is okaay: go read README.configure 95 96 97SOLARIS (and other systems using .pkg) 98 99i cannot yet help you create solaris PKG files. the truth is that I 100simply do not know how. i don't own any functioning sparcs, and I have 101way too much respect for the x86 systems that I do have to run something 102as slow and cruddy as solaris on them. 103 104i am aware that openbsd/freebsd/netbsd also support packages similar to 105these packages used by solaris. I do not know how they are the same and 106how they are different. 107 108however, if ultralinux turns you off, then you may want to investigate 109how to do this. my UNIXISH guide (See below) should get you started. 110 111 112BSDISH (openbsd, freebsd, slackware) 113 114The information that follows this, is old, and largely inaccurate. 115The recommended way to install on a *BSD powered box, is to simply use 116the BSD ports system. Simply put; 117 118 $ cd /usr/ports/dns/ldapdns 119 $ make 120 $ make install clean 121 122Now that wasn't so hard. Was it?. For more information, and the ldapdns 123listing on FreeBSD, in the ports search. 124 125 ...and now for the old, dated, inaccurate info: 126 127this is not as easy as you might think. I highly recommend that 128all users of a bsdish system use djb's daemontools. 129 1303. "make install" 131 1324. take a good hard look at what I've created in sysvinit/. Add what you 133 think is appropriate to your /etc/rc* scripts. 134 1355. copy the sample configuration script into /etc/ldapdns.conf -- 136 they're in sample/ldapdns.conf -- check it for configuration details 137 1386. create your $ROOT directory. the default is /var/lib/ldapdns 139 1407. create /var/lib/ldapdns/root/password - put your LDAP password in 141 here if appropriate 142 1438. are you going to accept AXFR/TCP requests? 144 create /var/lib/ldapdns/root/axfr with the appropriate access 145 controls. there's a sample one in sample/axfr 146 1479. cross your fingers... reboot your system. 148 149this procedure requires more thinking than any other. bsdish startup 150scripts are awful, and anyone who says that they think they like them 151has never tried to maintain more than a handful of systems _or_ tried to 152build an installer for those systems. 153 154now go read README.configure 155 156 157 158UNIXISH (hp-ux, aix, etc) 159 160don't like djb? or just afraid? 161no matter. ldapdns is flexible even if you are not. 162 163you can use ldapdns with a standardish unixish system. 164 165 1663. "make install" 167 1684. copy the sysvinit/* into /etc/init.d/ 169 1705. copy the sample configuration script into /etc/ldapdns.conf OR 171 /etc/sysconfig/ldapdns (whichever is appropriate) -- they're in 172 sample/ldapdns.conf -- check it for configuration details 173 1746. create your $ROOT directory. the default is /var/lib/ldapdns 175 1767. create /var/lib/ldapdns/root/password - put your LDAP password in 177 here if appropriate 178 1798. are you going to accept AXFR/TCP requests? 180 create /var/lib/ldapdns/root/axfr with the appropriate access 181 controls. there's a sample one in sample/axfr 182 1839. link /etc/init.d/ldapdns into the appropriate runlevels for 184 starting, 185 186this procedure will require modifications based on your unix. not all 187UNIX are created equal. 188 189now go read README.configure 190 191 192WINDOWS 193 194i'm not going to dignify this with real instructions. come on now, you 195use your system because you think your systems are easy to use? 196 197if someone were to port ldapdns to windows, I would probably be 198disappointed. Your efforts could have been better spent elsewhere. 199 200with that said: if someone does infact someday get ldapdns to build 201under windows, I will welcome patches. 202 203 204i welcome binary packages (solaris, RPM's, dpkg, zips, etc). i also 205welcome ldapdns being included in a binary-only distribution. feel free 206to contact me regarding details/changes needed for YOUR binary 207distribution. 208