gentoo docs have been updated
[openafs-wiki.git] / LoadingAFSintotheIRIXKernel.mdwn
1 In this section you incorporate AFS into the IRIX kernel, choosing one of two methods:
2
3 - Dynamic loading using the ml program distributed by Silicon Graphics, Incorporated (SGI).
4
5 - Building a new static kernel.
6
7 ## <a name="Prepare for incorporating AFS in"></a> Prepare for incorporating AFS into the kernel by performing the following procedures.
8
9 1. 1. 1. Mount the AFS CD-ROM for IRIX on the /cdrom directory. For instructions on mounting CD-ROMs (either locally or remotely via NFS), see your IRIX documentation. Then change directory as indicated.
10
11        # cd  /cdrom/sgi_65/root.client
12
13 1. 1. 1. Copy the AFS initialization script to the local directory for initialization files (by convention, /etc/init.d on IRIX machines). Note the removal of the .rc extension as you copy the script.
14
15        # cp -p   usr/vice/etc/afs.rc  /etc/init.d/afs
16
17 1. 1. 1. Issue the uname -m command to determine the machine's CPU board type. The IPxx value in the output must match one of the supported CPU board types listed in the IBM AFS Release Notes for the current version of AFS.
18
19        # uname -m
20
21 ## <a name="Incorporate AFS into the kernel,"></a> Incorporate AFS into the kernel, either using the ml program or by building AFS modifications into a static kernel.
22
23 The ml program is the dynamic kernel loader provided by SGI for IRIX systems. If you use it rather than building AFS modifications into a static kernel, then for AFS to function correctly the ml program must run each time the machine reboots. Therefore, the AFS initialization script (included on the AFS CD-ROM) invokes it automatically when the afsml configuration variable is activated. In this section you activate the variable and run the script.
24
25 In later sections you verify that the script correctly initializes all AFS components, then create the links that incorporate AFS into the IRIX startup and shutdown sequence.
26
27 ## <a name="Using the ml program"></a> Using the ml program
28
29 1. Create the local /usr/vice/etc/sgiload directory to house the AFS kernel library file.
30
31        # mkdir /usr/vice/etc/sgiload
32
33 1. Copy the appropriate AFS kernel library file to the /usr/vice/etc/sgiload directory. The IPxx portion of the library file name must match the value previously returned by the uname -m command. Also choose the file appropriate to whether the machine's kernel supports NFS server functionality (NFS must be supported for the machine to act as an NFS/AFS Translator). Single- and multiprocessor machines use the same library file.
34
35 (You can choose to copy all of the kernel library files into the /usr/vice/etc/sgiload directory, but they require a significant amount of space.)
36
37 If the machine's kernel supports NFS server functionality:
38
39        # cp -p  usr/vice/etc/sgiload/libafs.IPxx.o  /usr/vice/etc/sgiload
40
41 If the machine's kernel does not support NFS server functionality:
42
43        # cp -p  usr/vice/etc/sgiload/libafs.IPxx.nonfs.o   \
44                        /usr/vice/etc/sgiload
45
46 1. Issue the chkconfig command to activate the afsml configuration variable.
47
48        # /etc/chkconfig -f afsml on
49
50 If the machine is to function as an NFS/AFS Translator and the kernel supports NFS server functionality, activate the afsxnfs variable.
51
52        # /etc/chkconfig -f afsxnfs on
53
54 1. Run the /etc/init.d/afs script to load AFS extensions into the kernel. The script invokes the ml command, automatically determining which kernel library file to use based on this machine's CPU type and the activation state of the afsxnfs variable.
55
56 You can ignore any error messages about the inability to start the BOS Server or the Cache Manager or AFS client.
57
58        # /etc/init.d/afs start
59
60 ## <a name="Building a Kernel"></a> Building a Kernel
61
62 - If you prefer to build a kernel, and the machine's hardware and software configuration exactly matches another IRIX machine on which AFS is already built into the kernel, you can copy the kernel from that machine to this one. In general, however, it is better to build AFS modifications into the kernel on each machine according to the following instructions.
63
64 1. 1. 1. 1. 1. Copy the kernel initialization file afs.sm to the local /var/sysgen/system directory, and the kernel master file afs to the local /var/sysgen/master.d directory.
65
66        # cp -p  bin/afs.sm  /var/sysgen/system
67
68        # cp -p  bin/afs  /var/sysgen/master.d
69
70 1. 1. 1. 1. 1. Copy the appropriate AFS kernel library file to the local file /var/sysgen/boot/afs.a; the IPxx portion of the library file name must match the value previously returned by the uname -m command. Also choose the file appropriate to whether the machine's kernel supports NFS server functionality (NFS must be supported for the machine to act as an NFS/AFS Translator). Single- and multiprocessor machines use the same library file.
71
72 If the machine's kernel supports NFS server functionality:
73
74        # cp -p   bin/libafs.IPxx.a   /var/sysgen/boot/afs.a
75
76 If the machine's kernel does not support NFS server functionality:
77
78        # cp -p  bin/libafs.IPxx.nonfs.a  /var/sysgen/boot/afs.a
79
80 1. 1. 1. 1. 1. Issue the chkconfig command to deactivate the afsml configuration variable.
81
82        # /etc/chkconfig -f afsml off
83
84 If the machine is to function as an NFS/AFS Translator and the kernel supports NFS server functionality, activate the afsxnfs variable.
85
86        # /etc/chkconfig -f afsxnfs on
87
88 1. 1. 1. 1. 1. Copy the existing kernel file, /unix, to a safe location. Compile the new kernel, which is created in the file /unix.install. It overwrites the existing /unix file when the machine reboots in the next step.
89
90        # cp /unix /unix_noafs
91
92        # autoconfig
93
94 1. 1. 1. 1. 1. Reboot the machine to start using the new kernel, and login again as the superuser root.
95
96        # cd /
97
98        # shutdown -i6 -g0 -y
99
100        login: root
101        Password: root_password