Wildfly & EAP

Overview

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.

Download

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

Unpack

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

Run WildFly

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.

Logging In

Once Apiman is running, you should be able to log in to the API Manager by pointing your browser at the following URL:

http://localhost:8080/apimanui/

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/.