Running Self-Verification

StackStorm includes a script for verifying the system installation.

The script covers the following aspects of StackStorm:

To run the StackStorm self-verification script:

  1. If you don’t have encryption keys setup already, do so. This will require both StackStorm and system admin privileges to configure.

  2. Run the self-check script /opt/stackstorm/st2/bin/st2-self-check. This also copies the examples from /usr/share/doc/st2/examples to /opt/stackstorm/packs/ and registers the content. Running this step will pollute your StackStorm environment because it will download fixtures from st2tests.

sudo ST2_AUTH_TOKEN=$(st2 auth st2admin -p '<PASSWORD>' -t) /opt/stackstorm/st2/bin/st2-self-check

By default, st2-self-check will run Orquesta tests, but will not run Windows tests. This can be controlled with CLI options. You can also choose which st2tests branch to use:

Usage: /usr/bin/st2-self-check

Options:
  -o  Skip Orquesta tests
  -w  Run Windows tests
  -b Which branch of st2tests to use (defaults to master)