[]
        
(Showing Draft Content)

Installing on Ubuntu

To install Wyn Enterprise on Ubuntu.

  1. Install ASP.NET Core 8.0 Runtime.

Choose the Ubuntu version you have from the top of the Install .NET SDK or .NET Runtime on Ubuntu topic on Microsoft Learn and follow the instructions specific to your Ubuntu version to install the ASP.NET Core 8.0 Runtime. The minimum supported version is 8.0.3 which is available in Ubuntu 20.04 or later.

type=danger

NOTE: Please refer to Microsoft .NET Installation on Ubuntu topic on Microsoft Learn. The repository feed for the .NET packages has changed starting with Ubuntu 22.04. It is important to follow the instruction on that page to avoid .NET package mix ups.

Verify that the asp.net core greater than 8.0.3 is installed using this command dotnet --list-runtimes

  1. Install a database server (Optional). The database will be used as Wyn Enterprise data store. The supported databases are PostgreSQL, SQL Server, MySQL, and Oracle.

  2. Add the package source for Wyn Enterprise

sudo bash -c 'echo "deb https://cdn.wynenterprise.io/BI/installation/apt/8.1/ /" > /etc/apt/sources.list.d/wyn-8.1.list'
  1. Add the public key of the apt repository of Wyn Enterprise

sudo wget -q -O /etc/apt/trusted.gpg.d/wyn.enterprise.asc https://cdn.wynenterprise.io/BI/installation/apt/wyn.enterprise.pubkey
  1. Update the packages list.

    sudo apt-get update

  2. Install the latest version of Wyn Enterprise.

    sudo apt-get install wyn-enterprise

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

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

Silent Installation

To perform a 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 that you want to use for Wyn Enterprise. The supported database providers are 'Postgres', 'SqlServer', 'MySql', and 'Oracle'. If omitted, Wyn will use a built-in database SQLite database for system database.

  • c: Refers to the database connection string.

  • o: Indicates single database mode.

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

  • a: The password of the user 'admin'.

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

  • e: Encrypt the database connection string.

  • l: Install with the cluster mode, not single process mode.

  • h: Shows the help information.

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

  • s (Optional): Indicates whether to perform a silent uninstallation. Use the interactive uninstallation mode if this argument is not provided.

  • 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=<Password>;"
  • To install the Server and Portal modules 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 latest version.

    sudo apt-get install wyn-enterprise
  • To install a specific version.

    sudo apt-get install wyn-enterprise=x.x.xxxx.x
  • To upgrade, 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 the installed version.

    dpkg -s wyn-enterprise