Workflow systems, like ActionFlow and TeamForge Action Server, monitor the site for certain conditions defined in one or more rules. When match occurs, the associated rule is executed. The Actions defined in the rule can then perform a workflow that in turn can consist of a sequence of predefined actions. Follow these instructions to set up integrations with such workflow systems.
Before You Begin
  1. Before creating the workflow system, make sure that the DNS is configured properly on your site. For sites without correct DNS configuration, the CLI server that runs inside the chroot setup cannot create the AMQP users as it won’t see the /etc/hosts path before it gets into the chroot setup and as a result, the AMQP Password column will be empty when you create the workflow system.
  2. To fix this issue, copy the /etc/hosts to /opt/collabnet/teamforge/var/cliserver/. This ensures that the CLI server looks at the /etc/hosts path.
  3. Try creating the workflow. You can see the AMQP Password column showing the password.

Create a Workflow System

  1. Log on to TeamForge web UI with site administrator credentials.
  2. Select My Workspace > Admin.
  3. Select Projects > Integrated Apps.
  4. Select DLM and click Administer.
  5. Select Workflow Systems from the Administration pane.
  6. Click Create. The Create WorkFlow Integration page appears.
  7. Type the workflow system name and base URL (the URL where the workflow system is hosted. Use “https://” if using SSL).
  8. Click Create.

Troubleshooting ActionFlow

If ActionFlow doesn’t trigger any action,

  1. Validate if the values of the keys are correct in the ActionFlow server.
    st2 key list --decrypt
    

    If the “Token has expired” message is displayed, run the following command before displaying the key list.

    export ST2_AUTH_TOKEN=$(st2 auth <st2 username here> -p <st2 password here> -t)
    

    Review the list displayed to make sure that the values are correct.

  1. If you want to change a key, run the following command. The system in turn will return the new value.
    st2 key set <key name> <enter new key value>
    

    If you have entered an incorrect key, you can erase it by running the following command.

    st2 key delete <key name to be deleted>
    
  2. Run the following command once the keys have been updated.
    st2ctl reload
    
Tags for this page: devops setting_up_devops dlm action_flow