Installing and running

Paolo Predonzani edited this page Dec 27, 2017 · 2 revisions

Tstconfig makes it easy to keep an eye on your server's security configuration (and other configurations in general). This page shows how to install it and run it.

System requirements

Tstconfig is a command line tool that runs on Linux, Mac OS X and most *nix systems where Java is supported. The examples here are targeted at Ubuntu Linux.

Download and install Tstconfig

The current release is version 0.2. Download it from GitHub or use wget:

$ wget https://github.com/softwareloop/tstconfig/releases/download/v0.2/tstconfig-0.2-bin.zip

Uncompress the archive:

$ unzip tstconfig-0.2-bin.zip

Check and install Java

Tstconfig is written in Java. Check if you already have a JRE o JDK installed.

$ java -version
java version "1.7.0_65"
OpenJDK Runtime Environment (IcedTea 2.5.1) (7u65-2.5.1-4ubuntu1~0.14.04.2)
OpenJDK 64-Bit Server VM (build 24.65-b04, mixed mode)

Make sure you have Java 1.6, 1.7 or higher. If not, install it. On Ubuntu systems run:

$ sudo apt-get install openjdk-7-jre-headless

Run Tstconfig

Now move to the installation directory and run Tstconfig without any arguments.

$ cd tstconfig-0.2/
$ ./tstconfig
Tstconfig 0.2
No definition file provided.
Command line syntax:
tstconfig [DEFINITION_FILE]...

This confirms tstconfig is installed correctly. Now you can try one of the example definition files:

$ ./tstconfig examples/sshd.tstconfig

Add Tstconfig to your PATH (optional)

Assuming you have installed Tstconfig in your home directory, run:

$ PATH=$PATH:~/tstconfig-0.2

To make the change permanent, add it to your bash profile:

$ echo -e "\n# Tstconfig\nPATH=\$PATH:~/tstconfig-0.2" >> ~/.profile

Discover it

Explore the definition files in the examples/ directory and read the following examples:

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.