In this article, you will learn how to install Wyn Enterprise on Linux using docker.

To Install

Follow the below steps to install Wyn Enterprise using docker on Linux.

1. Download and install Docker Desktop for Linux.

2. Once the installation is complete, open the terminal.

3. Download the docker image from the public registry, using the following command.

   sudo docker pull grapecityus/wyn-enterprise

   By default, this command pulls the image with the latest tag.

4. Create and start the docker container, using the following command.

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

   A container with the name 'wyn' is created and starts running in the background.

   Tip: Wait for a few minutes for the Wyn services to get started.

5. Open a web browser and visit the Wyn Enterprise portal, which is, http://{server_ip_address}:51980.

6. If the above link opens successfully, a Trial Information Registration page appears requesting user registration details such as its name, company name, email address, phone, city, state, country, and preferred contact.

   Note that the user's name, company name, and email are mandatory fields that should be filled in to complete the trial registration form.

   
   

   
   

   Note: This page only appears when you access Wyn Enterprise for the first time.

   The other way to provide the registration information for the users and skip the above registration form is through the environmental variables. For more information on environmental variables, please see this section.

7. Click Register to start working with Wyn Enterprise.

Environmental Variables

The following list of environmental variables is supported by Wyn Enterprise. Use the -e flag to set the environmental variables for the docker container which you are running.

Examples

Following are a few examples of using environmental variables in the commands.

1. Use an External Database

To store data in an external database, you must pass the database configuration details to the docker container using the environmental variables. The database configuration details include type, username, hostname, password, port, and service (available only in the case of Oracle). By default, Wyn Enterprise stores the data in the built-in PostgreSQL database.

In the below example, you will see that a SQL Server database is used for storing the data in Wyn Enterprise.

sudo docker run \
  --name wyn \
  -p 51980:51980 \
  -h "{host_name}" \
  -e DB_PROVIDER="SqlServer" \
  -e DB_HOST="gces-dev1.southeastasia.cloudapp.azure.com" \
  -e DB_PORT= 9786 \
  -e DB_USER="sa" \
  -e DB_PASSWORD="********" \
  -d grapecityus/wyn-enterprise

2. Mount External Volume

Opting to store data within the internal PostgreSQL database results in potential data loss when generating a new Docker container. To prevent this scenario, you have the option to ensure data persistence by mounting an external volume, such as /postgresql_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

3. Avoid Import of Wyn Samples

To prevent the import of Wyn Samples, set the Import Samples environmental variable to false. By default, the value of the Import Samples is true.

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

4. Set Database Mode

To store the data in a single database, set the SINGLE_DATABASE_MODE environmental variable to true.

sudo docker run \
  --name wyn \
  -p 51980:51980 \
  -e SINGLE_DATABASE_MODE="true" \
  -e DB_PROVIDER="SQLite" \
  -v /wyn/conf:/wyn/conf \
  -v /wyn/logs:/wyn/logs \
  -v /wyn/data:/wyn/wyndbs \
  -d grapecityus/wyn-enterprise

5. Establish SSL connection

To provide support for SSL connection in the docker container, follow the below steps,

i) Attach your SSL certificates to the directory path /usr/local/share/ca-certificates/wyn within the Docker container.

ii) Configure the environment variable REQUIRE_HTTPS to the value true.

iii) Define your certificate file name through the environment variable SSL_CERTIFICATE_FILE, and specify your certificate key file name using the environment variable SSL_CERTIFICATE_KEY_FILE

iv) Set your site name using the environment variable SITE_NAME.

v) Connect the Docker container's exposed port 443 to a designated local port on your system.

To establish an SSL connection you need to pass the relevant information with the help of environment variables, as shown in the below example.

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

6. Trial Registration

When you request a trial experience, you are required to register with Wyn Enterprise by providing the following details - name, company name, email address, phone, city, state, and country. This is because only a registered user can work with Wyn Enterprise on a trial basis.

The trial registration information can be passed to the docker container using the environmental variables, as shown in the below example.

Note: The specification of the user's name, company name, and email address is necessary to complete the registration process.

sudo docker run \
  --name wyn \
  -p 51980:51980 \
  -e TRIAL_USER_NAME="John" \
  -e TRIAL_USER_COMPANY="ABC" \
  -e TRIAL_USER_EMAIL="John@ABC.com" \
  -d grapecityus/wyn-enterprise

After successful registration, you can open the Wyn Enterprise portal and log in by entering your usernames and passwords.

However, if you skips or forgets to pass the registration information through the environmental variables, a Trial Information Registration page will display on opening the Wyn Enterprise portal. This page requests you to enter their respective registration information. For more information about the Trial Information Registration page, please see this section.

To Remove the Docker Container

Follow the below steps to delete the docker container running Wyn Enterprise.

1. Use the following command to get the docker container ID.

   sudo docker ps 

2. Stop the docker container running Wyn Enterprise using the following command.

   sudo docker container stop [container_id]

3. Delete the stopped container running Wyn Enterprise, using the following command.

   sudo docker container rm [container_id]