changes to fold xfs_support code back into XFS (the other sgi projects
[xfstests-dev.git] / tools / README.auto-qa
index fa36165ac0cabbfe4719f6953ab3320c1ddef97a..7b62f6b1ada177462daa5d6de06d75856fcddee4 100644 (file)
@@ -4,17 +4,19 @@ ______________________                                      ______________
 
        - pick/create a user to run auto-qa and check they 
             can use ptools to check out of the tree
-       - add your host to cmd/xfs/stress/common.config
-       - add your host to cmd/xfs/tools/auto-qa
+       - add your host to cmd/xfstests/common.config
+       - add your host to cmd/xfstests/tools/auto-qa
                check both these files in
        - make a directory "$HOME/qa"
        - make a workarea "$HOME/qa/linux-xfs" for linux-xfs
                (easiest to copy one from elsewhere)
-       - cd $HOME/qa ; ln -s linux-xfs/cmd/xfs/tools/auto-qa .
+       - cd $HOME/qa ; ln -s linux-xfs/cmd/xfstests/tools/auto-qa .
                (auto-qa must be a link into it's own source tree
                so it can update itself)
        - copy an appropriate .config file to
-               $HOME/qa/$HOSTNAME-2.4.0-xfs-qa.config
+               $HOME/qa/$HOSTNAME.config
+       - You'll need to maunally install the "quota" and "acl"
+         userspace tools, rest will be installed automatically.
        - You'll need a hacked version of 'su' in $HOME/qa that
                 lets your user su to root/root without a password
                 (if you want to run from cron, it mustn't require
@@ -24,7 +26,7 @@ ______________________                                      ______________
        - chmod 6755 $HOME/qa/su
        - add the soon to be kernel to /etc/lilo.conf
 
-               image=/boot/vmlinuz-2.4.0-xfs-qa
+               image=/boot/vmlinuz-xfs-qa
                        label=linux-xfs-qa
                        append = "console=ttyS0,38400n8"
                
@@ -47,15 +49,15 @@ To get it going automagically:
                30 4 * * *      $HOME/qa/auto-qa cron-restarted
 
 Notes:
-       - if MODULAR=1 in auto-qa XFS and pagebuf are expected to
-                be modules. if MODULAR=0 they should be built into
-                the kernel
+       - if MODULAR=1 in auto-qa the XFS filesystem is expected to
+                be a module; if MODULAR=0 it should be built into
+                the kernel.
        - the test device is cleaned at the start of the QA run
                (to stop nightly QA being stuffed up if someone
                leaves the device inconsistant etc)
        - I'm using a hacked su because PCP sudo won't set the
                gid properly, and normal linux su won't run
-               without a tty even if PAM is pissed-off.
+               without a tty even if PAM is switched off.
        - The QA is restarted after reboot by a second cron entry
                to avoid the test being able to get itself into
                some stupid loop and so that it's always started
@@ -65,7 +67,7 @@ Notes:
        - When run in "cron-init" or "init" states, the script
                will p_tupdate itself and restart. If you start
                with an empty source tree, you'll need to check
-               out the cmd/xfs/tools/auto-qa script before it'll
+               out the cmd/xfstests/tools/auto-qa script before it'll
                work (duh).
 
 good luck.