ATK Manager stands for Application Test Kit Manager and is used to test your
application for LSB (Linux Standard Base) compliance. Also, it can be used for
analyzing external dependencies (libraries and interfaces) of your appplication
without regard to LSB. Please refer to Getting Started document at
http://ispras.linux-foundation.org/index.php/LSB_ATK_Manager_Getting_Started.
If you have questions please send a message to the LSB mailing list at
lsb-discuss@lists.linux-foundation.org or write to the technical support at
linux@ispras.ru.

SYSTEM REQUIREMENTS
In order to use the ATK Manager, you need the following software to be available
to the user running the ATK Manager:
1. Perl
2. rpm2cpio converter
   - on Ubuntu and Debian this is contained in the rpm package
   - on RPM based distributions such as RedHat and SUSE the rpm2cpio command is
     installed by default during the base system installation

INSTALLATION
To install the ATK Manager, unpack the tarball to any location and run the
installation script:
-> <atk-manager-dir>/install.sh
You should either have root privileges, or enter the root/sudo password during
the installation when asked.

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

1. Start the ATK Manager:
   -> /opt/lsb/app-testkit/manager/bin/lsb-atk-start.pl [port-number]
   or
   -> perl /opt/lsb/app-testkit/manager/bin/lsb-atk-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 ATK Manager.
   - You can also connect to the ATK Manager 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 embedded
   Help if necessary or use e-mail support.

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

UNINSTALLATION
To unistall ATK Manager, use your package manager (rpm or dpkg) to remove the
following packages:
1. lsb-atk-manager
2. lsb-appchk
3. lsb-appchk-shell
4. lsb-appchk-perl
5. lsb-appchk-python
6. lsb-pkgchk
After that you can also wish to delete the old results, logs and other data from
the /var/opt/lsb/app-testkit/manager directory.
