Article ID: 112959, created on Dec 7, 2011, last review on Aug 12, 2014

  • Applies to:
  • Operations Automation

Note: Since PA Office 365 Integration 4.6, the Office 365 subscription downgrade procedure is completely automated and the downgrade report script must not be used.

Symptoms

If a customer decreases number of Office 365 user seats in their subscription in Parallels Automation, the Office 365 MOSI Gateway Host accepts such reconfiguration, however it does not send any downgrade request to Microsoft Cloud.

Cause

Microsoft Online Syndication Interface (MOSI) does not support the Office 365 subscription downgrade (even if the requested new number of the user seats is less than the currently used number of the user seats in a subscription).

Resolution

The Office 365 subscription downgrades should be processed manually by PA Provider through Microsoft support using the following procedure:

  1. The Provider configures the script which collects Office 365 subscription downgrade requests.
  2. The script is executed periodically, e.g. on daily basis.
  3. This script sends collected Office 365 subscription downgrade requests to the Provider via mail.
  4. Provider asks Microsoft support to process Office 365 subscription downgrade requests.

The script is configured in the following way:

  1. Prepare the host that meets the following requirements:

    • PHP is installed on the host;
    • PHP scripts are able to send e-mails from the host to the Internet (see the [mail function] section in the php.ini file);
    • HTTPS connections are allowed from the host to the Office 365 Gateway Host to the MOSI Connector URL. The existing POA Provisioning Gateway Host may be used.
  2. Put the downgrade_report.php script from the attached ZIP archive on the prepared host.

  3. Specify the following parameters in the script:

    • $mailrecipients - comma-separated list of e-mail addresses to which the Office 365 subscriptions downgrade requests will be sent. For example: provider1@example.com, provider2@example.com
    • $url - specify MOSI Connector URL (see the value specified in the Office 365 Application Resource Type). For example: https://mosi-gateway.example.com/mosi/HTTPEndpoint.aspx
    • $scriptlocation - full path to the directory where the script is placed. For example: /root/downgrade/
  4. Configure cron (on Linux) or Task Scheduler (on Windows) to execute the script on a daily basis.

  5. Validate that script is executed and the subscription downgrade requests are sent to the specified e-mail addresses.

Note: All existing subscription downgrade requests are collected by the script - the downgrade requests that were sent to Microsoft support and the downgrade requests that were not sent to Microsoft support yet. When Microsoft support processes subscription downgrade requests, corresponding subscription are removed from the script output data.

Attachments

5356b422f65bdad1c3e9edca5d74a1ae caea8340e2d186a540518d08602aa065 e12cea1d47a3125d335d68e6d4e15e07

Email subscription for changes to this article
Save as PDF