See KB  https://community.perforce.com/s/article/16261 for additional information
and troubleshooting tips.

Instructions
------------

Download the test script to directory /opt/perforce/swarm as file jiratest.php.


For 2020.x and later, grab jiratest2020.php

    wget https://swarm.workshop.perforce.com/downloads/guest/joel_brown/swarm/jiratest/jiratest2020.php -O jiratest.php

For 2019.x, grab jiratest2019.php

    wget https://swarm.workshop.perforce.com/downloads/guest/joel_brown/swarm/jiratest/jiratest2019.php -O jiratest.php

For 2018.x and earlier:  Download jiratest2018.php as jiratest.php into the swarm root directory, /opt/perforce/swarm. 

    wget https://swarm.workshop.perforce.com/downloads/guest/joel_brown/swarm/jiratest/jiratest2018.php -O jiratest.php

Create the file jiraconfig.php in the same directory.  This should
match the jira configuration in swarm's config.php (/data).    For example,

    cd /opt/perforce/swarm
    cp data/config.php jiraconfig.php

Edit jiraconfig.php to configure your Jira connection.  

Example to run.

    cd /opt/perforce/swarm

    # save jiratest.php here in /opt/perforce/swarm
    cp data/config.php ./jiraconfig.php

    # edit jiraconfig.php for 'jira' and 'http_client_options'
    php jiratest.php

A successful run will return the projects that your defined user has access to.

The Jira module configuration is defined as described here:
https://www.perforce.com/perforce/doc.current/manuals/swarm/index.html#Swarm/integrations.jira.html

If your Jira api interface is listening on HTTPS, you may need
http client options as described here:
https://www.perforce.com/perforce/doc.current/manuals/swarm/index.html#Swarm/admin.security.html#admin.security.http_client_options

Once you've successfully determined your jira module configuration, copy only the changes you've made from jiraconfig.php to data/config.php. 

Example successful run:

$ php jiratest.php
JIRA host: http://ts-jira-linux.das.perforce.com:8080
Making request to http://ts-jira-linux.das.perforce.com:8080/rest/api/latest/project
  Status code: 200 OK
JIRA Projects returned: 4
 GIT JBONE JBTWO SWARM