Installation

Install API Gateway on Linux using the provided installer.

10 minute read

Prerequisites

  • You have downloaded the installation setup file for your target operating system from Axway Support. The download instructions are in the welcome letter that Axway sent you in an email message.
  • You have obtained a valid Axway license file for API Gateway, and optionally API Manager or API Gateway Analytics. Also, if you intend to run API Gateway in FIPS-compliant mode, you have ensured that your license file allows this. You can obtain the required licenses from your Axway account manager.
  • You have obtained a valid McAfee license file if you intend to use the McAfee Anti-Virus filter.
  • You have reviewed the prerequisites and system requirements and have ensured that your target system is suitable.

Installation modes

The API Gateway installer has the following installation modes:

  • GUI mode
  • Unattended command-line mode

The following sections describe how to start the installer in GUI mode and the options that you are presented with when performing a GUI mode installation:

Start installation

To run the API Gateway installer in the default GUI mode, locate and run the Linux setup file. For example:

APIGateway_7.7_Install_linux-x86-32_BN<n>.run

Follow the instructions on each window to complete the installation.

To run the setup in unattended mode, see Unattended installation.

Installation options

When you run the installation setup file it launches in GUI mode by default. The following sections detail the installation options in GUI mode.

Welcome

When you run the setup file in GUI mode, you are presented with an introductory welcome window. Click Next to continue with the installation.

License agreement

Read the Axway standard license terms, and click I accept the agreement to accept the terms. You cannot proceed with the installation until you make a selection. If you click I do not accept the agreement, the installer exits.

Click Next to continue.

Select setup type

You can install API Gateway using the following setup types.

Standard

Select this option to install all API Gateway components without API Manager. This includes API Gateway Analytics, the QuickStart tutorial, Apache Cassandra database, Discovery and Traceability agents, package and deployment tools, Policy Studio, and Configuration Studio.

Complete

Select this option to install all API Gateway components with API Manager. This includes API Manager, API Gateway Analytics, the QuickStart tutorial, Apache Cassandra database, Discovery and Traceability agents, package and deployment tools, Policy Studio, and Configuration Studio.

Custom

You must select this option if you are upgrading from a previous API Gateway version. For more details, see the API Gateway Upgrade Guide.

Select this option to customize which components are installed. You can install each API Gateway component separately. The API Gateway installer enables you to perform the following:

QuickStart tutorial

The Standard and Complete setup types install the QuickStart tutorial by default, or you can select to install it during the Custom setup type. This installs a preconfigured domain and API Gateway instance. If you do not install the QuickStart tutorial, you must configure a domain and API Gateway instance when the installation is complete. For more details, see Initial configuration.

Click Next to continue.

Select components

This window is only displayed during an Custom installation.

Select the components to be installed, and deselect those that are not to be installed. The following components are selected by default:

  • API Gateway Server
  • Admin Node Manager
  • Discovery and Traceability agents
  • Policy Studio desktop tool

Click Next to continue.

Specify installation directory

Enter a location or click the browse button to specify the directory where the gateway components are to be installed, for example: /opt/Axway-7.7, and click Next to continue.

Specify license file

Enter the location or click the browse button to specify a valid Axway license file. For more details, see Software and license keys.

Note that API Gateway, API Gateway Analytics, and API Manager each require a valid Axway license file. If you have separate license files for each of these components, specify the API Gateway license at this step, and you will be prompted for the API Gateway Analytics and API Manager license files at a later step. Alternatively, you can specify a single license file that covers all licensed components.

Cassandra configuration

If you selected to install an Apache Cassandra database, configure the following settings:

  • Installation Directory Enter the directory in which to install the Cassandra server (for example, /opt/db/cassandra).

  • JRE Location Enter the directory of the Java Runtime Environment used by Cassandra. The default value is the location of the JRE provided by API Gateway (for example, INSTALL_DIR/apigateway/Linux.x86_64/jre/bin). If you have installed a separate JRE for Cassandra, enter its location instead.

    For details of the Cassandra JRE requirements and recommendations, see Cassandra prerequisites.

Set the administrator credentials for the Admin Node Manager

It is important to secure your API Gateway system to protect it from internal and external threats. This window enables you to set the administrator user name and password used to log in to Policy Studio and API Gateway Manager. These administrator credentials are also used by managedomain when connecting to an Admin Node Manager.

Select Change the default user name and password to set the user name and password for the administrator account, and enter a username and password. This option is selected by default to ensure that you set your own administrator user name and password. To use a default administrator user name and password, you must deselect this option. The default credentials are available from your Axway account manager.

Click Next to continue.

Specify QuickStart Node Manager details

This window is only displayed if you selected to install the QuickStart tutorial.

Configure the following settings for the Node Manager:

  • Host Name or IP Address: Select a host address from the list (defaults to the installation host name).
  • Local Management Port: Enter the local port used to manage the Node Manager. Defaults to 8090.

Click Next to continue.

Specify QuickStart server details

This window is only displayed if you selected to install the QuickStart tutorial.

Configure the following settings:

  • Local Management Port: Enter the local port that the Node Manager uses to manage the gateway instance. Defaults to 8085.
  • External Traffic Port: Enter the port that the gateway uses for message traffic from external clients. Defaults to 8080.

Click Next to continue.

Specify Discovery and Traceability agents configuration

Configure the following settings:

  • Discovery agent name: Enter the name of the Discovery agent.
  • Traceability agent name: Enter the name of the Traceability agent.
  • Amplify Central Organization ID: Enter the Organization ID from Amplify Central. You can find this value at Platform > User > Organization.
  • Private key: Enter the private key associated with the service Account.
  • Public key: Enter the public key associated with the service Account.
  • Amplify Central URL: Enter the URL to the Amplify Central instance, which the agents are using.
  • Service Account Client ID: Enter the client identifier associated to the service account created in Amplify Central. You can find this value at Access > Service Accounts > Client ID.
  • Amplify Central Environment Name: Enter the name of the Amplify Central environment where the APIs will be hosted.
  • Amplify Central Authentication URL: Enter the Amplify login URL.

Click Next to continue.

Set the administrator credentials for API Manager

It is important to secure your API Manager system to protect it from internal and external threats. This window enables you to set the API administrator user name and password used to log in to the API Manager web console.

Select Change the default user name and password to set the user name and password for the API administrator account, and enter a user name and password. This option is selected by default to ensure that you set your own API administrator user name and password. To use a default API administrator user name and password, you must deselect this option. The default credentials are available from your Axway account manager.

Click Next to continue.

Set the administrator credentials for API Gateway Analytics

It is important to secure your API Gateway Analytics system to protect it from internal and external threats. This window enables you to set the administrator user name and password used to log in to the API Gateway Analytics web console.

Select Change the default user name and password to set the user name and password for the administrator account, and enter a user name and password. This option is selected by default to ensure that you set your own administrator user name and password. To use a default administrator user name and password, you must deselect this option. The default credentials are available from your Axway account manager.

Click Next to continue.

Installation summary

The installer displays a summary of the components that will be installed on your system.

Review the information and click Next to begin installing.

Installing

A progress window is displayed showing the progress of the installation. When the installation is complete, click Next to continue.

Installation complete

A window is displayed to indicate that the installation is complete. If you selected to install Policy Studio you can select the option to Launch Axway Policy Studio.

The URL of the Admin Node Manager is displayed (for example, https://127.0.0.1:8090). You can go to this URL in your browser to access the API Gateway Manager tools.

Click Finish to complete the installation. Policy Studio is launched if you selected that option. If you selected to install the QuickStart tutorial, it is also launched in a browser window.

Uninstall API Gateway with uninstaller

After you run the installer for the first time, it creates an uninstaller file (uninstall.exe) and a file to store the items configuration (uninstall.dat). After that, every time that you rerun the installer, it overwrites the uninstall.dat with the most recently added items.

The uninstaller does not take any options, it only prompts you to confirm that you wish to uninstall. After you confirm, it will then remove the files added by the prior run according to the data present in uninstall.dat. This means that if the installer was run more than once, only the most recently added items will be removed.

The uninstaller does not remove your apiprojects folder.

Manually uninstall API Gateway

To uninstall API Gateway manually:

  1. Run killall vshell to stop any running instances or Node Managers
  2. Delete the install directory, as well as any init.d or systemd service scripts that might have been created by the user to automatically start gateway components on restart.

On Windows platforms, the client tools can be uninstalled by deleting the installation directory. There are no registry entries.