Article ID: 124093, created on Dec 30, 2014, last review on Apr 8, 2015

Release Notes

Full release notes can be downloaded as PDF or viewed online.

Dependencies and Pre-Requisites

The Microsoft Office 365 Application Package requires:

  • POA 5.5-5562_update07_KB122627 or later
  • PBA for Linux 5.5.6 or later
  • PBA Application Package 5.5-5 or later

Important:

  1. The POA Management Node on Windows is not supported.
  2. On existing installations of the Microsoft Office 365 Application make sure the Max attempts setting of the BM / OnServiceUpgrade Event Handler is set to 3. See PA Office 365 Integration Provider's Guide >> Configuring Billing > Setting PBA to Send Resource Limits in One API Call for details.

Fixed Issues

  • APSA-9852 Create MX DNS records when domain gets verified.
  • APSA-8622 Update offers in autoconf.py.
  • APSA-7876 Application end-point spends >30% of time establishing SSL connections to APSC.

New Features and Changes

  • Automated Subscription Limit Propagation is Improved
  • Upgrading Office 365 Subscriptions from APS 1.2 to APS 2
  • SQL Server Support for Office 365 Application End-point Deployment
  • Dutch (Netherlands) Language is Supported

Important: Starting with version 5.9 of the Microsoft Office 365 Application, SQL Server 2012/2014 is required to store Office 365 Application End-point data.

Obtaining

Contact your Parallels Support account manager to obtain the new versions of the Microsoft Office 365 Application Package. The PBA Application Package can be downloaded here.

Installation

To install the Microsoft Office 365 Application, use the instructions provided in the PA Office 365 Integration Provider's Guide.

Upgrade Procedure

The upgrade procedure consists of the following steps:

  1. Preparing the SQL Server databases for the existing Office 365 Gateway Applications.
  2. Preparing necessary information for upgrading the Office 365 Application End-point (collecting Office 365 Dispatcher Site parameters).
  3. Preparing necessary information for upgrading the Office 365 Application End-point (collecting Office 365 Gateway Site parameters).
  4. Upgrading Office 365 Application End-point.
  5. Upgrading the Microsoft Office 365 Application.
  6. Performing version-specific upgrade actions.
Important:
  1. The upgrade procedure is not reversible.
  2. All these upgrade steps are mandatory.
  3. Make sure the current version of the Microsoft Office 365 Application is 5.2. Upgrading from versions that are lower than 5.2 is not supported.
To upgrade an existing installation of the Microsoft Office 365 Application, perform the following steps:
  1. Prepare the SQL Server databases for the existing Office 365 Gateway Applications. Use the information provided here: PA Office 365 Integration Provider's Guide >> Deployment Architecture > Preparing SQL Server Databases, PA Office 365 Integration Provider's Guide >> Useful Information > Firewall Requirements > Office 365 Application End-point Host.
  2. Prepare necessary information for upgrading the Office 365 Application End-point. You must prepare the name of the Office 365 Dispatcher Site, the name of the Office 365 Dispatcher Application, and the IP Address of the Office 365 Dispatcher Site. This can be done in the following way:
    1. Prepare the URL provided to Microsoft. This URL is structured in the following way: https://<Hostname_of_Office_365_Dispatcher_Site>/<Name_of_Office_365_Dispatcher_Application>/.
    2. Write down the name of the directory from the URL. This is the name of the Office 365 Dispatcher Application.
    3. Resolve the hostname from the URL into the IP address. This is the IP address of the Office 365 Dispatcher Site. Write down this IP address.
    4. Log on to the Office 365 Application End-point Host as Administrator via RDP.
    5. Open the Internet Information Services (IIS) Manager.
    6. Go to the list of sites.
    7. From the list, select the site with the IP address obtained above.
    8. Write down the name of the site. This is the name of the Office 365 Dispatcher Site.
  3. Prepare necessary information for upgrading the Office 365 Application End-point. You must prepare the name of the Office 365 Gateway Site, the name of the Office 365 Gateway Application, the hostname of the Office 365 Gateway Site, and the IP Address of the Office 365 Gateway Site. This can be done in the following way:
    1. Log in to Provider Control Panel.
    2. Go to Service > Applications and click the Microsoft Office 365 Application.
    3. Select the Instances tab and click the target Application Instance.
    4. Select the General tab.
    5. Obtain the value of the Application API end-point URI setting. This is a URL that is structured in the following way: https://<Hostname_of_Office_365_Gateway_Site>/<Name_of_Office_365_Gateway_Application>/aps/.
    6. Write down the name of the directory from the URL. This is the name of the Office 365 Gateway Application.
    7. Write down the hostname from the URL. This is the hostname of the Office 365 Gateway Site.
    8. Resolve the hostname from the URL into the IP address. This is the IP address of the Office 365 Gateway Site. Write down this IP address.
    9. Log on to the Office 365 Application End-point Host as Administrator via RDP.
    10. Open the Internet Information Services (IIS) Manager.
    11. Go to the list of sites.
    12. From the list, select the site with the IP address obtained above.
    13. Write down the name of the site. This is the name of the Office 365 Gateway Site.
  4. Upgrade the Office 365 Application End-point:
    1. Upload the Microsoft Office 365 Application Package to the Office 365 Application End-point Host.
    2. Extract the O365-Web.zip file from the Microsoft Office 365 Application Package.
    3. Unpack the O365-Web.zip file.
    4. Start the Windows PowerShell Console and go to the directory where the content of the O365-Web.zip file is placed.
    5. Run the .\setup.cmd -DispatcherSiteName <The name of the Office 365 Dispatcher Site> -DispatcherAppName <The name of the Office 365 Dispatcher Application> -DispatcherIPAddress <The IP address of the Office 365 Dispatcher Site> -GatewaySiteName <The name of the Office 365 Gateway Site> -GatewayAppName <The name of the Office 365 Gateway Application> -GatewayIPAddress <The IP address of the Office 365 Gateway Site> -GatewaySiteCertSubject <The hostname of the Office 365 Gateway Site> -SqlInstance <The SQL Server instance of the Office 365 Gateway Application database> -SqlDatabase <The database of the Office 365 Gateway Application> -SqlUser <The login name of the Office 365 Gateway Application database> -SqlPassword <The login password of the Office 365 Gateway Application database> -Force command.
    6. Notes:
    7. 1. If you have several Office 365 Gateway Sites on the Office 365 Application End-point Host, use the provided above procedure to upgrade each Office 365 Gateway Site.
    8. 2. If you need to update your client Microsoft certificate, you can do this in the following way: upload the new client Microsoft certificate to the Office 365 Application End-point Host; add -MSCertPath <path to certificate> to the command provided above; run the command.
  5. Upgrade the Microsoft Office 365 Application:
    1. Import the Microsoft Office 365 Application Package to PA. See POA Provider's Guide >> Application Hosting > Managing Applications > Importing Application for details.
    2. Upgrade existing Microsoft Office 365 Application instances. See POA Provider's Guide >> Application Hosting > Bulk Application Upgrades for details.
  6. Disable the obsolete script for automated subscription limit propagation. See the https://kb.odin.com/en/122059 KB Article to obtain information about the script.
  7. Configure filtration of incompatible offers.
  8. Important: Skip this step if upgrading from version 5.3 or newer.
  9. Use the instructions provided here: PA Office 365 Integration Provider's Guide >> Configuring Filtration of Incompatible Offers, PA Office 365 Integration Provider's Guide >> Configuring Offers for Resellers, PA Office 365 Integration Provider's Guide >> Useful Information > Firewall Requirements.
  10. Configure the trial offer conversion functionality:
  11. Important: Skip this step if upgrading from version 5.3 or newer.
    1. Specify the Trial Offer ID property of the existing License Types and create the additional License Types. See PA Office 365 Integration Provider's Guide >> Configuring Offers > Creating License Types.
    2. Create the 'Office 365 License' Resource Types for the additional License Types. See PA Office 365 Integration Provider's Guide >> Configuring Offers > Creating Office 365 Resource Types > Creating 'Office 365 License' Resource Types.
    3. Include the created 'Office 365 License' Resource Types into the Office 365 Service Template. See PA Office 365 Integration Provider's Guide >> Configuring Offers > Creating 'Office 365' Service Template.
    4. Create the 'Office 365' Service Plans for the additional License Types.  See PA Office 365 Integration Provider's Guide >> Configuring Offers > Creating 'Office 365' Service Plans.
  12. Perform the instructions of the PA Office 365 Integration Provider's Guide >> Configuring PBA Customer Control Panel for Trial Subscriptions section for each brand which is used for selling Office 365 Service Plans.

Help Resources

PA Office 365 Integration Guides are available here: http://download.pa.parallels.com/poa/.

All Office 365 Integration Release Notes

Email subscription for changes to this article
Save as PDF