Wyn Enterprise Administration Guide

Wyn Enterprise: Installing on Ubuntu

On Ubuntu, Wyn Enterprise can be installed using apt-get command.

  1. Install ASP .NET Core 3.1 Runtime library. The minimum supported version is 3.1.6.

    wget https://packages.microsoft.com/config/ubuntu/18.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
    sudo dpkg -i packages-microsoft-prod.deb
    sudo apt-get update
    sudo apt-get install -y apt-transport-https
    sudo apt-get update
    sudo apt-get install -y aspnetcore-runtime-3.1
    
  2. Add the package source of Wyn Enterprise - run the following command.

    sudo bash -c 'echo "deb https://prod-cdn.grapecity.com/wyn/apt/5.0/en/ /" > /etc/apt/sources.list.d/wyn.list'
    
  3. Add the public key of the apt repository of Wyn Enterprise - run the following command.

    wget -q -O - https://prod-cdn.grapecity.com/wyn/wyn.enterprise.pubkey | sudo apt-key add -

  4. Update packages list.

    sudo apt-get update

  5. Install the latest version of Wyn Enterprise.

    sudo apt-get install wyn-enterprise

  6. Configure Wyn Enterprise, execute the script and run the following command.

    sudo bash /opt/Wyn/Monitor/configure.sh

  7. A Select Modules dialog box will appear as shown. Select the components you want to install and click OK to continue with the installation process. By default, all the components are selected.

    Select components to install

  8. Then, fill in the software registration information details such as the customer name, company, email address, phone, etc.
    Filling details in Software Registration Form

  9. Choose whether you want to use the built-in or custom database such as SqlServer, MySQL, Oracle, and Azure SQL. If you do not want to install the database server by yourself, Wyn Enterprise will automatically install PostgreSQL server during installation.

    Database selection in Wyn Enterprise

  10. Specify whether you want to encrypt the database connection string in the configuration file. For more information about encrypting or decrypting a connection string, visit this topic.

    Encrypt connection strings in the conf file

    After the installation is complete, visit http://localhost:51980/ in the browser to open Wyn Enterprise portal. The default credentials (if not changed while installation) that should be used are:
    Username: admin
    Password: admin
    Wyn Enterprise Configured

Default Ports

Wyn Enterprise uses the following ports by default.

  • Server: 51981
  • Portal: 51980
  • ReportingWorker: 51982
  • Dashboard Worker: 51984
  • Cot Worker: 51983

You can reassign the ports in the wyn.conf file.

Silent Installation

To perform the silent installation, execute the script file 'install.sh' with the following arguments:

  • -s: Indicates whether to perform the silent installation.
  • -m: Refers to the modules that you want to install on this server, available values are 'Server', 'Portal', 'ReportingWorker', 'Dashboard Worker', and 'CotWorker'.
  • -d: Refers to the database provider, the supported database providers are 'Postgres', 'SqlServer', 'MySql', and 'Oracle'.
  • -c: Indicates the database server connection strings.
  • -i: Indicates whether to import the sample documents.
  • -f: Refers to the location of the custom sample data, the custom sample data should be a ZIP file exported from the Wyn Enterprise system.
  • -b: Refers to the back-end server's address, this argument must be provided if you do not want to install the module 'Server' on this server.
  • -k: The license key will be registered to the Wyn Enterprise system during the installation process.
  • -v: Indicates the exact version of Wyn Enterprise that you want to install. The latest version of Wyn Enterprise will be installed if you do not specify this argument.
  • -h: Shows the help information.

The install and uninstall script files can be downloaded from the following links:

Some Examples

  • To install all the modules with the default 'Postgres' database provider on this server and import the built-in documents, run the following command.

    sudo bash ./install.sh -si
    
  • To install all the modules with the specified 'MySql' database provider on this server and do not import the built-in documents, run the following command.

    sudo bash ./install.sh -s -d "MySql" -c "Server=localhost;Port=3306;Uid=root;Pwd=xA123456;"
    
  • To install modules 'Server' and 'Portal' with the default 'Postgres' database provider on this server and import the custom sample documents, run the following command.

    sudo bash ./install.sh -sm "Server,Portal" -if "/the/location/of/custom/sample/documents.zip"
    
  • To install modules 'ReportingWorker' and 'CotWorker' on this server, run the following command.

    sudo bash ./install.sh -sm "ReportingWorker,CotWorker" -b "10.32.5.31"
    
  • To uninstall Wyn Enterprise, run the following command.

    sudo bash ./uninstall.sh -s
    
  • To uninstall Wyn Enterprise and force delete all its contents, run the following command.

    sudo bash ./uninstall.sh -sf
    
  • To uninstall Wyn Enterprise and remove the installed built-in database, run the following command.

    sudo bash ./uninstall.sh -sr
    

More Commands

  • To install a specific version.

    sudo apt-get install wyn-enterprise=x.x.xxx
    
  • To upgrade Wyn Enterprise, run either of the commands.

    sudo apt-get update
    sudo apt-get --only-upgrade install wyn-enterprise
    

    OR

    sudo apt-get update
    sudo apt-get install wyn-enterprise
    
  • To view version list.

    apt-cache policy wyn-enterprise
    
  • To uninstall.

    sudo apt-get purge wyn-enterprise
    
  • To check which version is installed.

    dpkg -s wyn-enterprise