| 1 |
Installation Instructions |
| 2 |
------------------------- |
| 3 |
|
| 4 |
Usually all you have to do is: |
| 5 |
|
| 6 |
perl Makefile.PL |
| 7 |
make |
| 8 |
make test |
| 9 |
make install |
| 10 |
make clean |
| 11 |
|
| 12 |
If this fails, regard the following instructions step by step. |
| 13 |
Note that this module does not support installation by the CPAN(++) module. |
| 14 |
|
| 15 |
Options: |
| 16 |
|
| 17 |
-> Support for Solaris VxFS should be added automatically if the module |
| 18 |
is installed. If not, #define or #undef SOLARIS_VXFS in myconfig.h |
| 19 |
|
| 20 |
-> If you want support for AFS, you need the OpenAFS package |
| 21 |
(tested with OpenAFS on (SuSE) Linux, HP-UX10, Solaris 2.6, 2.8, AIX 4.3 |
| 22 |
and IRIX 6.5). |
| 23 |
The Makefile.PL tries to detect automatically if AFS is preset on a |
| 24 |
system. If that fails, edit the Makefile.PL to always define $hasafs |
| 25 |
(and drop me a mail). |
| 26 |
|
| 27 |
|
| 28 |
1) On Linux systems make sure you have configured your kernel with quota |
| 29 |
support. You also need the quota utilities and headers. E.g., with |
| 30 |
the SuSE Linux 6.0 distribution you'll find them in package ap::quota. |
| 31 |
If your distribution doesn't include the package you can get it from |
| 32 |
<URL:http://sourceforge.net/projects/linuxquota>. See also (6) below. |
| 33 |
|
| 34 |
Since 2019, SUN-RPC support has been split off from glibc in some |
| 35 |
Linux distributions. If you run into compilation problems due to |
| 36 |
missing header rpc/rpc.h, install package "libtirpc-dev" |
| 37 |
|
| 38 |
2) Link or create the hints file. |
| 39 |
|
| 40 |
a) Should be done by Makefile.PL for all supported systems. If not, and |
| 41 |
there is a file below hints/ for your operating system (maybe for a |
| 42 |
previous release), just create a link named "myconfig.h" to that file: |
| 43 |
ln -s hints/my-os.h myconfig.h |
| 44 |
|
| 45 |
b) Else, use hints/none.h to create a myconfig.h of your own. Check which |
| 46 |
#includes you need in the online manuals. Contact me before you invest |
| 47 |
a lot of time, it might already be done. |
| 48 |
|
| 49 |
Edit Makefile.PL to maybe add/delete some libraries. Usually you'll |
| 50 |
need only librpcsvc for the quota RPC mechanism. If you don't have |
| 51 |
this library or it lacks the quota routines, #define MY_XDR in |
| 52 |
myconfig.h to include the routines provided with this module. If you |
| 53 |
don't have /usr/include/rpcsvc/rquota.h, include "include/rquota.h" |
| 54 |
instead. If you don't need RPC at all, just define NO_RPC. |
| 55 |
|
| 56 |
3) Generate the Makefile: perl Makefile.PL |
| 57 |
|
| 58 |
4) Compile the module: make |
| 59 |
|
| 60 |
5) Run "make test" to check if the module routines do work correctly. |
| 61 |
Run the script once for user-quota and once group-quota, if needed. |
| 62 |
|
| 63 |
6) Linux specials: |
| 64 |
|
| 65 |
a) If you're using an ancient version of the Linux quota tools on a NFS |
| 66 |
server, check Quota::query() results for block usage and limits. |
| 67 |
Old versions of the rpc.rquotad did report a wrong block size, hence |
| 68 |
all sizes were 4 times too large. If your system shows this error, |
| 69 |
you should uncomment #define LINUX_RQUOTAD_BUG in the hints file and |
| 70 |
recompile. The better solution is to update your quota tools though. |
| 71 |
|
| 72 |
b) If you're using RedHat 7.1 or later, or the Alan Cox (ac) branch of |
| 73 |
the Linux 2.4.x kernels, you're victim of a new and completely |
| 74 |
backwards incompatible Quota file format and quotactl API. If you've |
| 75 |
downloaded the kernel separately, make sure to install the latest |
| 76 |
version of the quota tools: see (1). |
| 77 |
|
| 78 |
If the Quota module does not find quotas for any users anymore, the |
| 79 |
reason may be you've not set up the new aquota.user/group files yet. |
| 80 |
Remember: after creating these files with quotackeck(8) or |
| 81 |
convertquota(8) you have to execute quotaon(8) another time. You'll |
| 82 |
not see this requirement with quota(1) because that program reads the |
| 83 |
quota files directly if the kernel query fails; the module however only |
| 84 |
goes through the kernel. If in doubt, do an strace(1) on the quota(1) |
| 85 |
call. Normally you should see no access to the aquota files in the trace. |
| 86 |
Alternatively, make the quota files readable for root only (recommended |
| 87 |
anyway) and try quota -v again under a non-root login. If this fails, |
| 88 |
the kernel has not enabled quota support. |
| 89 |
|
| 90 |
7) To install the module in your perl tree: "make install" |
| 91 |
You may need to su root before this step. |
| 92 |
|
| 93 |
The contrib directory contains some usage examples, donated by |
| 94 |
users. No guarantee from me that they do anything useful or don't |
| 95 |
format your hard drive. |
| 96 |
|
| 97 |
8) Before you start for another OS, type "make clean" |
| 98 |
|
| 99 |
|
| 100 |
Please submit a ticket at CPAN (https://metacpan.org/pod/Quota) for any |
| 101 |
changes in the hints files or Makefile.PL you had to apply to get the |
| 102 |
package to compile. Please remember to include the name of the OS and |
| 103 |
version numbers of OS (uname -rs) and Quota module. |