Installing the Micro Gateway for the Professional and Enterprise offering

Install the Micro Gateway and add it to the Catalog.

1. Add the Micro Gateway as an application:
   1. Start the IBM API Connect API Manager user interface.

      https://<API_manager_hostname>/apim

      Note: To be able to log in to the Management server to use the API Manager user interface, you must either be the owner of a provider organization or have been added to a provider organization; for more information, see Creating a provider organization account and Adding users and assigning roles.
   2. If you have not previously pinned the UI navigation pane, click the Navigate to icon .
      The API Manager UI navigation pane opens. To pin the UI navigation pane, click the Pin menu icon .
   3. On the Dashboard page, click Add > App.
   4. Enter a display name and name for the application (microgateway for example), select the collective that you want to publish the Micro Gateway to, then click Add .
   5. Click the Show app identifier icon and copy the command string from the App Identifier window.

   For more information about Apps in the API Manager user interface, see Working with Apps.

2. Set the environment for the deployment by using the developer toolkit CLI.
   For details on installing and using the developer toolkit CLI, see Working with the toolkit.
   1. Open a command window.
   2. Paste and run the command that you copied in step 1.e; the command has the following form:

   apic config:set app=apic-app://API_manager_hostname/orgs/org_name/apps/app_name

   For example:

   apic config:set app=apic-app://myhost.com/orgs/myorg/apps/microgateway

3. Change to the directory that contains API Connect and create the Micro Gateway by entering the command.

   apic microgateway

4. When prompted, enter an application project name for the Micro Gateway; for example, microgw-app.
5. When prompted, enter a folder name to be created for the Micro Gateway application project; for example, microgw-app.
6. Create the public and private keys and copy them into the Micro Gateway application project folder. The following commands use OpenSSL, an open source implementation of the SSL and TLS protocols.
   1. Create the RSA private key.

      openssl genrsa -out id_rsa 4096

   2. Create the public key.

      openssl rsa -in id_rsa -outform PEM -pubout -out id_rsa.pub

   3. Copy the key files to the Micro Gateway application project folder.
7. Optional: Configure any user-defined policies; for more information, see Packaging and importing your policies into IBM API Connect.
8. Publish the Micro Gateway.
   1. Log in to your IBM API Connect Management server.

      apic login

      Specify the host name and login details for your IBM API Connect Management server. If you do not know the host name of your Management server, contact your IBM API Connect cloud administrator. To be able to log in to the Management server, you must either be the owner of a provider organization or have been added to a provider organization; for more information, see Creating a provider organization account and Adding users and assigning roles.

   2. Ensure that you are in the Micro Gateway application project folder.
   3. Publish the gateway.

      apic apps:publish