Send Docs Feedback

Edge Demo Installation Requirements

Edge for Private Cloud v. 4.17.01

You can install Edge for the Private Cloud on a single host machine as part of a demo or proof of concept installation. This type of installation is referred to as an Edge "all-in-one" installation. The host machine can be a standalone machine or a VM that meets the system prerequisites listed below.

A single machine install is meant for a getting started and prototyping environments, not for production.   A full production installation of Edge requires multiple machines. See Installation Topologies for examples of production installations.

After you install Edge for the Private Cloud on the host machine, you can optionally install:

  • Developer Services portal on the same host machine
  • API BaaS on a second host machine

System requirements for Edge

The following table lists the system requirements for installing Edge on a single host machine:

Requirement

Description

Test

Access to Apigee RPM repo

Ensure access to https://software.apigee.com

Ensure you received a username/password from Apigee for the repo.

curl -v https://software.apigee.com returns HTTP 200

Access to your backend services

Ensure access to your backend services

curl -v http://backend to check access to your backend services

License key

Check for an email from Apigee with license key attached

Ensure license key deployed to host machine

OS Version

Supported OS version as listed at Supported software.

cat /etc/redhat-release returns the OS version

Java version

Supported Java versions:

  • Oracle JDK 1.8
  • OpenJDK 1.8

java -version returns the installed Java version

If required Java version not found, Edge installer downloads and installs it.

CPU cores

2 minimum

lscpu returns number of CPUs

cat /proc/cpuinfo returns CPU Information

RAM

8 GB minimum

cat /proc/meminfo returns memory information

Diskspace

100 GB minimum

df -h returns the disk space.

df -h /opt returns the disk space for /opt, the Edge install directory

Hostname

Hostname set to IP address of host

hostname -i returns the IP address of host

Network

External Internet access required.

For RedHat OS, access to RHEL yum repository.

yum repolist returns available repos.

For RedHat, check the availability of repos from /etc/yum.repos.d/redhat-rhui.repo

ports, iptables, firewalld

Ensure that ports 8080, 9000, 9001, and 9002 can accept incoming packets.

This requirement is dependent on your OS and OS configuration. There are several commands you can use to view the current settings:

iptables -nvL

Linux 6.x: service iptables status

Linux 7.x: sysctl firewalld status

If necessary, you can stop iptables or firewalld

SELinux

Disable SELinux, or set it to permissive mode, during install. Re-enable after install if necessary

Temporarily set SELinux to permissive mode:

On a Linux 6.x operating system:

echo 0 > /selinux/enforce

To re-enable after installing Edge:

echo 1 > /selinux/enforce

On a Linux 7.x operating system:

setenforce 0

To re-enable after installing Edge:

setenforce 1

To permanently disable SELinux, see Install the Edge apigee-setup utility.

System user access

User performing install requires:

  • sudo access or root access
  • ability to add users on host machine

sudo whoami  should return root

SMTP Server

Access to SMTP server to send emails to new Edge users.

 

System requirements for Developer Services portal

You can install the Edge Developer Services portal on the same host machine as you installed Edge. Make sure you have satisfied the following requirements before you install the portal:    

Requirements

Description

Test

Edge installed on the host

Ensure that you have already installed Edge on the host machine

See System requirements for Edge above.

Portal .tar file

Download the portal .tar file to the host machine.

1. Go to http://community.apigee.com/content/apigee-customer-support

2. Log in to Support to request the portal .tar file in one of two ways:

  • Request access to the Edge for Private Cloud download directory.
  • Request a URL to the portal .tar file.

Port

Ensure port 80 is available and accessible

netstat -nlptu | grep 80

System requirements for API BaaS

You can install API BaaS on the single host machine, different than the one you used to install Edge. Make sure you have satisfied the following requirements before you install API BaaS on the host:    

Requirements

Description

Test

All Edge requirements

Ensure that the host machine meets all the requirements listed above for Edge

See System requirements for Edge above.

ports, iptables, firewalld

Ensure that ports 9000, 8080, 9200-9400 can accept incoming packets.

This step is dependent on your OS and OS configuration. There are several commands you can use to view the current settings:

iptables -nvL

Linux 6.x: service iptables status

Linux 7.x: sysctl firewalld status

If necessary, you can stop iptables or firewalld

 

Help or comments?