The Linux Application Checker (AppChecker) is used to test your application for
cross-distro compatibility and LSB (Linux Standard Base) compliance. Please
refer to the Getting Started document at
http://www.linuxfoundation.org/collaborate/workgroups/lsb/lsb-application-testkit-getting-started.
If you have questions, please send a message to the LSB mailing list at
lsb-discuss@lists.linuxfoundation.org or write to the technical support at
lsb-appchk-support@linuxbase.org.

SYSTEM REQUIREMENTS
In order to use the AppChecker, you need the following software to be available
to the user running the AppChecker:

--Perl
--rpm2cpio converter (if you are going to test RPM package files)
   - on Ubuntu and Debian, this is contained in the rpm package
   - on RPM-based distributions such as Red Hat and SUSE, the rpm2cpio command
     is installed by default during the base system installation

INSTALLATION
To install the AppChecker, unpack the tarball to any location and run the
installation script:
-> <app-checker-dir>/install.pl
You should either have root privileges or enter the root/sudo password during
the installation when asked.

USAGE
AppChecker has a web-based user interface on top of its own embedded simple web
server.

1. Start the AppChecker:
   -> /opt/lsb/app-checker/bin/app-checker-start.pl [port-number]
   or
   -> perl /opt/lsb/app-checker/bin/app-checker-start.pl [port-number]
   if your perl executable is not located at /usr/bin/perl.
   This will start the embedded web server of AppChecker. It will run with the
   current user privileges, and AppChecker will store its data and test results
   in /home/<user>/.lsb/app-checker directory. If you wish to share all the
   data between users, you need to start AppChecker with root privileges, e.g.:
   -> sudo /opt/lsb/app-checker/bin/app-checker-start.pl [port-number]
   In this case data will be stored in /var/opt/lsb/app-checker.

   The start script will also try to locate and open your web browser with the
   proper address to this server.
   Notes:
   - The [port-number] argument is optional (by default 8889 is taken).
   - If the script could not find your web-browser please start the browser
     manually and specify the address http://localhost:8889/ (port number should
     be appropriate) to connect to the AppChecker.
   - You can also connect to the AppChecker from any remote computer by
     specifying the URL http://<test-machine-name>:8889/ in your web browser. To
     enable this feature, you should modify the AcceptConnections key in the
     server configuration file (see p.4 below), and then restart the server.

2. Follow the UI presented in the browser to test your application. The
   interface is reasonably intuitive and self explanatory.
   Refer to the Getting Started and embedded Help if necessary or use e-mail
   support.

3. To stop the AppChecker web server, go to the Administration page in the
   web interface and click the Stop server button. Alternatively, you may run
   the script:
   -> /opt/lsb/app-checker/bin/app-checker-stop.pl [port-number]
   The port number is optional and can be used when there are several App
   Checker servers running on the same machine (in this case if you do not
   specify the port number you will be asked for it).

4. The embedded web sever configuration file is 
    /etc/opt/lsb/app-checker/app-checker-server.conf for system-wide run,
   or
    /home/<user>/.lsb/app-checker/config/app-checker-server.conf for local run.
   Create the file if it doesn't exist. There should be an example:
    app-checker-server.conf.default.

UNINSTALLATION
To unistall AppChecker, use your package manager (rpm or dpkg) to remove the
following packages:
1. lsb-app-checker
2. lsb-appchk
3. lsb-appchk-shell
4. lsb-appchk-perl
5. lsb-appchk-python
6. lsb-pkgchk
After that you may also delete the old results, logs and other data from
the /home/<user>/.lsb/app-checker or /var/opt/lsb/app-checker directory.
