Important Information

• For Multi-Tenant environment, please make sure to check this article. (click to open)
• Prior to upgrading it is recommended to check the System Requirements here
• If one is planning to move the RAS installation to a new server we suggest reading our instructions for deactivating the previous installation from here
• Please review the list of deprecated components prior to upgrading your installation
• Known issue with upgrade!!!: In some cases if RAS Publishing Agent and RAS Secure Client Gateway is installed on the same machine, Firewall Rules are removed. So there are some steps that should be preformed prior and after the upgrade:
  • Export Firewall rules from all Publishing agent servers using the command: netsh advfirewall export "C:\fw-rules.wfw" or manually per screenshot:
    
    
  • Run the upgrade
  • Check if RAS Firewall  rules are there:
    
  • If Firewall rules for RAS are missing, import the exported rules using the command: netsh advfirewall import "C:\fw-rules.wfw" or manually per screenshot:
    

Stage 1: Upgrade Preparation

1. Read the documentation below to review all changes and added features for the latest version:
   • Parallels RAS Changelog
2. Ensure that your Parallels Remote Application Server license has valid upgrade insurance. Upgrade insurance is not automatically included with a Support contract.
3. Take snapshots of environments configured on virtual servers, primarily on the RAS Console/ License server.
4. Copy and save the license key activated on the current installation from the RAS Console > Licensing.
5. Collect additional information about the current Remote Application Server installation from the RAS Console > Help > About.
6. Export the configuration file and save it to another location.
7. If the Parallels Remote Application Server console or License server also runs other Parallels products, such as the RAS Web Portal, back up and collect the information below:
   • Back up the following directory and all subdirectories : C:\Program Files (x86)\2X and C:\Program Files (x86)\Parallels
   • Collect information about the RAS Web Portal: Parallels RAS Admin Portal > General Settings > About

Stage 2: Upgrade Requirements

1. Internet access is required on the Parallels RAS Console Server to install the software and activate the license.
2. For all upgrades, it is highly recommended to schedule a time when your users aren’t active on your system.
3. Older versions of Parallels Reporting are not compatible with newer versions of Parallels Remote Application Server. You can download a corresponding version of RAS Reporting here.

Stage 3: Upgrade Procedure

1. Proceed to upgrade the Parallels Remote Application Server environment from the RAS Console/License server by going to Parallels RAS Console > Administration > Software Update tab > Check now > Update. Alternatively, download the installer here and run IT on the Master PA. This will upgrade the Master Publishing Agent.

2. It is recommended after the Master Publishing Agent, the backup Publishing Agent is upgraded followed by the rest of the components. Once backup Publishing Agent is upgraded, if prompted to upgrade components select update all Parallels Remote Application Server agents configured to the farm/ site.

   NOTE: Should you have multi-site Farm, in order to upgrade secondary sites, do the following:

   Once Master Site upgraded and you log into the console still on Master site, upgrade the secondary sites:

   • From the left pane in the Console, select Farm
   • In the list select Farm, right click on secondary site > Check Agent > Update.
   • Once secondary site updated switch to that site and first update backup Publishing Agent and then the rest components.
3. Log on to the RAS Console and ensure that all agents are verified.

NOTE: Upon launch, RAS Console will ask you to specify the Farm name you need to connect. You may either insert the Farm name, the hostname of Publishing Agent or just "localhost"

4. Next, download and install the Parallels RAS Portal software from General settings > Software > Check Now. This is only required if you were using the RAS Web Portal.

Stage 4: Final checks

Upon completion, log on to the console and activate your license from the Parallels RAS Console > Licensing. Also, ensure that the “Concurrent UBL” information is the correct user license count you have purchased. If not, please contact Parallels Sales.

Additional Information

If you require support during or after your upgrade, please contact our Support department.

It is highly recommended to schedule the upgrade with the Parallels Support department and your users. Make sure that you have a valid support agreement if you choose to schedule the upgrade.