--- doc/Attic/how_to_domain_coordinator.txt	2001/05/30 17:10:12	1.6
+++ doc/Attic/how_to_domain_coordinator.txt	2001/06/01 19:02:15	1.7
@@ -5,29 +5,90 @@ Scott Harrison
 April 17, 2001
 05/28/2001
 
-Example situation:
-Adding a user "dc103" to be a domain coordinator
-for the domain 103.
-
-1. login as super-user
-2. /usr/sbin/adduser dc103
-3. passwd dc103
-   enter in a password
-4. Cause 'www' to be a member of the group 'dc103'
+There are 16 steps to this procedure.  (Eventually
+this procedure will be replaced with interfaces.
+Till then, enjoy the UNIX command line.)
+
+You need to decide on three pieces of information
+to create a domain coordinator.
+
+* USERNAME (kermit, albert, joe, etc)
+* DOMAIN (should be the same as lonDefDomain in /etc/httpd/conf/access.conf)
+* PASSWORD (don't tell me)
+
+The examples in these instructions will be based
+on three example pieces of information:
+* USERNAME=dc103
+* DOMAIN=103
+* PASSWORD=sesame
+
+You will also need to know your "root" password
+and your "www" password.
+
+1. login as root on your Linux system
+   [prompt %] su
+
+2 (as root). add the user
+   Command: [prompt %] /usr/sbin/adduser USERNAME
+   Example: [prompt %] /usr/sbin/adduser dc103
+
+3 (as root). enter in a password
+   Command: [prompt %] passwd USERNAME
+            New UNIX password: PASSWORD
+            Retype new UNIX passwd: PASSWORD
+   Example: [prompt %] passwd dc103
+            New UNIX password: sesame
+            Retype new UNIX passwd: sesame
+
+4 (as root). Make www a member of the new user group.
+   You will need to change 1 line in /etc/group
+   Assuming USERNAME=dc103
+   (your values are different)
    Change this line in /etc/group
    dc103:x:NUMBER:   
    to be
    dc103:x:NUMBER:www
-5. Set permissions for /home/dc103 and /home/dc103/public_html
+
+5. Login as the new user
+   Command: [prompt %] su USERNAME
+   Example: [prompt %] su dc103
+
+5 (as USERNAME).  Create a public_html directory for the new user.
+   Command: [prompt %] install -d /home/USERNAME/public_html
+   Example: [prompt %] install -d /home/dc103/public_html
+
+6. (as USERNAME). Set permissions for /home/dc103 and /home/dc103/public_html
     to be readable and writeable by www.
-    chmod g+rw /home/dc103; chmod g+rw /home/dc103/public_html
-6. login as user=www
-7. cd /home/httpd/lonUsers
-8. install -d 103/d/c/1/dc103
-9. cd 103/d/c/1/dc103
-10. echo "unix:" > passwd
-11. Run the following script with the arguments
-[script] 103 dc103
+   Command: [prompt %] chmod g+rw /home/USERNAME
+            [prompt %] chmod g+rw /home/USERNAME/public_html
+   Example: [prompt %] chmod g+rw /home/dc103
+            [prompt %] chmod g+rw /home/dc103/public_html
+
+7. login as user=www
+   Command: [prompt %] su www
+            Password: WWWPASSWORD
+
+8 (as www). cd /home/httpd/lonUsers
+
+9. (as www) Create user directory for your new user.
+   Let U equal first letter of USERNAME
+   Let S equal second letter of USERNAME
+   Let E equal third letter of USERNAME
+   Command: [prompt %] install -d DOMAIN/U/S/E/USERNAME
+   Example: [prompt %] install -d 103/d/c/1/dc103
+
+10. (as www) Enter the newly created user directory.
+   Command: [prompt %] cd DOMAIN/U/S/E/USERNAME
+   Example: [prompt %] cd 103/d/c/1/dc103
+
+11. (as www). Set your password mechanism to 'unix' 
+   Command: [prompt %] echo "unix:" > passwd
+
+12. (as www). Create and run the following script with the arguments
+  Create the file described below "script.pl" or whatever name you want.
+
+  Command: [prompt %] perl script.pl DOMAIN USERNAME
+  Example: [prompt %] perl script.pl 103 dc103
 
 #!/usr/bin/perl
 
@@ -56,8 +117,12 @@ map {
 close OUT;
 
 untie %hash;
-12. Restart the lon processes (/etc/rc.d/init.d/loncontrol restart)
-13. Restart the httpd processes (/etc/rc.d/init.d/httpd restart)
-14. You may further define the domain coordinator user (i.e. dc103)
+
+13. login as root
+    Command: [prompt %] su
+
+14. Restart the lon processes (/etc/rc.d/init.d/loncontrol restart)
+15. Restart the httpd processes (/etc/rc.d/init.d/httpd restart)
+16. You may further define the domain coordinator user (i.e. dc103)
     by going to http://MACHINENAME/adm/createuser.