The Linux Application Checker (App Checker) 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://ispras.linuxfoundation.org/index.php/Linux_App_Checker_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-appcheck-support@linuxfoundation.org.

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

--Perl
--rpm2cpio converter
   - 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 App Checker, unpack the tarball to any location and run the
installation script:
-> <app-checker-dir>/install.sh
You should either have root privileges or enter the root/sudo password during
the installation when asked.

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

1. Start the App Checker:
   -> /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.
   You should either have root privileges, or enter the root/sudo password when
   asked.

   This will start the embedded web server and will 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 App Checker.
   - You can also connect to the App Checker from any remote computer by
     specifying the URL http://<test-machine-name>:8889/ in your web browser.

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 document at
   http://ldn.linuxfoundation.org/lsb/lsb-application-testkit-getting-started
   Refer to the embedded Help if necessary or use e-mail support.

3. To stop the App Checker 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
   Create one if it doesn't exist. There should be an example:
    app-checker-server.conf.default.

UNINSTALLATION
To unistall App Checker, use your package manager (rpm or dpkg) to remove the
following packages:
1. linux-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 /var/opt/lsb/app-checker directory.
