Run Jira Edge Connector

Owned by Shivi Sivasubramanian
Last updated: Jun 27, 2023
2 min read

Run JEC

On Linux

Use these commands to start, stop, and restart JEC respectively:

sudo systemctl start jec sudo systemctl stop jec sudo systemctl restart jec

Example usage with environment variables:

sudo systemctl set-environment JEC_CONF_SOURCE_TYPE=git sudo systemctl set-environment JEC_CONF_GIT_URL=git@gitlab.com:metehan2/test-private-conf.git sudo systemctl set-environment JEC_CONF_GIT_PRIVATE_KEY_FILEPATH=~/.ssh/id_rsa sudo systemctl set-environment JEC_CONF_GIT_FILEPATH=~/jec/conf/jec-config.json sudo systemctl start jec

or

sudo systemctl set-environment JEC_CONF_SOURCE_TYPE=local sudo systemctl set-environment JEC_CONF_LOCAL_FILEPATH=~/jec/conf/jec-config.json sudo systemctl start jec

Older RHEL based distributions (6.x.x and older)

On Windows

SIGINT and SIGTERM signals are used to stop JEC. You can’t stop/restart JEC via native methods of Windows while using JEC as a service. It is provided as a helper executable to run JEC as a service.

You can set environment variables(Env) and arguments(Args) via jecService<32|64>.json as follows:

Use these commands to start, stop, and restart JEC version amd64:

Use these commands start, stop, and restart JEC version 386:

Run JEC with Docker

  1. Clone the repository: https://github.com/atlassian/jec.git

  2. Run docker build . -t jec

Since JEC uses configuration files to run, you need to provide volumes to Docker container so that the files are accessible from the container. You also need to provide environment variables explained in the article to the container.

An example command to run docker container:

The command runs the container with two environment variables and creates a volume between the “bar” folder in host machine and “jsm” folder in the container. Since you are using docker container to run JEC, you need to give the file paths according to the container, not to the host machine.

If you want to use the configuration from your repository, add your ssh_known_hosts file to image by using a volume. You may also need to set SSH_KNOWN_HOSTS environment variable to your ssh_know_hosts file path in the image. Following is an example command to run JEC using a configuration file from a repository. The command also creates additional volume to access the log files from the host machine.