Previous page

Next page

Locate page in Contents

Installation

Prerequisites

RAS Management Portal can run in any modern web browser supporting HTML5 such as Microsoft Edge (Chromium-based), Google Chrome, Mozilla Firefox, Safari, etc.

Before installing the web service, make sure that your Windows server has the following updates installed (RAS Management Portal depends on them):

  • Windows Server 2008 R2: — KB2999226 and KB2533623
  • Windows Server 2012 R2 — KB2999226

If you don't have the updates installed and run the installer, it will ask you to install them. Newer versions of Windows Server do not require any specific updates.

The web service listens to web requests on the following ports by default:

  • HTTPS: 20443
  • HTTP: 20080

Installation

To enable RAS Management Portal in a RAS Farm, you need to install RAS Web Administration Service. It can be installed on the RAS Publishing Agent server or any other server.

To install RAS Web Administration Service:

  1. Run the Parallels RAS installer on the RAS Publishing Agent or any other server.
  2. On the Select Installation Type page, select Custom.
  3. On the next page, select to install the Parallels RAS Web Administration Service component.
  4. Click Next and follow the onscreen instructions.

Configuration

If the RAS Web Administration Service was installed on a separate server (not the RAS Publishing Agent server), you need to modify the service configuration and specify the RAS Publishing Agent server address. You may also want to change the port number and certificate information in the same configuration file.

The configuration of the RAS Web Administration service is saved as a JSON file at the following location:

  • C:\Program Files (x86)\Parallels\ApplicationServer\WebAdminService\appsettings.json

To edit the file, open it in an advanced text editor like Wordpad or Notepad++. The file contains configuration parameters for the RAS Management Portal and the RAS REST API, some of which are shared between the two. The following describes the parameters that apply to the RAS Web Administration service:

Key

Description

WebAdminService{

 

  WebConsole{

 

    Enable

Enable or disable the RAS Management Portal (true / false).

  }

 

  Session{

 

    Expire

The number of minutes that a session can remain idle before it is terminated.

  }

 

}

 

AllowedHosts{

 

  EndPoints{

 

    HttpsDefaultCert{

 

      Url

HTTPS URL pattern and port number. The default port is 20443. You can specify a different port if needed.

      Certificate{

This section is commented out by default. If you would like to specify a custom SSL certificate in PFX format, uncomment this section and specify values for the following two keys.

        Path

A path to the PFX file.

        Password

A file password.

      }

 

    }

 

    Http{

 

      Url

HTTP URL pattern and port number. The default port is 20080. You can specify a different port if needed.

    }

 

  }

 

}

 

Top of page Feedback