[]
        
(Showing Draft Content)

Installing on Ubuntu

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

  1. Install ASP.NET Core 6.0 Runtime library. The minimum supported version is 6.0.2.

    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-6.0
  2. Install the database server. The databases supported by Wyn 6.1 are PostgreSQL, SqlServer, MySQL, and Oracle, Wyn will install a PostgreSQL server automatically if you do not want to install the database server by yourself.

  3. Add the package source of Wyn Enterprise - run the following command.

    sudo bash -c 'echo "deb http://wyn-repos.grapecity.com/packages/apt/6.1/en/ /" > /etc/apt/sources.list.d/wyn-6.1.list'
  4. Add the public key of the apt repository of Wyn Enterprise - run the following command.

    wget -q -O - http://wyn-repos.grapecity.com/packages/wyn.enterprise.pubkey | sudo apt-key add -
  5. Update packages list.

    sudo apt-get update


  6. Install the latest version of Wyn Enterprise.

    sudo apt-get install wyn-enterprise


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

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


  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 built-in or custom databases 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 the PostgreSQL server during installation.

    Database selection in Wyn Enterprise


  10. Choose whether to save the data to a single or multiple database(s). If you select a single database, the data is stored in one database i.e. wyn. Else, it is stored in three databases, i.e. wynserverdata, wyndatacache, and wynis.

    Database selection in Wyn Enterprise


  11. 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


  12. Then, choose whether to import the Wyn sample documents. Importing samples helps beginners learn how to use Wyn Enterprise.

    Import Wyn sample documents


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

Silent Installation

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

  • s: Indicates whether to perform the silent installation.

  • d: Refers to the database provider which you want to use for Wyn Enterprise. The supported database providers are 'Postgres', 'SqlServer', 'MySql', and 'Oracle'. Use the built-in database if this argument is not provided.

  • c: Refers to the database connection string.

  • m: Refers to the modules that you want to install on the server. The available modules are 'Server', 'ReportingWorker', 'DashboardWorker', and 'CotWorker'.

  • i: Indicates whether to import the Wyn 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 'Server' module on the server.

  • k: Refers to the license key that will be used for registering to the Wyn Enterprise system during the installation process.

  • v: Indicates the exact version number of Wyn Enterprise that you want to install on the server. The latest version of Wyn Enterprise will be installed if you do not specify this argument.

  • h: Shows the help information.

To perform the silent uninstallation, execute the script file 'ubuntu-uninstall.sh' with the following arguments:

  • s: Indicates whether to perform the silent uninstallation. Use the interactive uninstallation mode if this argument is not provided. Also, this argument is optional.

  • r: Indicates whether to remove the built-in database when uninstalling Wyn Enterprise from the system.

  • f: Indicates whether to remove all the contents of Wyn Enterprise from the system.

Some Examples

  • To install all the modules with the default 'Postgres' database provider on the 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 the 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 the 'Server' and 'Portal' module with the default 'Postgres' database provider on the 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 the 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.xxxx.x
  • 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 the version list.

    apt-cache policy wyn-enterprise
  • To uninstall.

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