Docker Environment

1. Docker Environment

It can start iPLAss with Docker. We provide two patterns of Docker images.

  • iplass/iplass (Enterprise Edition version is iplass/iplass-ee .)
    iPLAss’s docker image for the Web server bundled with Tomcat. To have it run in practise, the supported Database and corresponding JDBC driver is required.

  • iplass/iplass-standalone (Enterprise Edition version is iplass/iplass-ee-standalone .)
    iPLAss docker image which has the Web server bundled with Tomcat and database bundled with MySQL, along with all necessary libraries packaged.

The iPLAss installer (war) is deployed in the Docker image Tomcat.

2. Get Docker image

Get the Docker image by one of the following methods.
If you have a DB server, use iplass/iplass (Enterprise Edition version is iplass/iplass-ee .), if you don’t have a DB server, use iplass/iplass-standalone (Enterprise Edition version is iplass/iplass-ee-standalone .).

  1. Get the Docker image from Docker Hub.

    $ docker pull iplass/iplass
    $ docker pull iplass/iplass-standalone
  2. (in the case of Enterprise Edition) Get the Docker image in tarball format from our Enterprise Edition’s DownloadSite and load the Docker image.

    $ docker load --input iplass-ee-x.x.x.tar.gz
    $ docker load --input iplass-ee-standalone-x.x.x.tar.gz

3. Start Docker container

Start Docker as follows.

  • iplass/iplass (Enterprise Edition version is iplass/iplass-ee .)

    $ docker run -p 8080:8080 -v [IPLASS_HOME's mount directory]:/var/lib/iplass iplass/iplass

    See below for details of startup methods and configurable environment variables.
    https://hub.docker.com/r/iplass/iplass

  • iplass/iplass-standalone (Enterprise Edition version is iplass/iplass-ee-standalone .)

    $ docker run -p 8080:8080 iplass/iplass-standalone

    See below for details of startup methods and configurable environment variables.
    https://hub.docker.com/r/iplass/iplass-standalone

4. Setup

After starting the Docker container, refer to the following procedure.

  • iplass/iplass (Enterprise Edition version is iplass/iplass-ee .)
    Please refer to 「3. Show the setup interface screen.」of Install and Run and so on.

  • iplass/iplass-standalone (Enterprise Edition version is iplass/iplass-ee-standalone .)
    Please refer to 「6. Access the tenant」of Install and Run and so on.

5. Next Step

For iPLAss beginners, it would be the best to start with the Tutorial to learn iPLAss’s amazing features.