Install and prepare Platform Manager

Abbreviations used in the Platform Manager user interface include:

  • MiVB – MiVoice Business

  • MiVB-MI – MiVoice Business Multi Instance

  • MiCollab-MT – MiCollab Multi-tenant

  • MiVB-X - MiVoice Business Express

Note

You can install Platform Manager and File Server on the same server. You cannot install Platform manager and File Server on the server on which Management Portal is installed.

Before deploying Platform Manager

  1. Contact AMCSUPPORT@mitel.COM and request a production AMC service provider account if you do not have one already.

  2. After the account is created, send the following email request to AMC support to get the Platform Manager license key and secret:

I’m requesting a AMC API licence key and secret for AMC account MITEL-YOURACOUNT. We require the license key and secret in order to configure Platform Manager server for ARID creation and AMC license management.

If you are not familiar with Platform Manager please forward this request to Level 3 AMC Support.

Install File Server

  1. Using MSL, install the File Server.

  2. Add a user on the File Server. Save the password; you will need it for future steps.

Install Platform Manager

  1. Using MSL, install Platform Manager, either on the same server as the File Server or on its own server.

  2. On AMC, using the AMC account that is bound to your AMC API credentials:

    1. Create a customer. Platform Manager places all ARIDs that it creates in this customer.

    2. Generate the sales orders for the licenses required (Base Kit licenses and user licenses, for example).

  3. On Platform Manager, in Configuration tab, click AMC Account, enter the API access credentials (consumer keys and secret) that you received from Mitel for API access to your AMC account.

Configure Platform Manager

  1. On Platform Manager, enter the Sales Order (Configuration > AMC Accounts > License Bank Records > (add) Sales Order).

  2. Register the File Server (Configuration > File Servers > Register File Server).
    Enter the username and password you received on File Server when creating the user. If the File Server is co-located on the same server as Platform Manager, ensure that the File Server address entered is the public IP of the server. Do not use localhost/127.0.0.1.

  3. Upload the software Image files and the golden database files (Configuration > Files > Upload Files).
    There are reference (example) MiVoice Business database files available on the Platform Manager server, in the directory /opt/dist_oria-bim-setup/reference.

  4. For MiVoice Business Multi-Instance: Create the MiVoice Business Multi Instance pools (Configuration > MiVB-MI Pools > Create MiVB-MI Server Pool). For production, you should have two or more server pools. For a demonstration system, one server pool may be sufficient. MiVB-MI Pools are referred to in the resource blueprints.Example: Assume that there are two pools, named "east" and "west":

    1. Place the east coast MiVB-MI servers in pool "east", and the west coast servers in the pool named "west".

    2. Create two resource blueprints, each referring to a different MiVB-MI pool (described in a later step).

    3. In the platform blueprint, link to the resource blueprints. The resulting platform will contain one instance in each pool (described in a later step).In this example, using this naming convention, the result is geographic classification of the servers. Many different naming conventions are possible; be sure to plan a naming convention that facilitates management of your system.

    You cannot remove servers from a pool.

  5. Register the Infrastructure (Configuration > Infrastructures > Register Infrastructure).
    For MiVoice Business Express: Register a VMware vCenter infrastructure.
    For MiVoice Business Multi Instance: Register the MiVB-MI servers created earlier and place them into one of the pools created.

  6. If you are setting up a MiVoice Business Multi Instance System:
    Create MiCollab Multi-tenant pools (Configuration > MiCollab-MT Pools > Create MiCollab-MT Pool).

    1. Add MiCollab Multi-tenant servers (Configuration > MiCollab-MT Servers > Add MiCollab-MT Server).

    2. Register the MiCollab servers and place them in the MiCollab pools created. This is similar to the MiVB-MI Pools registered in an earlier step.

  7. Create an ARID blueprint (Blueprints > ARID Blueprints > Create ARID Blueprint).

    1. In AMC Parts List, enter the AMC part number (the MiVoice Business Multi Instance Base Kit license part number is 54006021, for example), with quantity 1.

    2. Click the + symbol to add the AMC part.

  8. Create resource blueprints (Blueprints > Resource Blueprints > Create Resource Blueprint).
    Create resource blueprints using the MiVoice Business software Image and golden database file.If you are creating MiVoice Business Multi Instance Resource Blueprints, create one resource blueprint for each golden database file; primary and secondary.

    Use the MiVoice Business System Administration Tool user name and password that is configured in the MiVoice Business golden database files being used. If you are creating your golden database using the golden database supplied in the reference.zip file, username=system, password=default. You will change the password as part of this operation.

  9. Create a platform blueprint (Blueprints > Platform Blueprints > Create Platform Blueprint).

    1. Associate the two resource blueprints and the ARID blueprint created earlier to the new platform blueprint.

    2. In AMC Group Parts, enter User Licenses to provide to the Group (UCC part 54006169, for example).

    3. For MiVoice Business Multi Instance:
      Select Create Cluster. Select the MiCollab-MT Pool from the drop-down list if you want to use MiCollab Enterprise with the MiVoice Business instance.

    4. For MiVoice Business Express Blueprints:
      To create a resilient network based on MiVoice Business Express, you can add a MiVoice Business Virtual controller or a Remote Server Gateway after Platform Manager work is complete.

  10. Test the Platform Blueprint to ensure that it will result in the intended system.

  11. Optional: Add an inventory pool (Inventory > Add an Inventory Pool) to trigger creation of the instance.

    1. Select the platform blueprint from the list.

    2. Select Start After Build. This starts the MiVoice Business instance after the instance is created successfully.

    3. Enter a Low Water value greater than zero to ensure that the building process is triggered automatically as instances are used. The inventory pool software tries to keep the number of Ready instances at the low water mark. If the Low Water setting is 5, for example, and the number of instances falls below 5—because instances have been used by Management Portal, then more instances are built to keep the inventory at or above the Low Water mark.

  12. Create a test instance before starting to create an inventory of instances. Navigate to Platform Groups > Create Platform Group. Then select the new blueprint from the drop-down menu.

  13. Create Platform Groups (Platform Groups > Create Platform Group)

    Management Portal uses only instances created through Inventory.

    Register Platform Manager in Management Portal

  1. Log in to the Management Portal Service Provider portal.

  2. Register the Platform Manager (System > Platform Manager Registration).

  3. Register the Platform Manager blueprint (Platforms > Platform Manager Blueprint Assignment > Register Platform Manager Blueprint). Select the Blueprint from the displayed list.

  4. Register platform groups (Platforms > Platform Groups > Register Platform).

    1. Select Managed Platform. Select a Blueprint that matches the required platform group configuration.

    2. Click Submit. Management Portal uses an instance from the Platform Manager's Inventory Pool.

  5. After the platform groups are registered successfully, you can create a customer in Management Portal.

After Platform Manager is registered, you can access Platform Manager from Management Portal (Platforms > Platform Manager).

Prepare to create customers

To turn the blueprints and instances you have created into a system for end-customers, you must have a suitable golden database. If you are using the sample golden database provided, you must modify it to suit your environment. At minimum, you must make the following changes.
Log in to the MiVoice Business through the System Administration Tool:

  • Change the MiVoice Business password when prompted.

  • Configure the SIP Peer (Network Elements form and SIP Peer Profile form)

  • Configure the MiVoice Border Gateway IP address (Network Elements form)

Update the MiVoice Business golden database files

When creating or modifying MiVoice Business golden databases, start from a database that has not been modified by Platform Manager. The Platform Manager modifies the MiVoice Business database only if Create Cluster is selected in the Platform Blueprint.

The MiVoice Business instances created from the example blueprint above are not suitable as seeds for new custom golden databases because this database has been modified by the Platform Manager (unless you did not select Create Cluster when creating the platform blueprint). Install the sample golden databases to a standalone MiVoice Business server before performing any customizations. After completing your customizations, back up the MiVoice Business database. This MiVoice Business database backup is your new custom golden database. Repeat this customization and backup to create golden databases for each primary and secondary system.

Sample Blueprints for both MiVoice Business Multi Instance and MiVoice Business Express are available for reference: /opt/dist_oria-bim-setup/reference/

To prepare the platform blueprint for modification:

  1. In Platform Manager, clone the platform blueprint by clicking Blueprints, and then click the Platform Blueprint ID. The Platform Blueprints page appears.

  2. Click the Clone button to create a copy of the blueprint.

  3. In this cloned copy, deselect Create Cluster.

  4. Build an instance of this cloned blueprint (Platform Groups > Create Platform Group).

  5. Log in to the MiVoice Business System Administration Tool for this MiVoice Business Instance and make the changes you need for the new system you are building.

  6. Back up the MiVoice Business database. This backup file is the new, customized golden database.