Post-installation

This topic describes various tasks that you might perform after installing API Gateway. This includes how to check if an installation has been successful, any initial configuration needed before you can start API Gateway, what you should do to secure API Gateway, and so on.

This topic includes the following:

Verify the installation

To verify your installation, follow these guidelines:

  • Check the installation results
  • Start API Gateway components
  • Log in to the API Gateway tools

Check the installation log

You can examine the installation log in the root directory of the installation (for example, Axway-installLog.log).

Start API Gateway components

Log in to the API Gateway tools

Initial configuration

Depending on the installation options you selected, the following tasks might need to be completed before you can start API Gateway.

Create a new domain

If you did not install the QuickStart tutorial, you must use the managedomain script to create a new managed domain that includes an API Gateway instance. You can run the script from the following directory

INSTALL_DIR/apigateway/posix/bin

For more details on running managedomain, see Configure an API Gateway domain in the API Gateway Administrator Guide.

Run API Gateway on privileged ports

API Gateway is run as a non-root user to prevent any potential security issues with running as the root user. To enable API Gateway to listen on privileged ports when running as non-root, you must perform the steps in Run API Gateway on privileged ports in the API Gateway Administrator Guide. If you do not perform these steps, the following error is reported during API Gateway startup:

ERROR   ...  failed to listen on address 0.0.0.0/80: Permission denied. can't bind socket to address

Set up a database for API Gateway Analytics

If you installed API Gateway Analytics, you must set up a JDBC-compliant database, before you can start API Gateway Analytics:

  • First, you must install and configure a database to store the monitoring and transaction data read by API Gateway Analytics.
  • Next, you must configure API Gateway Analytics to use this database instead of the default MySQL database stored on the local machine.

For more details, see the API Gateway Analytics User Guide.

Alternatively, if you installed API Manager, see Install and configure a metrics database.

Secure API Gateway

It is important to secure your API Gateway system to protect the API Gateway environment from internal or external threats. For more details on securing API Gateway, see Manage API Gateway security in the API Gateway Administrator Guide.

Change default passwords

If you did not set an administrator user name and password during installation, you should change the default administrator user name and password now.

Change default certificates

The default certificates used to secure API Gateway components are self-signed. You can replace these self-signed certificates with certificates issued by a Certificate Authority (CA).

Encrypt API Gateway configuration

By default, API Gateway configuration is unencrypted. You can specify a passphrase to encrypt API Gateway instance configuration.

Set up services

This section explains how to run various components as services.

API Gateway

You can run Node Managers and API Gateway instances as services using the managedomain script. To register a Node Manager or an API Gateway instance as a service on UNIX/Linux, you must run the managedomain command as root. For example:

  • Node Manager: Enter managedomain --menu, and choose option 2, Edit a host.
  • API Gateway instance: Enter managedomain --menu, and choose option 10, Add script or service for existing local API Gateway.

Alternatively, you can run managedomain in command mode with the --add_service option to create a service for a Node Manager or API Gateway instance.

For more details on managedomain, see the API Gateway Administrator Guide.

API Gateway Analytics

You can also run the API Gateway Analytics server as a service by creating a script. A sample script and ReadMe is provided in the following directory:

INSTALL_DIR/analytics/posix/samples/etc/init.d/

Apache Cassandra

For details on running Apache Cassandra as a service, see Install an Apache Cassandra database.

Set up clustering

To set up API Gateway for high availability, you need to configure an external Apache Cassandra database for clustering. For more information, see the following topics:

Next steps

Consult the API Gateway Administrator Guide for more information on administering, managing, and troubleshooting an API Gateway system. This guide contains many topics that you will find useful after installing API Gateway. For example:

  • Manage an API Gateway domain
  • Configure API Gateway for high availability
  • Backup and disaster recovery
  • Manage user access

Related Links