Skip to content

HyWorks Controller Installation

This section details the installation process for the HyWorks Controller.

Note

  • Copy the HyWorks setup locally on the the target server. Running the HyWorks setup from the UNC path is not supported and will result in a failure.
  • Running the HyWorks setup may also fail during the file extraction process, if the logged in user has a roaming profile. Hence it is recommended to log in with local administrator user credentials.

Installation Steps

Installer will run in the fresh installation mode if there has been no previous installation of the Accops HyWorks Controller and only the Administrator will be able to install the Accops HyWorks Controller or the Session Host Server. Follow the below steps to install Accops HyWorks Controller on the system in the fresh installation mode:

  1. Log in to the Windows Server using user credentials with administrative rights.

  2. Copy the Accops HyWorks Controller Installer to the Windows Server with all the prerequisites configured. Refer to the Software Requirements section to check the Software Requirements for the Accops HyWorks Controller.

  3. Right click the Installer to launch the Installation wizard and select the option Run as Administrator.

  4. Click Next to proceed with the installation.

  5. Accept the License Agreement and click Next to proceed.

  6. Change the Installation Directory, if required, and click Next to proceed. The default Installation Folder is "C:\Program Files (x86)\Accops".

  7. Select the following HyWorks Components to be installed

    1. Accops HyWorks Controller Service

    2. Accops HyWorks Management Console

    3. Accops HyWorks Reservation Management Service

    Important

    Do not check the Accops HyWorks Session Host, if you do not want to use this server for the Shared VDI or for Application Delivery.

  8. Click Next and proceed to select the database.

    1. Provide the Database Address in the format - \<Server IP or FQDN>\\<SQL Instance Name>. For example, if the SQL Express is installed on the same instance, then the Database Address could be localhost\SQLExpress for the Microsoft SQL Server Standard and Enterprise: localhost\MSSQLSERVER (for the named instance)

    2. Provide the static port of Microsoft SQL Server e.g. 1433 (Default TCP Port for SQL Server)

    3. Provide the name of the database that needs to be created. The default name is EDCDB.

    4. Select the appropriate authentication mechanism

      1. SQL Server Authentication: It will require the SQL Server User and Password.

      2. Windows Authentication: Use the Windows user credentials to connect to the SQL Server.

    Warning

    • In HyWorks v3.2, support for the embedded database for the service has been depreciated and thus, the installation process is supported with the SQL Servers only.

    • Upgrading the existing HyWorks deployments using the embedded database should not be attempted in order to avoid data loss and setup corruption. Contact Accops Support for the guidance on existing setup upgrades.

    • The VM Scale Booster feature does not support Windows Authentication.

  9. Click Next to proceed to configuring the Log Server in the Log Database Selection section. You can either use the Embedded Database (uses SQL CE 4.5 for Logs) or the Microsoft SQL Server (uses SQL Server for Logs). We recommend using the Microsoft SQL Server.

    SQL Server Logging has the following advantages over the Embedded Log Server:

    • Faster log viewing in the HyWorks Management Console

    • Ability to keep more logs

    • Explicit queries can be used to filter logs in the SQL Management Studio

    Select the log server as per your requirement. Configuring the Embedded Log server does not require any additional configurations. However, the following parameters need to be set to configure the SQL Server for logging:

    1. Provide the Database Address in the format \<Server IP or FQDN>\\<SQL Instance Name>. For example, if the SQL Express is installed in the same instance, then the Database Address could be localhost\SQLExpress.

    2. Provide the static port for the Microsoft SQL Server e.g. 1433 (Default TCP Port for SQL Server)

    3. Provide the name of the database to be created. Default name is HyLog.

    4. Select the appropriate authentication mechanism from the following:

      1. SQL Server Authentication: It will require SQL Server User and Password.

      2. Windows Authentication: It will use Windows user credentials to connect to the SQL Server.

    Important

    If you are configuring SQL Logging Server

    • It is recommended to use a separate instance than the one used for the HyWorks Database Server.

    • "sa" authentication should be used for logging to avoid any misconfigurations.

    • Configure the Windows Authentication for the Log Server if the HyWorks database configuration is also using Windows Authentication and both the SQL instances are configured to accept the credentials used to run the HyWorks service.

  10. Click Next to configure the Service Logon Credentials for the HyWorks Controller service. You can either set the Local System Account or use the current account to log on.

    1. Local System Account: (Recommended) The HyWorks controller service will run using Local System Account as the service logon credentials. The option will be used when HyWorks Controller service database configuration uses the SQL Server Authentication.

    2. This Account: Configuring the SQL Server with Windows Credentials requires logon credentials to run the HyWorks Controller service. When the HyWorks Controller database connection is made using Windows Authentication, the option to run the service with specific user credentials is shown. When the service runs with specific user credentials, the same user is used to connect to the SQL server.

    Important

    The HyWorks Controller service will fail to start after installation if the configured account does not have logon as a service privileges on the system.

    Follow the steps listed below to configure the users' accounts with logon as a service privilege:

    1. Click Start, point to Run, type mmc, then click OK.

    2. On the File menu, click Add/Remove Snap-in.

    3. Click Add > Add Standalone Snap-in, double click Group Policy Object Editor.

    4. Click Browse and select the Group Policy object (GPO) that you want to modify and click OK > Finish.

    5. In the Console Tree, click User Rights Assignment. This option is available at the following location:

      GroupPolicyObject\ [\Computer Name] Policy >> Computer Configuration >> Windows Settings >> Security Settings >> Local Policies >> User Rights Assignment

    6. In the details pane, double click *Log on as a service*.

    7. If the security setting has not yet been defined, select the Define these policy settings.

    8. If the security setting has not been defined yet, select the Define these policy settings checkbox.

    9. Click Add User or Group.

    10. Add the appropriate account to the list of accounts that possess the Log on as a service right.

  11. Click Next to select the database to be restored. Click Next to proceed.

    Refer to the HyWorks Backup and Restore section for instructions on the restoration process.

  12. Click Next to configure communication ports.

    1. The default port for the Accops HyWorks Controller Service is 38866. Changed, if required.

  13. The default port for the Accops HyWorks Management Console is 443. Changed, if required.

  14. Click Next to configure the HyWorks Controller Administrators. You can either set the Domain User Group or a Local User as Administrator:

    1. Domain Group Configuration: Domain User Group configured as Super-administrator. To configure a Domain User group, ensure that the:

      1. The system is in domain

      2. The user is logged in with the domain credentials and has administrative previleges on the server.

    2. Local User Configuration: A local HyWorks user created and designated as the Super-administrator. To create a local user Administrator, provide the username (the default is HyWorksAdmin) and password.

  15. Click Next. Verify the information and click Install to start the installation process.

  16. This will start the installation process and appropriate roles and features will be installed. The screen will display the status and installation progress as follows:

    1. The component being installed

    2. The Installation status of the component

    3. The Progress bar and related information for the changes being made to the system

  17. Once the installation process is complete, the screen will display the installation status of the individual components and the URL of the Accops HyWorks Management Console (if installed).

  18. The wizard will prompt to reboot the machine if the HyWorks Session Host is selected for installation. Click Yes to reboot.

Installation Verification

The Administrator can check whether the installation has been successful by verifying that the installation logs and services are running as per the information given below:

  1. Setup Status Prompt - Setup Status is displayed on the last screen of the Installation wizard. It displays details about all the installed components and their respective statuses.

  2. Access and log in to the Accops HyWorks Management Console

    1. After the successful installation, open a browser - IE11, Firefox or Google Chrome; and browse to https://\<IP of HyWorks Controller>:\<port number>

    2. Provide appropriate credentials to log in.

Installation Logs

HyWorks installation logs can be used for troubleshooting or verification purpose. Installation logs are created at the following location:

%appdata%\HyWorksController\Logs