Install API7 Enterprise

This tutorial walks you through installing API7 Enterprise in Docker using the quickstart script.

The installation will include the API7 Enterprise components, data plane, control plane, dashboard, and external components, PostgreSQL and Prometheus, for managing configuration and monitoring, respectively.

tip

In this guide, a containerized all-in-one solution for Proof of Concept (PoC) tests is provided, including PostgreSQL and Prometheus. This eliminates the need for manual database and monitoring setup, streamlining your PoC process.

For production deployments, API7 Enterprise also supports MySQL and OceanBase in place of PostgreSQL. Please contact API7 experts to get solutions for high availability and scalability.

Prerequisites

• Install Docker and Docker Compose. It is recommended to use 3.10.0-927 or higher versions. It is known that 3.10.0-327 or previous versions are incompatible.
• Install cURL.
• Obtain a 30-day free trial license.
• Operating system: It is recommended to use Linux CentOS 7.6 or higher versions. It is known that Linux CentOS 7.2 or previous versions are incompatible.

Install API7 Enterprise

curl -sL "https://run.api7.ai/api7/quickstart" | bash

You should see a response similar to the following:

✔ Container api7-ee-postgresql
✔ Container api7-ee-prometheus
✔ Container api7-ee-api7-ee-dashboard
✔ Container api7-ee-api7-ee-dp-manager
✔ Container api7-ee-api7-ee-gateway
...
✔ API7-EE is ready!

API7-EE Listening: Dashboard(https://192.168.2.102:7443), Control Plane Address(http://192.168.2.102:7900, https://192.168.2.102:7943), Gateway(http://192.168.2.102:9080, https://192.168.2.102:9443)
API7-EE Listening: Dashboard(https://26.26.26.1:7443), Control Plane Address(http://26.26.26.1:7900, https://26.26.26.1:7943), Gateway(http://26.26.26.1:9080, https://26.26.26.1:9443)
If you want to access Dashboard with HTTP Endpoint(:7080), you can turn server.listen.disable to false in dashboard_conf/conf.yaml, then restart dashboard container

(Optional) Install ADC

You can also install the API Declarative CLI (ADC) to manage API7 Enterprise declaratively.

curl -sL "https://run.api7.ai/adc/install" | bash

To verify the installation, run:

adc help

You should see the following response:

Usage: adc [options] [command]

Options:
  -V, --version      output the version number
  -h, --help         display help for command

Commands:
  ping [options]     Verify connectivity with backend
  dump [options]     Dump configurations from the backend
  diff [options]     Show the difference between local and backend configurations
  sync [options]     Sync local configurations to backend
  convert [options]  Convert other API spec to ADC configurations
  lint [options]     Check provided configuration files, local execution only, ensuring inputs meet ADC requirements
  help [command]     display help for command

See the Command Reference for more details on the available commands.

Activate API7 Enterprise

1. Visit the API7 Enterprise Dashboard at https://{your_inet_ip_addr}:7443 and log in with the default username admin and password admin.

   info

   You can also access the dashboard at https://localhost:7443/login. However, the subsequent deployment scripts generated in the dashboard will default to use localhost as the IP address, which can lead to connectivity issues, such as when deploying API7 gateway and ingress controller on Kubernetes.

2. Select the license that you want to upload and then click Upload to activate API7 Enterprise.

(Optional) Connect to API7 Enterprise with ADC

Before you can synchronize configurations to API7 Enterprise using ADC, first make sure your ADC client can authenticate and communicate with API7 Enterprise. You would need to configure a few variables either in a .env file or on the command flags.

Navigate to the API7 Enterprise Dashboard and generate a token.

Create a .env file with the following variables:

.env

ADC_BACKEND=api7ee                   # specify the backend is API7 Enterprise
ADC_TOKEN=a7ee-YVDPvh6CXxMuz5iM...   # replace with your token
ADC_SERVER=https://localhost:7443    # update server address if you are not running API7 Enterprise locally

Alternatively, you could also specify these values in command flags. See the ADC Environment Variables for more information.

To verify connectivity, run:

adc ping

You should see the following response:

Connected to the "api7ee" backend successfully!

Stop API7 Enterprise

If you have done testing API7 Enterprise, you can stop API7 Enterprise using the following command under the api7-ee directory:

bash run.sh stop

Next Steps

1. See Deploy Gateway and Ingress Controller on Kubernetes if you would like to deploy API7 gateways on Kubernetes and use an ingress controller.
2. Follow the getting started tutorials to learn more about using API7 Enterprise.
3. Deploy API7 Enterprise in a highly available configuration.
4. Book a meeting with API7 experts to start using API7 Enterprise in production.