[]
        
(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.16.

    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 database server. The databases Wyn 7.0 supports are PostgreSQL, SqlServer, MySQL, and Oracle. This step can be skipped if you want to install Wyn with the single-process mode and use "SQLite" as the data store.

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

    1. Use for the internal repository -

    sudo bash -c 'echo "deb https://cdn.mescius.com/wyn/repos/apt/7.1/ /" > /etc/apt/sources.list.d/wyn-7.1.list'
    
    1. Use for the external dev version Azure repository -

    sudo bash -c 'echo "deb https://gcesartifacts.blob.core.windows.net/artifacts-pub/linux_repos/apt/7.1-dev/en/ /" > /etc/apt/sources.list.d/wyn-7.1.list'
    1. Use for the external beta version Azure repository -

    sudo bash -c 'echo "deb https://cdn.mescius.com/wyn/repos/apt/7.1-beta/ /" > /etc/apt/sources.list.d/wyn-7.1.list'
    1. Use for the official repository -

    sudo bash -c 'echo "deb https://cdn.mescius.com/wyn/repos/apt/7.1/ /" > /etc/apt/sources.list.d/wyn-7.1.list'
  4. Add the public key of the apt repository of Wyn Enterprise using the following commands.

    1. Use for the internal repository -

    wget -q -O - http://xa-gcef-build:1071/wyn.enterprise.pubkey | sudo apt-key add -
    1. Use for the external dev repository -

    wget -q -O - https://gcesartifacts.blob.core.windows.net/artifacts-pub/linux_repos/apt/wyn.enterprise.pubkey | sudo apt-key add -
    1. Use for the official repository -

    wget -q -O - https://cdn.mescius.com/wyn/repos/apt/wyn.enterprise.pubkey | sudo apt-key add -
  5. Update the 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

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 that 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'.

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

    dpkg -s wyn-enterprise