summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJohn Terpstra <jht@samba.org>2005-03-08 06:23:08 +0000
committerGerald W. Carter <jerry@samba.org>2008-04-23 08:46:15 -0500
commit272a5fed7c430a52a518b6ee79691e1f0392d017 (patch)
tree10475463c7a077192236bec347cfb010cec2d191 /docs
parent459cb9757597a45b570419fd22256721f949af9f (diff)
downloadsamba-272a5fed7c430a52a518b6ee79691e1f0392d017.tar.gz
samba-272a5fed7c430a52a518b6ee79691e1f0392d017.tar.bz2
samba-272a5fed7c430a52a518b6ee79691e1f0392d017.zip
Another update.
(This used to be commit 1eff25295974361516f740a2ed3bf5317a3063ac)
Diffstat (limited to 'docs')
-rw-r--r--docs/Samba-Guide/Chap02-SimpleOfficeServer.xml2
-rw-r--r--docs/Samba-Guide/Chap03-TheSmallOffice.xml4
-rw-r--r--docs/Samba-Guide/Chap08b-MigrateNW4Samba3.xml195
-rw-r--r--docs/Samba-Guide/Chap12-Appendix.xml9
-rw-r--r--docs/Samba-Guide/index.xml3
-rw-r--r--docs/Samba-Guide/preface.xml2
6 files changed, 202 insertions, 13 deletions
diff --git a/docs/Samba-Guide/Chap02-SimpleOfficeServer.xml b/docs/Samba-Guide/Chap02-SimpleOfficeServer.xml
index 19ea7ef902..89aedf2cac 100644
--- a/docs/Samba-Guide/Chap02-SimpleOfficeServer.xml
+++ b/docs/Samba-Guide/Chap02-SimpleOfficeServer.xml
@@ -945,7 +945,7 @@ C:\WINDOWS: regedit ME-dpwc.reg
<para><indexterm>
<primary>Red Hat Linux</primary>
</indexterm>
- The new server will run Red Hat Linux 9.0. You should install Samba-3.0.12 and
+ The new server will run Red Hat Fedora Core2. You should install Samba-3.0.12 and
copy all files off the old system to the new one. The existing Windows NT4 server has a parallel
port HP LaserJet 4 printer that is shared by all. The printer driver is installed on each
workstation. You must not change anything on the workstations. Mr. Meany gave instructions to
diff --git a/docs/Samba-Guide/Chap03-TheSmallOffice.xml b/docs/Samba-Guide/Chap03-TheSmallOffice.xml
index e96dbbdac3..da8013a476 100644
--- a/docs/Samba-Guide/Chap03-TheSmallOffice.xml
+++ b/docs/Samba-Guide/Chap03-TheSmallOffice.xml
@@ -792,8 +792,8 @@ $rootprompt; ps ax | grep winbind
14295 ? S 0:00 /usr/sbin/winbindd -B
</screen>
The <command>winbindd</command> daemon is running in split mode (normal) so there are also
- two instances of it. For more information regarding winbindd, see <emphasis>TOSHARG</emphasis>, Chapter 20,
- Section 20.3. The single instance of <command>smbd</command> is normal.
+ two instances of it. For more information regarding winbindd, see <emphasis>TOSHARG</emphasis>,
+ Chapter 22, Section 22.3. The single instance of <command>smbd</command> is normal.
</para></step>
<step><para>
diff --git a/docs/Samba-Guide/Chap08b-MigrateNW4Samba3.xml b/docs/Samba-Guide/Chap08b-MigrateNW4Samba3.xml
new file mode 100644
index 0000000000..fa97121bb5
--- /dev/null
+++ b/docs/Samba-Guide/Chap08b-MigrateNW4Samba3.xml
@@ -0,0 +1,195 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+ "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+
+ <!-- entities files to use -->
+ <!ENTITY % global_entities SYSTEM '../entities/global.entities'>
+ %global_entities;
+
+]>
+
+<chapter id="nw4migration">
+ <title>Migrating NetWare 4.11 Server to Samba-3</title>
+
+ <para>
+ Novell is a company any seasoned IT manager has to admire. Since the acquisition of
+ the SuSE Linux company, the acquisition on Ximian, and other moves that are friendly
+ to the FLOSS (Free-Libre/Open Source Software) movement, Novell are emerging out of
+ a deep regression that almost saw the company disappear into obscurity.
+ </para>
+
+ <para>
+ This chapter was contributed by Kristal Sarbanes, a UNIX administrator of many
+ years who surfaced on the Samba mailing list with a barrage of questions, and who
+ regularly now helps other administrators to solve thorny Samba migration questions.
+ </para>
+
+ <para>
+ One wonders how many NetWare servers remain in active service. Many are being migrated
+ to Samba on Linux. SUSE Linux Enterprise Server 9 is an ideal target platform to which
+ a NetWare server may be migrated. The migration method of choice is much dependant on
+ the tools that the administrator finds most natural to use. The old-hand NetWare guru
+ will likely want to use the tools that are part of the Mars_NWE (Martin Stovers NetWare
+ Emulator) open source package. The MS Windows administrator will likely make use of the
+ NWConv utility that is a part of Windows NT4 Server, while the die-hard UNIX administrator
+ will have a natural inclination to use the NetWare NLM for <command>rsync</command> to
+ migrate files from the NetWare server to the Samba server. Whatever your tool of choice,
+ migration will be filled with joyous and challenging moments - though probably not
+ concurrently.
+ </para>
+
+ <para>
+ This chapter tells its own story, so ride along, ... maybe the information here presented
+ will help to smooth over a similar migration that may be required in your favorite
+ networking environment.
+ </para>
+
+<sect1>
+ <title>Introduction</title>
+
+ <para>
+ Kristal Sarbanes was recruited by Abmas Inc. to administer a network that had
+ not received much attention for some years and was much in need of a make-over.
+ As a brand-new sysadmin to this company, she inherited a very old Novell file server,
+ and came with a determination to change things for the better.
+ </para>
+
+ <para>
+ A site survey turned up the following details for the old NetWare server:
+ </para>
+
+ <simplelist>
+ <member><para>200 MHz MMX processor</para></member>
+ <member><para>512K RAM</para></member>
+ <member><para>24 GB disk space in RAID1</para></member>
+ <member><para>Novell 4.11 patched to service pack 7</para></member>
+ <member><para>60+ users</para></member>
+ <member><para>7 network-attached printers</para></member>
+ </simplelist>
+
+ <para>
+ The company had outgrown this server several years ago and were dealing with
+ severe growing pains. Some of the problems experienced were:
+ </para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Very slow performance</para>
+ </listitem>
+ <listitem>
+ <para>Available storage hovering around the 5% range.</para>
+ <itemizedlist>
+ <listitem>
+ <para>Extremely slow print spooling.</para>
+ </listitem>
+ <listitem>
+ <para>
+ Users storing information on their local hard
+ drives, causing backup integrity problems.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </itemizedlist>
+
+ <para>
+ At one point disk space had filled up to 100% causing the payroll database
+ to become corrupt. This caused the accounting department to be down for over
+ a week and necessitated deployment of another file server. The replacement
+ server was created with very poor security and design considerations from
+ a discarded desktop PC.
+ </para>
+
+ <sect2>
+ <title>Assignment Tasks</title>
+
+ <para>
+ Kristal tells her own story in the following words:
+ </para>
+
+ <para>
+ After presenting a cost-benefit report to management, as well as an estimated
+ cost and time-to-completion, approval was given procede with the solution
+ proposed. The server was built from purchased components. The total expense
+ was $3000. A brief description of the configuration follows:
+ </para>
+
+ <simplelist>
+ <member>
+ <para>3.0 GHz P4 Processor</para>
+ </member>
+ <member>
+ <para>1 GB RAM</para>
+ </member>
+ <member>
+ <para>120 GB SATA operating system drive</para>
+ </member>
+ <member>
+ <para>4 x 80 GB SATA data drives configured in a RAID5 array to give a total of about 240 GB usable space</para>
+ </member>
+ <member>
+ <para>2 x 80 GB SATA removable drives for online backup</para>
+ </member>
+ <member>
+ <para>A DLT drive for asynchronous offline backup</para>
+ </member>
+ <member>
+ <para>SUSE Linux Enterprise Server 9</para>
+ </member>
+ </simplelist>
+
+
+ </sect2>
+</sect1>
+
+<sect1>
+ <title>Dissection and Discussion</title>
+
+ <para>
+ A decision to use LDAP was made even though I know nothing about LDAP except that
+ I had been reading the book <quote>LDAP System Administration</quote>, by Gerald Carter.
+ LDAP seemed to provide some of the functionality of Novell's e-Directory Services
+ and would provide centralized authentication and identity management.
+ </para>
+
+ <para>
+ Building the LDAP database took a while, and a lot of trial and error. Following
+ LDAP System Administration's guidance, I installed OpenLDAP (from RPM later I compiled
+ a more current version from source) and built my initial LDAP tree.
+ </para>
+
+ <sect2>
+ <title>Technical Issues</title>
+
+ <para>
+ The very first challenge was to create a company white-pages, followed by manually
+ entering everything from the printed company diretory. This used only the inetOrgPerson
+ objectclass from the OpenLDAP schemas. The next step was to write a shell script which
+ would look at the <filename>/etc/passwd</filename> and <filename>/etc/shadow</filename>
+ files on our mail server, and create a LDIF file from which the information could be
+ imported into LDAP. This would allow use of LDAP for Linux authentication, IMAP, POP3,
+ and SMTP.
+ </para>
+
+ </sect2>
+
+</sect1>
+
+<sect1>
+ <title>Implementation</title>
+
+ <para>
+ </para>
+
+ <sect2>
+ <title>NetWare Migration Using LDAP Backend</title>
+
+ <para>
+ </para>
+
+ </sect2>
+
+</sect1>
+
+</chapter>
+
diff --git a/docs/Samba-Guide/Chap12-Appendix.xml b/docs/Samba-Guide/Chap12-Appendix.xml
index fc3f44a523..1b13d63ce5 100644
--- a/docs/Samba-Guide/Chap12-Appendix.xml
+++ b/docs/Samba-Guide/Chap12-Appendix.xml
@@ -925,37 +925,31 @@ objectClass: organization
dc: INETDOMAIN
o: ORGNAME
description: Posix and Samba LDAP Identity Database
-structuralObjectClass: organization
dn: cn=Manager,dc=INETDOMAIN,dc=TLDORG
objectClass: organizationalRole
cn: Manager
description: Directory Manager
-structuralObjectClass: organizationalRole
dn: ou=People,dc=INETDOMAIN,dc=TLDORG
objectClass: top
objectClass: organizationalUnit
ou: People
-structuralObjectClass: organizationalUnit
dn: ou=Computers,dc=INETDOMAIN,dc=TLDORG
objectClass: top
objectClass: organizationalUnit
ou: Computers
-structuralObjectClass: organizationalUnit
dn: ou=Groups,dc=INETDOMAIN,dc=TLDORG
objectClass: top
objectClass: organizationalUnit
ou: Groups
-structuralObjectClass: organizationalUnit
dn: ou=Idmap,dc=INETDOMAIN,dc=TLDORG
objectClass: top
objectClass: organizationalUnit
ou: Idmap
-structuralObjectClass: organizationalUnit
dn: sambaDomainName=DOMNAME,ou=Domains,dc=INETDOMAIN,dc=TLDORG
objectClass: sambaDomain
@@ -978,7 +972,6 @@ sambaSID: DOMSID-512
sambaGroupType: 2
displayName: Domain Admins
description: Domain Administrators
-structuralObjectClass: posixGroup
dn: cn=domguests,ou=Groups,dc=INETDOMAIN,dc=TLDORG
objectClass: posixGroup
@@ -989,7 +982,6 @@ sambaSID: DOMSID-514
sambaGroupType: 2
displayName: Domain Guests
description: Domain Guests Users
-structuralObjectClass: posixGroup
dn: cn=domusers,ou=Groups,dc=INETDOMAIN,dc=TLDORG
objectClass: posixGroup
@@ -1000,7 +992,6 @@ sambaSID: DOMSID-513
sambaGroupType: 2
displayName: Domain Users
description: Domain Users
-structuralObjectClass: posixGroup
</screen>
</example>
diff --git a/docs/Samba-Guide/index.xml b/docs/Samba-Guide/index.xml
index 08457c1f48..a7dd6d32ac 100644
--- a/docs/Samba-Guide/index.xml
+++ b/docs/Samba-Guide/index.xml
@@ -42,6 +42,9 @@
<xi:include href="Chap06-MakingHappyUsers.xml"/>
<xi:include href="Chap07-2000UserNetwork.xml"/>
<xi:include href="Chap08-MigrateNT4Samba3.xml"/>
+<!---
+ <xi:include href="Chap08b-MigrateNW4Samba3.xml"/>
+-->
<xi:include href="Chap09-AddingUNIXClients.xml"/>
<xi:include href="Chap10-KerberosFastStart.xml"/>
<xi:include href="Chap10b-DomainAppsSupport.xml"/>
diff --git a/docs/Samba-Guide/preface.xml b/docs/Samba-Guide/preface.xml
index 0cd8a995fd..9000a10bd4 100644
--- a/docs/Samba-Guide/preface.xml
+++ b/docs/Samba-Guide/preface.xml
@@ -102,7 +102,7 @@
</para>
<table id="pref-new">
- <title></title>
+ <title>Samba Changes &smbmdash; 3.0.2 to 3.0.12</title>
<tgroup cols="2">
<colspec align="left"/>
<colspec align="justify"/>