My COPR repo doesn't support 4.5 kernels, but has openafs 1.6.17 packages with backpo...
[openafs-wiki.git] / BuildingAFSintotheHP-UXKernel.mdwn
1 Use the following instructions to build AFS modifications into the kernel on an HP-UX system.
2
3 On HP-UX systems, you must build AFS modifications into a new static kernel; HP-UX does not support dynamic loading. If the machine's hardware and software configuration exactly matches another HP-UX machine on which AFS is already built into the kernel, you can choose to 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.
4
5 1. Move the existing kernel-related files to a safe location.
6
7        # cp /stand/vmunix /stand/vmunix.noafs
8
9        # cp /stand/system /stand/system.noafs
10
11 1. Mount the AFS CD-ROM for HP-UX on the local /cdrom directory. For instructions on mounting CD-ROMs (either locally or remotely via NFS), see your HP-UX documentation. Then change directory as indicated.
12
13        # cd /cdrom/hp_ux110/root.client
14
15 1. Copy the AFS initialization file to the local directory for initialization files (by convention, /sbin/init.d on HP-UX machines). Note the removal of the .rc extension as you copy the file.
16
17        # cp usr/vice/etc/afs.rc  /sbin/init.d/afs
18
19 1. Copy the file afs.driver to the local /usr/conf/master.d directory, changing its name to afs as you do.
20
21        # cp  usr/vice/etc/afs.driver  /usr/conf/master.d/afs
22
23 1. Copy the AFS kernel module to the local /usr/conf/lib directory.
24
25 If the machine's kernel supports NFS server functionality:
26
27        # cp bin/libafs.a /usr/conf/lib
28
29 If the machine's kernel does not support NFS server functionality, change the file's name as you copy it:
30
31        # cp bin/libafs.nonfs.a /usr/conf/lib/libafs.a
32
33 1. Incorporate the AFS driver into the kernel, either using the SAM program or a series of individual commands.
34
35 \* To use the SAM program:
36
37 1. 1. 1. 1. 1. Invoke the SAM program, specifying the hostname of the local machine as local\_hostname. The SAM graphical user interface pops up.
38
39        # sam -display local_hostname:0
40
41 1. 1. 1. 1. 1. Choose the Kernel Configuration icon, then the Drivers icon. From the list of drivers, select afs.
42
43 1. 1. 1. 1. 1. Open the pull-down Actions menu and choose the Add Driver to Kernel option.
44
45 1. 1. 1. 1. 1. Open the Actions menu again and choose the Create a New Kernel option.
46
47 1. 1. 1. 1. 1. Confirm your choices by choosing Yes and OK when prompted by subsequent pop-up windows. The SAM program builds the kernel and reboots the system.
48
49 1. 1. 1. 1. 1. Login again as the superuser root.
50
51        login: root
52        Password: root_password
53
54 \* To use individual commands:
55
56 1. 1. 1. 1. 1. Edit the file /stand/system, adding an entry for afs to the Subsystems section.
57
58 1. 1. 1. 1. 1. Change to the /stand/build directory and issue the mk\_kernel command to build the kernel.
59
60        # cd /stand/build
61
62        # mk_kernel
63
64 1. 1. 1. 1. 1. Move the new kernel to the standard location (/stand/vmunix), reboot the machine to start using it, and login again as the superuser root.
65
66        # mv /stand/build/vmunix_test /stand/vmunix
67
68        # cd /
69
70        # shutdown -r now
71
72        login: root
73        Password: root_password