Wyn Enterprise Administration Guide

Wyn Enterprise: Installing using Docker

You can install Wyn Enterprise on the docker hub using the available docker image.

The following steps describe the installation process for Linux. However, you can also use docker in Windows and Mac operating systems.

  1. Prepare a Linux server, where Docker is already installed.
    For installing Docker, please refer https://docs.docker.com/install/linux/docker-ce/ubuntu/ link.

  2. Pull the latest docker image by running the following command.

    sudo docker pull grapecityus/wyn-enterprise

  3. Create and start a docker container by running the following command.

    sudo docker run --name wyn -p 51980:51980 -d grapecityus/wyn-enterprise

    Note: Please wait for a minute for Docker to load and initialize the services.

    Wyn Enterprise is now installed. You can visit the portal of Wyn Enterprise here: http://localhost:51980.

The following points should be noted -

  • By default, Wyn Enterprise stores the data in the built-in PostgreSQL database. If you want to use an external database to store the data, you can pass the database information to the docker container.

    sudo docker run --name wyn -p 51980:51980 -h "{host_name}" -e DB_PROVIDER="{Postgres|SqlServer|MySql}" -e DB_HOST="{database_server_address}" -e DB_PORT={database_listening_port} -e DB_USER="{database_user}" -e DB_PASSWORD="{database_user_password}" -d grapecityus/wyn-enterprise

    If you want to use Oracle database to store the data, run the following command.

    sudo docker run --name wyn -p 51980:51980 -h "{host_name}" -e DB_PROVIDER="Oracle" -e DB_HOST="{database_server_address}" -e DB_PORT=database_listening_port -e DB_USER="{database_user}" -e DB_PASSWORD="{database_user_password}" -e ORACLE_SERVICE_NAME="{service_name_only_for_oracle_provider}" -d grapecityus/wyn-enterprise

  • If you use the build-in PostgreSQL database to store data, the data will be lost on creating a new docker container. You can mount an external volume (eg: /postgresql_data) to retain the data.

    sudo docker run --name wyn -p 51980:51980 -h "{host_name}" -v /postgresql_data:/var/lib/postgresql/data -v /monetdb_dbfarm:/var/monetdb5/dbfarm -d grapecityus/wyn-enterprise

  • Use the "single database mode" if you want to store all the data in one database (the name of the database is "wyn"). The default value is "false".

    sudo docker run --name wyn -p 51980:51980 -e SINGLE_DATABASE_MODE="true" -d grapecityus/wyn-enterprise

  • Set the environment variable "IMPORT_SAMPLES" to "false" to avoid the importing of built-in samples. The default value is "true".

    sudo docker run --name wyn -p 51980:51980 -e IMPORT_SAMPLES="false" -d grapecityus/wyn-enterprise

Support SSL connection

The following steps describe how to support SSL connection in your docker container.

  • Mount your SSL certificates into the path "/usr/local/share/ca-certificates/wyn" in docker container.
  • Set the environment variable "REQUIRE_HTTPS" to "true".
  • Specify your certificate file name using the environment variable "SSL_CERTIFICATE_FILE" and specify your certificate key file name using the environment variable "SSL_CERTIFICATE_KEY_FILE".
  • Specify your site name using the environment variable "SITE_NAME".
  • Map the docker container exposed port 443 to your local port.

The "docker run" command may look like this after including all the arguments discussed above.

sudo docker run --name wyn -p 443:443 -v /my/ssl/certs/location:/usr/local/share/ca-certificates/wyn -e REQUIRE_HTTPS="true" -e SSL_CERTIFICATE_FILE="my-cert.crt" -e SSL_CERTIFICATE_KEY_FILE="my-cert.key" -e SITE_NAME="my.site.com" -d grapecityus/wyn-enterprise