[]
        
(Showing Draft Content)

Perform GUI Installation

When you install Wyn Enterprise in GUI mode, there are prompt messages and dialog boxes to help with the installation process. A series of screens also appear during the GUI installation process. In this article, you will learn how to install Wyn Enterprise using the GUI mode on Windows.

To Install Wyn Enterprise

Follow the below steps to install Wyn Enterprise on Windows.

  1. Download Wyn Enterprise.

    Note: You can also download the latest Online or Offline Windows Installer from the following link:


    Online Windows Installer


    Offline Windows Installer

  2. Double-click the downloaded installer (.exe) to start the installation process. The installer will prompt you to install PostgreSQL.


  3. Click the Next button to start the installation.

    Wyn Enterprise Installer


  4. Confirm the software agreement, set the installation directory, and click the Next button. By default, the files for a newly installed application in a system are stored here, C:\Program Files.

    You can also enable the option to encrypt the connection string in the configuration file here. For more information on encrypting or decrypting a connection string, visit this topic.

    Confirm the software agreement for Wyn Enterprise Installer


  5. To import the Wyn sample documents, select the Import sample documents option. Importing samples helps beginners learn how to use Wyn Enterprise.

    To enable deployment of Wyn Enterprise as a single process using the SQLite database as the primary database and DuckDB as the analysis database select the Enable single-process deployment option and click the Next button to continue with the installation. See the Single-Process Deployment section for more information on using the lite version of Wyn Enterprises.

    Select components to install


  6. In the Credentials form, confirm the credentials for the admin login and click the Next button.

    Confirm the Admin credentials


  7. In the Software Registration form, fill in the details, and click the Install button. The registration details include the user's name, company, email, phone, city, state, country, and preferred mode of contact.

    Filling details in Software Registration Form


  8. Depending on your OS, the installer may ask for your permission to allow the application to make changes on your device, click Yes to continue.

    run-installer


    The installation process starts.

    Installation Progress Bar


  9. By default, Wyn Enterprise uses a built-in database for storing data. However, you can also use a custom database to meet your business requirements.


    • To use a built-in database, select the Built-in Database option and click the Start Program button to proceed further.

      Database selection in Wyn Enterprise


    • To use a custom database, select the Custom Database option and enter its corresponding configuration details in the form. For more details, see the Custom Database Configuration Options section.

      Database selection in Wyn Enterprise


      Verify the database configuration details using the Test Connection button, and then click the Start Program button to proceed further.

      Note: The installation process won't start till the database connection test is successful.

  10. Wait until the installation is finished.

    Wyn Enterprise Installation


    After the installation is complete, click Open Portal to open the Wyn Enterprise portal - http://localhost:51980 in the browser. The default credentials (if not changed while installation) that should be used are:

    Username: admin

    Password: admin

Single-Process Deployment

The lite version of the Wyn Enterprise application uses SQLite as the primary database. You can also select the PostgreSQL database as the built-in database on the Database Settings part of the Wyn installation process.

SingleDeployment-buil-inDatabase


With the single-process deployment of Wyn Enterprise, all the workers (Report, Dashboard, COT, etc.) and services (Identity, Scheduler, MemoryDB, etc.) are embedded in a single process that significantly reduces the general memory usage.

SingleDeployment-services

Note: The lite version of Wyn Enterprise uses DuckDB as the embedded analytic and memory database.

Limitations of Single-Process Deployment

A few limitations of using the lite version through the Single-Process Deployment are listed below,

  1. Before using the lite version of Wyn Enterprise on a machine, you must install .NET6.0 runtime and VC++2015-2022.

  2. You cannot switch to the lite version from the standard version.

  3. You cannot switch to the standard version from the lite version.

  4. The databases for primary, extraction, identity, and distributed cache databases are strictly configured to use SQLite, with no option to switch to other database types via Wyn.conf or appsettings.json.

  5. The analysis database is exclusively configured to utilize embedded DuckDB, and modifications to employ either MonetDB or ClickHouse through Wyn.conf or appsettings.json are not permissible.

  6. In the lite version, external co-workers or report workers canont establish connections, as they are integrated directly within the server process.

  7. In the admin portal, the Node Management, System Diagnostic, and System Configuration sections have been removed due to the reduced importance of the Monitor service in the lite version.

  8. Initially, Java-based data sources are unavailable in the lite version. You must download a specific Java program to enable support for these data sources if required.

  9. The final installer/artifact is specific to the operating system/platform. Multiple artifacts/installers will be provided for the supported operating systems/platforms.

  10. Multiple instances of the light version application connecting to the same (SQLite/DuckDB) databases are not permitted.

Custom Database Configuration Options

To use a custom database, you are required to enter its corresponding database configuration details during the installation process. In Wyn Enterprise, you can connect to any of the following database types - Microsoft SQL Server, MySQL, PostgreSQL, and Oracle. The configuration details for each database are different and are described in the below tables.

Configuration Options for Microsoft SQL Server

The below table lists the database configuration options for Microsoft SQL Server.

Option

Description

Database

Select the type for the database. Over here, set it to Microsoft SQL Client.

Single database mode

Choose whether to save the data to a single or multiple database(s).

If you select this option, the data is stored in one database i.e. wyn. Else, it is stored in three databases, i.e. wynserverdata, wyndatacache, and wynis.

Authentication

Select whether to use Windows Authentication or SQL Server Authentication. If you chose Windows authentication, enter the user name and password for the database connection. Else, enter the service account details.

Host*

Enter the host name or address.

Port

Enter the port number, the default is 1433.

Extra Options

Specify the necessary options for the database connection.

* Required fields

Configuration Options for MySQL

The below table lists the database configuration options for MySQL.

Option

Description

Database

Select the type for the database. Over here, set it to MySQL.

Single database mode

Choose whether to save the data to a single or multiple database(s).

If you select this option, the data is stored in one database i.e. wyn. Else, it is stored in three databases, i.e. wynserverdata, wyndatacache, and wynis.

Host*

Enter the host name or address.

Port

Enter the port number, the default is 3306.

User Name*

Specify the user name to connect to the MySQL database.

Password*

Specify the password to connect to the MySQL database.

Extra Options

Specify the necessary options for the database connection. For example, 'SSL MODE', 'CertificateFile', and 'CertificatePassword'.

* Required fields

Note: The maximum allowed packet size in the MySQL database should not be less than 300 MB.

Configuration Options for PostgreSQL

The below table lists the database configuration options for PostgreSQL.

Option

Description

Database

Select the type for the database. Over here, set it to PostgreSQL.

Host*

Enter the host name or address.

Port

Enter the port number, the default is 5432.

User Name*

Specify the user name to connect to the PostgreSQL database.

Password*

Specify the password to connect to the PostgreSQL database.

Extra Options

Specify the necessary options for the database connection.

* Required fields

Configuration Options for Oracle

The below table lists the database configuration options for Oracle.

Option

Description

Database

Select the type for the database. Over here, set it to Oracle.

Host*

Enter the host name or address.

Port*

Enter the port number, the default is 1521.

User Name*

Specify the user name to connect to the Oracle database.

Password*

Specify the password to connect to the Oracle database.

Service Name*

Specify the service name for the Oracle database.

Extra Options

Specify the necessary options for the database connection.

* Required fields

To Uninstall Wyn Enterprise

Follow the below steps to uninstall Wyn Enterprise on Windows.

  1. Go to the Control Panel, select Programs > Uninstall a program.

  2. From the list of installed programs, double-click Wyn Enterprise or right-click Wyn Enterprise and select the Uninstall/Change option.

    uninstallwyn

  3. When uninstalling, you can specify whether to preserve the Wyn database using the Remove Database option. Note that once the database is removed, you cannot roll back this operation.

    Removing Database

  4. Click the Uninstall button to proceed further. Please wait for a few minutes till the uninstallation process is completed.

    Uninstalling Wyn Enterprise

  5. Click the Close button.

    Wyn Enterprise is uninstalled successfully.

    Uninstalling Wyn Enterprise