Document Management
How To and Troubleshooting
In this article, you will learn how to install Wyn Enterprise on Linux using docker.
Follow the below steps to install Wyn Enterprise using docker on Linux.
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.
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.
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 the user accesses 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.
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.
Following are a few examples of using environmental variables in the commands.
For storing data in an external database, users 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).
In the below example, we can 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
If the user chooses to store the data in the built-in PostgreSQL database, then the data stored would get lost on the creation of a new docker container. In such a case, a user can mount an external volume (for example - /postgresql_data) to persist 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
Set the Import Samples environmental variable to 'false' to avoid the import of Wyn samples.
sudo docker run \ --name wyn \ -p 51980:51980 \ -e IMPORT_SAMPLES="false" \ -d grapecityus/wyn-enterprise
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" \ -d grapecityus/wyn-enterprise
To provide support for SSL connection in the docker container, 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
When a user requests a trial experience, he is 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 by 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, users can open the Wyn Enterprise portal and log in by entering their usernames and passwords.
However, if a user 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 users to enter their respective registration information. For more information about the Trial Information Registration page, please see this section.
Follow the below steps to delete the docker container running Wyn Enterprise.
Use the following command to get the docker container ID.
sudo docker ps
Stop the docker container running Wyn Enterprise using the following command.
sudo docker container stop [container_id]
Delete the stopped container running Wyn Enterprise, using the following command.
sudo docker container rm [container_id]