Migrate to Platform Manager

You can migrate platforms created in MiCloud Management Portal to Platform Manager. This will simplify maintenance and upgrades. The Migrate function is currently available for:

  • Virtual - single resource, created in Management Portal (Small Medium Business/SMB architecture based on MiVoice Business Express)

Note

Some of the information may not be available on a migrated resource. For example, if a MiVoice Business Express with three interfaces is created from Platform Manager, then all of the corresponding IP addresses appear when looking at the details of this resource from the Platform Manager. This type of information is not available on a migrated platform because the IP addresses are already configured; they are not provided by the user or stored in the Management Portal.

The platforms to be migrated must meet the following conditions:
General conditions:

  • In general, the best practice is to migrate platforms that could have been created using Platform Manager. It is recommended that the Resource Blueprint data generally matches the platform's VMware configuration (to facilitate future reference).

  • The Platform Blueprint must contain a single Resource Blueprint that points to the Infrastructure credentials needed to access the platform that needs to be migrated.

MiVoice Business Express conditions:

MiVoice Business Express:

  • must not be part of any resilient MiVoice Business environment.

  • must be in a VMware environment that is accessible to Platform Manager.

  • must be powered on and accessible before migration.

Initiating a platform migration

Migration is performed one platform at a time, using a Management Portal maintenance command.

  1. In Platform Manager, create a new Platform Blueprint that matches the platform you intend to migrate into Platform Manager.

    Note

    Make sure you know the MSL user name and password, because these cannot be changed after migration is complete. The fields are not available for the migrated platform.

  2. Navigate to http://<MMPIP>/konos/commands.jsp. Replace "MMP IP" with your Management Portal IP address.

  3. Type the following command:

$$MANAGE PLATFORM$$ Param1, Param2, Param3, Netmask=value, Gateway=value
Where:

Parameter

MiVoice Business Express

Param1

Name of the platform as registered in Management Portal

Param2

Platform Blueprint ID as created for migration in Platform Manager

Param3

The VMware instance name as shown in VMware.

Netmask

Optional
Default: 255.255.255.0
Example: netmask=255.255.255.0

Gateway

Optional
Default: The Gateway property read from the MiVoice Business Express OVA
Example: gateway=10.46.40.1

For guidance crafting the Migrate command, use the following table:

Parameter

Where to find it

Example

Param1:
Name of the platform as registered in Management Portal

Management Portal:
Platform > Platform Groups > Register Platform

MMP_Platform_Name

Param2:
Platform Blueprint ID as created for migration in Platform Manager

Platform Manager:
Blueprints > Platform Blueprint > Create Platform Blueprint >ID column

46325

Param3 (MiVB-X only):
The VMware instance name as shown in VMware

vSphere Client:
Home > Inventory > VMs and Templates

VMware_Name

When the migration is complete, the migrated platform will be shown as a "managed" platform in Management Portal. This new status will be displayed in the Platform Details > Description field, with text similar to the following:

Note: Platform Manager Migrated, 2017/09/12 11:30:02

In Platform Manager, in Platform Group Details > Description field, the text "Migrated instance" is added.

Deleting a migrated platform: Caution

When a platform is migrated, a reference to the virtual machine is created in Management Portal and in Platform Manager, so when deleting a platform from Management Portal or Platform Manager, the virtual machine is also deleted.

To delete the record from Management Portal or Platform Manager while preserving the virtual machine:
Method 1 (recommended):

  1. Rename the virtual machine. For example, rename VM_Name to VM_Name_temp.

  2. Delete the platform from Management Portal and/or from Platform Manager.

    If platforms are deleted from Management Portal and not from Platform Manager, these instances cannot be migrated again, because Platform Manager stores the details of the migration in the Management Platform database. When deleting platforms from Management Portal, also delete the platforms from Platform Manager.

  3. Rename the virtual machine to its original name; for example: VM_Name.

Method 2 (for use when deleting platform from Management Portal):

  1. In Management Portal, navigate to System > Advanced > Platform Manager.

  2. At the bottom of the page:

    1. Deselect Delete Blueprint based instance.

    2. Deselect: Delete Custom instance.

That being said, when deleting a platform from Management Portal, there is an option in Management Portal to disable the delete of the platform in BIM and hence the VM itself.

Error scenarios

Migration errors are shown in two ways:

  • In Management Portal: If there are errors in Management Portal, the error message is displayed below the maintenance command input box. Any error messages reported by Platform Manager are also displayed. If there is a timeout for the command, review the Platform Manager interface and logs for the details.

  • In Platform Manager: Detailed error information is contained in the Events and Logs.

Common causes of errors

This is a list of possible causes of migration errors.

  • MiVoice Business Express is not properly licensed and operational.

  • Migration is attempted for a Platform that was created in Platform Manager and registered manually in Management Portal.