Coursier Installation

In TMT, we have adopted coursier to set up scala/java environment on development/production machines and install java based applications provided by CSW and ESW.

Install and Setup Coursier

  1. Refer to the steps mentioned here for downloading and installing coursier launcher

  2. Run following command to set up coursier

./cs setup --jvm 11

The above command does the following things:

  1. It adds coursier bin directory where coursier installs applications to PATH environment variable. So that, all the applications installed via coursier are available in PATH and can be executed from any directory.
  2. It installs Java AdoptOpenJDK 11.
Note

Refer this for detailed guide on cs setup command

Add TMT Channel

In order to install applications provided by CSW and ESW, TMT channel needs to be added to local coursier installation using cs install command.

For developer machine setup, add apps.json channel,

cs channel --add https://raw.githubusercontent.com/tmtsoftware/osw-apps/master/apps.json

For production machine setup, add apps.prod.json channel,

cs channel --add https://raw.githubusercontent.com/tmtsoftware/osw-apps/master/apps.prod.json
Note

TMT dev channel apps.json is pre-configured with INTERFACE_NAME and TMT_LOG_HOME environment variable. So that developer does not need to manually configure these environment variables on dev machine.

Examples

The command cs install <app-name>:<version | SHA> installs an application <app-name> using coursier.

Installing Alarm CLI v2.0.1

// csw-alarm-cli is the name of the application installed
// 2.0.1 is the version of the application to be installed
cs install csw-alarm-cli:2.0.1

Installing Alarm CLI Latest Version

If version number or SHA not provided in the install command, then the latest tagged binary of application gets installed.

// installs Alarm CLI with latest tagged version
cs install csw-alarm-cli
4.0.0-RC1