---
title: "Jira Repeater Agent"
canonical: "https://docs.perspectium.com/space/earlierReleases/1441950/Jira%20Repeater%20Agent"
format: markdown
---
Installation The agent is packaged as an RPM to be installed in your Linux environment. Python is required but the installation of this RPM will prompt to install Python if it is not already installed. To install the Jira Repeater Agent RPM: yum install perspectium-jira-agent.rpm* *RPM name is subject to change based on the version you are installing. The agent will be installed in /opt/perspectium/jira_agent. Updating the Agent To upgrade the Jira Repeater Agent RPM: yum update perspectium-jira-agent.rpm* *RPM name is subject to change based on the version you are installing. Downgrading the Agent To downgrade the Jira Repeater Agent use the command: yum downgrade perspectium-jira-agent.rpm* *RPM name is subject to change based on the version you are installing.   NOTE : The jira_agent.xml properties file will not be changed during the downgrade. Configurations The agent's configuration file is located at  /etc/opt/perspectium/jira_agent/jira_agent.xml . The following configurations are available for the agent: Directive Description <mbs> <integration> <mbs></mbs></integration> Contains configuration information for connecting to Perspectium MBS as provided by Perspectium: <jira> <integration><jira></jira></integration>  C ontains configuration information for integrating with Jira to read messages from the specified MBS inbound queue and doing http actions against Jira: <logging> <agent> <proxy> (Optional)  HTTP/HTTPS proxy for the agent to connect outside the network.  This should be specified as a value in URI   format (ex.   http://user:password@internal-proxy.example.com/ ). Sample Configuration File <?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<config>
  <integration>
    <jira username='testuser' password='testuser'/>
    <mbs url='https://us-west-1-c1.perspectium.net/' username='admin' password='adminadmin' inbound='psp.out.siam.jira.agent.dev20468' outbound='psp.out.servicenow.dev20468'/>
  </integration>
  <agent name="test-jira-agent" heartbeat="30"/>
  <logging level="INFO" filename="/var/opt/perspectium/jira_agent/logs/jira_agent.log"/>
</config>

 Environment Variables Depending on your Linux environment, you may need to set the following   environment variables   in order for the agent to properly make http connections out of your server to MBS: http_proxy 
https_proxy
no_proxy For example: http_proxy 
http_proxy=http://10.0.0.1:5187/
https_proxy=$http_proxy
no_proxy="localhost,127.0.0.1,localaddress,.localdomain.com" Running the Agent The Jira Repeater Agent is intended to be run as a system service. To start the agent: service perspectium-jira-agent start To stop the agent: service perspectium-jira-agent stop To run the agent in the foreground: python /opt/perspectium/jira_agent/bin/repeater_agent -c To run the agent in the foreground in debug mode: python /opt/perspectium/jira_agent/bin/repeater_agent -c -d To run the agent in the foreground in debug mode using a different configuration file: python /opt/perspectium/jira_agent/bin/repeater_agent -c -d -f ./new-file.xml Where “-f ./new-file.xml” is the parameter pointing to the location of the configuration file. Advanced Configuration Agent Sleep Time To configure the sleep time for the agent after seeing an empty queue open the SyncQueueListener.py file. In the init function change the   freq   variable. def __init__(self, integration, proxy, timeout=5, freq=10, reporter=None): This example will sleep for 10 seconds after the QueueListener see an empty queue. This change will update the debug log message as well as the actual sleep time.