Open topic with navigation

Install and upgrade Swarm

This chapter covers the initial installation and configuration of Swarm as well as upgrading an existing Swarm installation.

Important restrictions

Do not prefix group names, project names, user names, or client-names with "swarm-", this is a reserved term used by Swarm. Prefixing a name with "swarm-" will result in unexpected and unwanted behavior in Swarm.

For example:

Prefixing a group name with "swarm-project-" will result in, but is not limited to, the following issues:

• Swarm notifications will not be processed correctly for the group.
• The group will not be visible in Swarm.

Review the runtime dependencies

First, review the runtime dependencies before you install Swarm, see Runtime dependencies.

Choose the installation process

Once you have reviewed the Runtime dependencies and know that you can satisfy them, there are a number of ways to install Swarm.

Choose one of the following installation processes:

• Swarm packages (RPM or Debian):

  1. Follow the steps provided in Install and configure Swarm from a package.
  2. Configure the Swarm triggers on the Helix Server, see Helix Core Server configuration for Swarm.
  3. Review the post-install configuration options to customize your Swarm installation, see Post-install configuration options.
  4. You are now all set to start using Swarm. Enjoy!
  5. Tip

     To get started with Swarm, see the Quickstart chapter.

• Swarm.ova (Open Virtualization Appliance):

  1. Follow the steps provided in Deploy and configure a Swarm VM from an OVA.
  2. Configure the Swarm triggers on the Helix Server, see Helix Core Server configuration for Swarm.
  3. Review the post-install configuration options to customize your Swarm installation, see Post-install configuration options.
  4. You are now all set to start using Swarm. Enjoy!
  5. Tip

     To get started with Swarm, see the Quickstart chapter.

• Swarm.tgz (Tarball):

  1. Follow steps provided in the Install and configure Swarm manually from a Tarball.
  2. Configure Apache, see Apache configuration.
  3. Configure PHP, see PHP configuration.
  4. Configure Swarm, see Swarm configuration.
  5. Establish a trigger token, see Establish trigger token.
  6. Configure the Swarm triggers on the Helix Server, see Helix Core Server configuration for Swarm.
  7. Set up a recurring task to spawn workers, see Set up a recurring task to spawn workers.
  8. Review the post-install configuration options to customize your Swarm installation, see Post-install configuration options.
  9. You are now all set to start using Swarm. Enjoy!
  10. Tip

      To get started with Swarm, see the Quickstart chapter.

Upgrade Swarm

If you already have a working Swarm installation and you want to upgrade Swarm to a newer release, see Upgrading Swarm.