From 51c761706a9945ab40d34b4212bd463fa617636e Mon Sep 17 00:00:00 2001 From: Phillip Moore Date: Tue, 5 Oct 2010 12:46:35 -0400 Subject: [PATCH] Quick Start Guide updated for RHEL rpms, and CLI syntax The names of the RHEL rpms have been updated to reflect what is actually published on openafs.org, and the CLI syntax of the commands run using -noauth have had the unnecessary -cell options removed. Change-Id: I5c03d371c822d1d064660a3b00fb3d1e64bff141 Reviewed-on: http://gerrit.openafs.org/2914 Reviewed-by: Russ Allbery Tested-by: BuildBot Reviewed-by: Derrick Brashear --- doc/xml/QuickStartUnix/auqbg005.xml | 40 ++++++++++++----------------- doc/xml/QuickStartUnix/auqbg007.xml | 9 ++++--- 2 files changed, 21 insertions(+), 28 deletions(-) diff --git a/doc/xml/QuickStartUnix/auqbg005.xml b/doc/xml/QuickStartUnix/auqbg005.xml index 48fe31718..7430fd166 100644 --- a/doc/xml/QuickStartUnix/auqbg005.xml +++ b/doc/xml/QuickStartUnix/auqbg005.xml @@ -3139,22 +3139,19 @@ auth required pam_unix.so try_first_pass Issue the bos create command to start the Backup Server. - # ./bos create <machine name> buserver simple /usr/afs/bin/buserver \ - -cell <cell name> -noauth + # ./bos create <machine name> buserver simple /usr/afs/bin/buserver -noauth Issue the bos create command to start the Protection Server. - # ./bos create <machine name> ptserver simple /usr/afs/bin/ptserver \ - -cell <cell name> -noauth + # ./bos create <machine name> ptserver simple /usr/afs/bin/ptserver -noauth Issue the bos create command to start the VL Server. - # ./bos create <machine name> vlserver simple /usr/afs/bin/vlserver \ - -cell <cell name> -noauth + # ./bos create <machine name> vlserver simple /usr/afs/bin/vlserver -noauth @@ -3421,8 +3418,7 @@ Entry for principal afs/<cell name> with kvno 3 role="bold">admin user to the /usr/afs/etc/UserList file. This enables the admin user to issue privileged bos and vos commands. - # ./bos adduser <machine name> admin -cell <cell name> -noauth + # ./bos adduser <machine name> -noauth commands @@ -3488,8 +3484,7 @@ Entry for principal afs/<cell name> with kvno 3 afs/cell name entry, which you displayed in Step 3. - # ./bos listkeys <machine name> -cell <cell name> -noauth + # ./bos listkeys <machine name> -noauth key 0 has cksum checksum @@ -3532,7 +3527,7 @@ Entry for principal afs/<cell name> with kvno 3 to accept the default. - # pts createuser -name admin -cell <cell name> [pts createuser -name admin [-id <AFS UID>] -noauth User admin has id AFS UID @@ -3564,10 +3559,8 @@ Entry for principal afs/<cell name> with kvno 3 membership command to verify the new membership. Membership in the group enables the admin user to issue privileged pts commands and some privileged fs commands. - # ./pts adduser admin system:administrators -cell <cell name> -noauth - # ./pts membership admin -cell <cell name> -noauth + # ./pts adduser admin system:administrators -noauth + # ./pts membership admin -noauth Groups admin (id: 1) is a member of: system:administrators @@ -3591,8 +3584,8 @@ Entry for principal afs/<cell name> with kvno 3 Issue the bos restart command with the -all flag to restart the database server processes, so that they start using the new server encryption key. - # ./bos restart <machine name> -all -cell <cell name> -noauth + # ./bos restart <machine name> -all + -noauth @@ -3699,7 +3692,7 @@ Entry for principal afs/<cell name> with kvno 3 # ./bos create <machine name> fs fs /usr/afs/bin/fileserver \ /usr/afs/bin/volserver /usr/afs/bin/salvager \ - -cell <cell name> -noauth + -noauth @@ -3708,7 +3701,7 @@ Entry for principal afs/<cell name> with kvno 3 # ./bos create <machine name> fs fs /usr/afs/bin/dafileserver \ /usr/afs/bin/davolserver /usr/afs/bin/salvageserver \ - /usr/afs/bin/salvager -cell <cell name> -noauth + /usr/afs/bin/salvager -noauth @@ -3802,7 +3795,7 @@ Entry for principal afs/<cell name> with kvno 3 # ./vos create <machine name> <partition name> root.afs \ - -cell <cell name> -noauth + -noauth The Volume Server produces a message confirming that it created the volume on the specified partition. You can @@ -3830,9 +3823,9 @@ Entry for principal afs/<cell name> with kvno 3 syncvldb and vos syncserv commands to synchronize the VLDB with the actual state of volumes on the local machine. To follow the progress of the synchronization operation, which can take several minutes, use the -verbose flag. - # ./vos syncvldb <machine name> -cell <cell name> ./vos syncvldb <machine name> -verbose -noauth - # ./vos syncserv <machine name> -cell <cell name> ./vos syncserv <machine name> -verbose -noauth @@ -3940,8 +3933,7 @@ Entry for principal afs/<cell name> with kvno 3 process. # ./bos create <machine name> upserver simple \ "/usr/afs/bin/upserver -crypt /usr/afs/etc \ - -clear /usr/afs/bin" -cell <cell name> -noauth + -clear /usr/afs/bin" -noauth diff --git a/doc/xml/QuickStartUnix/auqbg007.xml b/doc/xml/QuickStartUnix/auqbg007.xml index ed42f5e47..5b27d9fdf 100644 --- a/doc/xml/QuickStartUnix/auqbg007.xml +++ b/doc/xml/QuickStartUnix/auqbg007.xml @@ -989,9 +989,10 @@ Download and install the RPM set for your operating system. RPMs are available from the OpenAFS web site. You will need the - openafs and - openfs-client packages, along - with an openafs-kernel package + openafs, openafs-server, + openafs-client and + openafs-krb5 packages, along + with an kmod-openafs package matching your current, running ,kernel. You can find the version of your current kernel by running @@ -1003,7 +1004,7 @@ Once downloaded, the packages may be installed with the rpm command - # rpm -U openafs-* openafs-client-* openafs-server-* openafs-kernel-* + # rpm -U openafs-* openafs-client-* openafs-server-* openafs-krb5-* kmod-openafs-* -- 2.39.5