setup-mqclient's Introduction

setup-mqclient

This action sets up IBM MQ redistributable client (Client) and IBM MQ MacOS Toolkit (Toolkit) to Linux, Windows and MacOS GitHub-hosted runners.

Clients downloaded from https://public.dhe.ibm.com/ibmdl/export/pub/software/websphere/messaging/mqdev/redist

Toolkit downloaded from https://public.dhe.ibm.com/ibmdl/export/pub/software/websphere/messaging/mqdev/mactoolkit

Default installation paths are used for Clients and Toolkit installations:

Windows: %HOMEDRIVE%%HOMEPATH%\IBM\MQ\data
Linux: $HOME/IBM/MQ/data
MacOS: /opt/mqm

Installation path can be changed with mq-file-path input parameter (can't be changed for MacOS).

Action will fail if mq-file-path already exists. To recreate mq-file-path use true for clean-mq-file-path parameter. Default is false.

By default Client and Toolkit downloaded to setup-mqclient directory in the Home directory. You can use it for caching.

Caching directory can be changed by using download-path input parameter.

Default directory of the data path can be changed with mq-data-path input parameter.

Action has output parameter mq-file-path, that contains installation path.

Usage

See action.yml

Basic:

steps:
  - name: Install MQ Client
    uses: SeyfSV/[email protected]
    with:
      mq-client-version: 9.3.0.0 # Exact version of a client or toolkit

    - run: dspmqver

Caching and matrix:

strategy:
  matrix:
    environment: ['macos-latest', 'windows-latest', 'ubuntu-latest']
    mq-client-version: [9.3.0.0, latest]
runs-on: ${{ matrix.environment}}
steps:
  - name: Cache MQ Client
    uses: actions/cache@v2
    with:
      path: ${{ github.workspace }}/setup-mqclient
      key: mqclient-${{ runner.os }}-${{ matrix.mq-client-version }}

  - name: Install MQ Client
    uses: SeyfSV/[email protected]
    with:
      mq-client-version: ${{ matrix.mq-client-version }}

    - run: dspmqver

License

The scripts and documentation in this project are released under the MIT License

setup-mqclient's People

Contributors

Stargazers

Watchers

setup-mqclient's Issues

Error: EEXIST: file already exists, symlink MANIFEST.Redist

I was trying out v0.1.4 and v0.2.0 in my project, but was seeing multiple failures when the job runs on a runner where a previous run took place.

Downloading MQ Client...
Downloaded
Extracting archive "/home/actions/actions-runner/_work/rtp-certification-testing/rtp-certification-testing/distr/[9](https://github.com/moovfinancial/rtp-certification-testing/actions/runs/3175528958/jobs/5173680777#step:3:10).3.0.0-IBM-MQC-Redist-LinuxX64.tar.gz" to "/home/actions/IBM/MQ/data" ...

Error: EEXIST: file already exists, symlink 'MANIFEST.Redist' -> '/home/actions/IBM/MQ/data/MANIFEST'

Recommend Projects