Installation
10 minute read
Note
Windows is supported only for a limited set of developer tools, see Install developer tools on Windows. API Gateway and API Manager do not support Windows.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:
- Install the API Gateway server
- Install the QuickStart tutorial
- Install the Admin Node Manager
- Install Policy Studio
- Install API Tester
- Install Configuration Studio
- Install API Manager
- Install Discovery and Traceability agents
- Install the Package and Deploy tools
- Install API Gateway Analytics
Note
The API Tester component is deprecated, and is only installed in a Custom setup.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
).Caution
Do not install Apache Cassandra in the same directory as the API Gateway components to avoid errors during the Cassandra upgrade. -
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.
Caution
Ensure that you remember these credentials or you will not be able to log in to Policy Studio or API Gateway Manager. This is especially important when planning to install Policy Studio on Windows later because you do not have the option to set the credentials then.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
Note
The values of the Discovery and Traceability agents configuration variables must match the values defined in Amplify Central. For more information, see Agent Configuration.
If you do not know the values, you can leave the settings blank and edit the relevant configuration file after the installation.
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.
Caution
Ensure that you remember these credentials or you will not be able to log in to API 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.
Caution
Ensure that you remember these credentials or you will not be able to log in to API Gateway Analytics.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:
- Run
killall vshell
to stop any running instances or Node Managers - Delete the install directory, as well as any
init.d
orsystemd
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.