Get

Installation

A note about SQLite support: Since the SQLite package caused issues in our CI pipeline, SQLite support is disabled by default for all builds, binaries and debian packages. To enable SQLite support you will need to build from source.

From Source

You can install the current development version from source. To do so, you will need a working Go installation with a configured GOPATH.

  1. Run

    go get gitlab.com/stp-team/systemtestportal-webapp/cmd/stp
    

    to download and install STP.
    To enable persistent data storage in an sqlite database, instead run

    go get -tags 'sqlite' gitlab.com/stp-team/systemtestportal-webapp/cmd/stp
    
  2. The installed package can be found under $GOPATH/bin/stp

  3. Optionally, you can move the asset folders, migrations, templates and static, to another folder

  4. If you enabled SQLite support no default user will be created at startup. To create this default user, run

    go install -tags 'sqlite' gitlab.com/stp-team/systemtestportal-webapp/cmd/stp-create-default-user
    stp-create-default-user
    

    after you have installed STP.

  5. The application automatically creates an example project at startup when built without sqlite support. You can also create that project when sqlite support is enabled by running

    go install -tags 'sqlite' gitlab.com/stp-team/systemtestportal-webapp/cmd/stp-create-example-project
    stp-create-example-project
    
  6. Run stp

    stp
    

    to start up the server. If you moved the asset folders elsewhere, use the --basepath argument:

    stp --basepath=/folder/where/you/put/the/assets
    
  7. Open a web browser and visit http://localhost:8080 to access the application.

From Binaries

Our FTP server provides binaries for Windows and Linux.

  1. Binary releases can be found at

    ftp://ftp.informatik.uni-stuttgart.de/pub/se/systemtestportal/releases for stable releases

    or

    ftp://ftp.informatik.uni-stuttgart.de/pub/se/systemtestportal/nightlies for nightly unstable releases

    If you just want the latest version you can also go directly to:

    Latest stable release

    Latest nightly unstable release

  2. Download the correct archive file

    • Stable releases: SystemTestPortal-<os>-<arch>_<version>.zip where <os> is your operating system (e.g. windows or linux) and <arch> is your architecture (If you don’t know your architecture you probably have amd64).
    • Experimental releases:SystemTestPortal-<os>-<arch>_<version>.zip where <os> is your operating system (e.g. windows or linux), <arch> is your architecture (If you don’t know your architecture you probably have amd64).
  3. Extract the downloaded archive file

  4. Run the stp(stp.exe on windows) executable in the extracted folder

  5. Open a web browser and visit http://localhost:8080 to access the application.

Using our Debian Update Site

We also host an apt package repo containing packages of the current release and development builds. The package depends on systemd and will add a service definition that runs STP.

For your first installation you will need to configure the apt repository:

  1. To access the repository you need to tell apt about the key file. To download it from the command line, use

    wget http://www.systemtestportal.org/keys/st141539@stud.uni-stuttgart.de.key
    

    This will create a file st141539@stud.uni-stuttgart.de.key in your current directory.

  2. The following commands will require root access. To become root, login as root or run

    sudo -s
    
  3. To tell apt about the key file use

    apt-key add st141539@stud.uni-stuttgart.de.key
    
  4. Configure a new package source. Run one of the following commands:

    • for stable releases:
    echo deb ftp://ftp.informatik.uni-stuttgart.de/pub/se/systemtestportal/debian stable main > /etc/apt/sources.list.d/systemtestportal.list
    
    • for experimental releases:
    echo deb ftp://ftp.informatik.uni-stuttgart.de/pub/se/systemtestportal/debian experimental main > /etc/apt/sources.list.d/systemtestportal.list
    
  5. Logout of the root account. If you used sudo before, you can just run

    exit
    

Now you are ready to install SystemTestPortal from the package site.

  1. The following commands will require root access. To become root, login as root or run

    sudo -s
    
  2. Run

    apt update
    apt install systemtestportal
    

    as root to read the new package lists and install the package.

  3. To enable the service so it is automatically run at startup, run

    systemctl enable stp.service
    
  4. You will need to start the service to run for the first time

    systemctl start stp.service
    
  5. Logout of the root account with exit

  6. Open a web browser and visit http://localhost:8080(http://localhost for versions < 0.7) to access the application.

via Docker

You can access a docker image via our container registry right now.