1. How to get started

Getting started with the API-Manager CLI is very simple.

Requirements

• an API-Manager Version 7.X up & running
  • the project has been tested with version 7.6.2 SP2, 7.6.2 SP3, 7.6.2 SP4 & 7.7 (you can verify compatibility yourself as described here)
• Either an environment to execute a very simple Shell-Script or BAT-File, which wraps a Java-Program
  • or executing a binary when installed with Chocolately.org
• an installed Java Runtime Environment 8 or higher
• the machine must have access to the API-Manager REST-API on Default-Port: 8075

Where to get it

Option 1: Download & Extract the release

• Download the latest release from here
  • best is to extract the archive including the folder: (e.g. apim-cli-1.0.0) somewhere on your disk
    "C:\Axway\Tools"
  • now create a Short-Cut-Folder pointing to the extracted version like so:
    "C:\Axway\Tools\apim-cli" --> "C:\Axway\Tools\apim-cli-1.0.0"
  • Add the following to your PATH:
    "C:\Axway\Tools\apim-cli\scripts"
  • You can now run the CLI with one of the following scripts:
    apim.bat or apim.sh
  • With that structure:
    
    you can just extract every new version into the same folder and just update the short-cut to the version you want

Option 2: Use Chocolately

If you want to use the API-Management CLI on Windows and you are already using Chocolately.org the installation is just that simple:
choco install axway-apim-cli
To upgrade to the newest version just say:
choco upgrade axway-apim-cli
After installation you can just run apim

Option 3: With Maven

You may use Maven-Dependencies as part of your Java-Project to streamline communication with the API-Manager or just create a Jenkins Maven-Based pipeline workflow. Please check yourself on Maven-Central for the last available version: https://mvnrepository.com/artifact/com.github.axway-api-management-plus.apim-cli

Manage APIs

If you would like to manage APIs use the following dependency for your project:

<dependency>
	<groupId>com.github.axway-api-management-plus.apim-cli</groupId>
	<artifactId>apimcli-apis</artifactId>
	<version>1.2.1</version>
</dependency>

This dependency allows you to import/replicate and export APIs from your API-Manager. This is especially interesting when integrated into a pipeline based on Maven.

Manage Applications

<dependency>
	<groupId>com.github.axway-api-management-plus.apim-cli</groupId>
	<artifactId>apimcli-apps</artifactId>
	<version>1.2.1</version>
</dependency>

Manage Organizations

<dependency>
	<groupId>com.github.axway-api-management-plus.apim-cli</groupId>
	<artifactId>apimcli-organizations</artifactId>
	<version>1.2.1</version>
</dependency>

Manage Users

<dependency>
	<groupId>com.github.axway-api-management-plus.apim-cli</groupId>
	<artifactId>apimcli-users</artifactId>
	<version>1.2.1</version>
</dependency>