Swarm 2014.1: User Guide

Runtime dependencies

Perforce Swarm requires the following runtime dependencies:

  • A supported operating system platform

  • Apache web server with mod_rewrite and mod_php5 modules

  • PHP (PHP: Hypertext Processor) with the following extensions:

    • iconv

    • json

    • session

    • P4PHP (Perforce PHP API)

    • APC (Alternative PHP Cache) or Zend OpCache (for optimal performance)

    • imagick (optional, for viewing non-web safe images)

  • LibreOffice (optional, for viewing office-type documents)

  • A supported Perforce service and the ability to connect to it.

Supported operating system platforms

Because Swarm includes binary versions of P4PHP (the Perforce extension for PHP), we support Swarm on the following operating systems:

  • Linux 2.6+ Intel (x86, x86_64) with glibc 2.3.3+

  • Mac OS X 10.6+ (x86_64)

You may be able to get Swarm running on another platform if you build P4PHP yourself and satisfy the other runtime dependencies. Instructions on how obtain and build P4PHP from source can be found here.

Supported web browsers

The following browsers are supported for use with Swarm:

  • Apple Safari 5.1+

  • Google Chrome 28+ (stable channel)

  • Microsoft Internet Explorer 9+

  • Mozilla Firefox 23+

We recommend the use of the latest stable version of the browsers listed above for the best experience when using Swarm.

Other web browsers might also work, including prior, development or beta builds of the above web browsers, but are not officially supported.

Swarm requires that JavaScript and cookies are enabled in the web browser.

Apache web server

Swarm requires Apache HTTP Server 2.2 or newer:

Swarm also requires the following Apache modules:

PHP

Swarm requires PHP 5.3.3+, 5.4.x, or 5.5.x+:

Swarm requires the following PHP extensions:

  • iconv (character encoding converter)


    http://www.php.net/iconv


    This is typically enabled by default with most PHP distributions

  • JSON (JavaScript Object Notation)


    http://www.php.net/json


    This is typically enabled by default with most PHP distributions, although recent distributions are making this optional

  • Session (session handling)


    http://www.php.net/session


    This is typically enabled by default with most PHP distributions

  • P4PHP (the Perforce PHP Extension)


    Included with the Swarm package. See the install directions.

Swarm greatly benefits from the following PHP extensions:

The recurring task to invoke Swarm workers, installed in a later step, requires either of:

Perforce Server requirements

Swarm works with Perforce Server versions at these patch levels or higher:

  • 2010.2/503309

  • 2011.1/506384

  • 2012.1/512349

  • 2012.2/525804

  • 2013.1/610569

  • 2013.2/707534

  • 2013.3/740675

Swarm performs best with Perforce Server version 2013.1 or newer.

Tip

For more information about how to set up a Perforce service, see:


http://www.perforce.com/perforce/technical.html

The Swarm triggers, which are installed on the Perforce service in a later step, require:

Security-enhanced Linux (SELinux)

Swarm is currently not supported with SELinux. We hope to support SELinux in a future release and provide guidance on the required configuration.

This version of Swarm does not work with SELinux with its default configuration in enforcing mode. If you are running a system with SELinux, Swarm may work if you set it to permissive mode with the command: 

$ sudo setenforce 0

Note

Setting your system to permissive mode might make Dan Walsh cry.

0 matching pages