Wyn Enterprise: Installing on Linux

To install and use Wyn Enterprise on Linux, you need the following environment.

Requirements

Framework

  • AspNetCore 2.1 Runtime

Operating System

  • Ubuntu 14.04, Ubuntu 16.04, Ubuntu 17.10 and above
  • CentOS 7.0, RHEL 7.5

Browser

  • Internet Explorer 11 and above, Microsoft Edge, Google Chrome, etc.

Note : Before installing, please exit the anti-virus software on your computer. Our products are commercial software provided by regular manufacturers and will not adversely affect the system. Please feel free to use them.

To Install

Default Ports

Wyn Enterprise uses the following ports by default.

  • Server: 51981
  • Portal: 51980
  • ReportingWorker: 51982
  • IdentityService: 51980

You can reassign the ports in the config (Wyn.conf) file.

Check System Status

sudo systemctl status wyn

Start Wyn Service

sudo systemctl start wyn

Stop Wyn Service

sudo systemctl stop wyn

Installed Files

File Name Locations
CotWorker /opt/Wyn/
postgres /opt/Wyn/
logs /opt/Wyn/
Monitor /opt/Wyn/
Plugins /opt/Wyn/
Account /opt/Wyn/Plugins/
Dashboard /opt/Wyn/Plugins/
DataSet /opt/Wyn/Plugins/
Reporting /opt/Wyn/Plugins/
Portal /opt/Wyn/
ReportingWorker /opt/Wyn/
sampledata /opt/Wyn/
Server /opt/Wyn/
Tools /opt/Wyn/

Publish Portal to Internet

The Wyn Enterprise services listen to all IP addresses of a current server, so you can access the portal on the current server via localhost:42002 (if the server has graphical shell). Otherwise, you can access the portal on another machine via http://serverip:51980/ in intranet.

When you publish Wyn Enterprise to internet, you need to change some settings, as stated.

  • You need to bind a domain name to portal and identity service.
  • You could also use the reverse proxy.
  • Change the identity_server_url in global_settings to http://www.yourdomain.com:51988/ and add http://www.yourdomain.com:51980/ to the allowed_urls list in identity_server. Please note that allowed_urls entry requires a dash symbol.
  • You must set the portal URL and identity service in the configuration file.

The final configuration file should look as follows. On Linux, the Wyn.conf file is located here: /opt/Wyn/Monitor/Wyn.conf.

Wyn.conf
    

    # This is a YAML file. Format reference: (EN) https://en.wikipedia.org/wiki/YAML ; (ZH) https://zh.wikipedia.org/wiki/YAML.
    # You can specify the global setting in global_settings section. These settings will be applied to all services in the services section. Of course, you can override the item via specify the item in particular service section.
    # Available settings:
    #     identity_server_url: Identity server URL.
    #     enable_health_check: A value indicates if health check is enabled. The default value is true.
    #     try_restart_count: A value indicates how many time the monitor restarts the service when the service crashes.
    #     command: Define the command to run the service.
    global_settings:
        identity_server_url: 'http://localhost:51988'
        command: dotnet
        enable_health_check: true
        try_restart_count: -1
        # log_level: Error
        # redirect_output_of_service: true

    # Service section includes all service definitions.
    # There are a set of common settings. These settings are available for each Service
    # Common settings:
    #     urls: The service URLs. The value is a semicolon-separated list;
    #     disabled: A value indicates if this service is disabled. The default value is false.
    #     enable_health_check: A value indicates if health check is enabled. The default value is true.
    #     try_restart_count: A value indicates how many times the monitor restarts the service when the service crashes. If you want to try until the service is started successfully, you can specify -1.
    #     identity_server_url: Identity server URL.
    #     command: Define the command to run the service.
    #     arguments: Define the arguments that command starts the service with.
    #     working_directory: The directory that the service is started in. You don't have to specify the working directory unless you change the directory that the service is installed.
    services:
        identity_server:
            urls: 'http://:51988'
            # The extra URLs that are authorized. By default identity server adds all URLs that Wyn Enterprise runs.
            # If you want to setup the reverse proxy or use public IP address or DNS for the portal, you should add the portal's URL to allowed_urls.
            allowed_urls: 
            #    - "http://www.yourdomain.com:51980"
            #    - "http://youserver.eastus.coluadapp.azure.com:51980"

        server:
            urls: 'http://:51981'
            # You don't have to specify this item unless you change the directory that data providers were installed.
            # data_provider_directory: DataProviders
            # storage:
                # engine: Postgres

            # Plugin's path can be an absolute path or a relative path to root of install directory
            plugins:
                - 'Plugins/Dashboard/dashboard/Gces.Dashboards.Plugin.dll'
                - 'Plugins/Reporting/Gces.Reporting.Plugin.dll'
                - 'Plugins/Dataset/dataset/Gces.Dataset.Plugin.dll'
                - 'Plugins/Dataset/account/Gces.Account.Plugin.dll'

        portal:
            urls: 'http://*:51980'
            # backend:
            #    host: localhost
            #    port: 51981

        worker:
            urls: 'http://localhost:51982'
            environment: Development
            # display_name: 'reporting-worker'
            # backend:
            #    server_url: 'http://localhost:51981'