Wildfly & EAP
This chapter explores downloading and installing the Apiman quickstarts which consists of both the Apiman Manager and UI and Apiman Gateway.
Installing in WildFly
Apiman can target WildFly as a runtime environment. In order to install Apiman you will need to download both WildFly and the Apiman overlay distribution. Once both are downloaded, it’s a simple matter of unpacking both into the same location.
First you will need to download both WildFly and Apiman:
wget https://download.jboss.org/wildfly/23.0.2.Final/wildfly-23.0.2.Final.zip wget https://github.com/apiman/apiman/releases/download/2.2.3.Final/apiman-distro-wildfly-2.2.3.Final-overlay.zip
Once both files have been downloaded, simply unpack both in the same location.
unzip wildfly-23.0.2.Final.zip unzip -o apiman-distro-wildfly-2.2.3.Final-overlay.zip -d wildfly-23.0.2.Final
The Apiman overlay contains everything needed to run Apiman, including:
Apiman binaries (several WAR files)
Apiman-specific WildFly configuration (standalone-apiman.xml)
Apiman RDBMS datasource (h2)
pre-configured admin user with password admin123!
pre-configured h2 database (populated with default values)
For this reason, there is no additional configuration required to run Apiman. Simply start up WildFly using the Apiman configuration file:
cd wildfly-23.0.2.Final ./bin/standalone.sh -c standalone-apiman.xml
Installing using Docker
Another option when installing Apiman is to use our docker image. You’re probably pretty familiar with docker if you’re going that route, but here is an example of how to start up the Apiman docker image:
docker pull apiman/on-wildfly:2.2.3.Final docker run -it -p 8080:8080 -p 8443:8443 apiman/on-wildfly:2.2.3.Final
|You can find Apiman on Docker Hub.|
Once Apiman is running, you should be able to log in to the API Manager by pointing your browser at the following URL:
You may log in with credentials admin/admin123!
We strongly advise that you immediately change the Keycloak admin user’s password, as well as the admin user found in the apiman realm!
You can do that by navigating to localhost:8080/auth/admin/.