Install on a virtual machine

You can install Management Portal using the vSphere Client connected directly to the VMware ESX/ESXi 5.0, 5.1, 5.5, or 6.0 server or through the vCenter Server.

Installing and activating the Management Portal virtual software consists of the following steps:

  • Logging in directly to the ESX/ESXi hosts or to the vCenter Server using the vSphere Client application.

  • Deploying virtual Management Portal as a virtual machine and virtual application operating on VMware vSphere 5.0, 5.1, 5.5 or 6.0.

  • Powering up the Virtual Machine and commissioning MSL/Management Portal.

Collect site requirements

The following table itemizes the information you will need on hand during installation and configuration. For efficient installation, it is recommended that you gather this information beforehand.

  • Administrator password - For password strength, choose a password that contains a mix of upper and lower case letters, numbers, and punctuation characters, and that is not a dictionary word.

  • Domain Name of MSL Server - The domain on which the MSL server is installed, i.e abc.com.

  • System Name of MSL Server - Names must start with a letter; can contain letters, numbers, and hyphens. Also known as the host name.

  • MSL Server IP Address Subnet mask and Gateway IP address - The MSL Server IP address This will also be the IP address for the Management Portal blade. An appropriate subnet mask for the MSL Server IP address. The IP address of the router.

  • vSphere Client application installed on a PC - The vSphere Client is used to deploy Management Portal. The vSphere Client acts as a console to operate virtual machines and as an administration interface into the vCenter Server systems and ESX/ESXi hosts. Refer to the VMware website for detailed installation procedures and additional documentation.

  • (Optional) vCenter Server(s) installed on the network - A service that acts as a central administrator for ESX/ESXi hosts connected on a network. This service directs action on the virtual machine and the hosts. The vCenter Server is the working core of vSphere. Refer to the VMware website for detailed installation procedures and additional documentation.

  • ESX/ESXi 5.0, 5.1, 5.5, or 6.0 installed on the server - Use the latest software version as specified in the Management Portal Engineering Guidelines.

This installation procedure assumes that a VMware server has been installed and is running an ESX or ESXi operating system.

To install Management Portal on a virtual machine:

  1. Install VMware vSphere client as follows:

  2. Open a web browser and enter the IP address of the VMware server.
    Click Download vSphere Client to download the client.
    Run and complete installation wizard.

  3. Retrieve the latest Management Portal OVF template (Oria.ova file) from Mitel Online (MOL).

  4. Open the vSphere client to connect to the virtual machine:
    Enter IP address of VMware server.
    Login as the root user.

  5. Click File → Deploy OVF Template. . . . The Deploy OVF Template screen displays.

  6. Select one of the following:
    Deploy from file if the OVF template file was downloaded to the local computer or to a network share drive, then click Browse to locate the file.
    Deploy from URL if the OVF template file is on the internet or accessible through a web browser; enter the URL of the location of the file

  7. Click Next. The OVF Template Details screen displays. Leave the default selections as is.

  8. Click Next. The end user license agreement screen displays.

  9. Click Accept to accept the license agreement, then click Next. The Deploy OVF Template Name and Location screen displays.

  10. Enter a meaningful name for the Management Portal virtual machine, or accept the default name. Click Next. The Deploy OVF Template Disk Format screen appears.

  11. Click Thick Provisioned Lazy Zeroed. Click Next.

  12. If the network defined in the OVF template doesn’t match the name of the template on the host to which you are deploying virtual Management Portal, you are prompted to configure the network mapping. Contact your Data Center administrator for more details about which Network Mapping to use.

  13. Click Next.

  14. Review the information Select Power on After Deployment. Click Finish.
    Note: This process may take up to 10 minutes to complete depending on network traffic and the performance of the server.

  15. When the dialog indicating that the deployment is complete appears, click Close. vManagement Portal appears in the inventory list in the left side navigation pane.

  16. Click the newly created Management Portal Virtual.

  17. When Management Portal Virtual has powered up, you can begin configuring the MSL server.

To configure the MSL server:

  1. Open the virtual machine MSL Server Console in one of the following ways from within the vSphere Client:

    1. Right-click on the newly created Management Portal Virtual and select Open Console.

    2. Click the Launch Virtual Machine Console icon in the tool bar.

    3. Note: VMware Tools are pre-loaded as part of Management Portal Virtual.

    4. Click the Console tab in the main display window.

  2. The MSL Server Console window appears. Place and click the cursor in the console window to continue. If at any time you want to have the cursor available for other desktop activities, press the CTRL + ALT.

  3. Follow the MSL server configuration procedures as described in the MSL Installation and Administration Guide.

  4. When the MSL server configuration is complete, it might be necessary to add a local network to MSL if you intend to access Management Portal Virtual from a different network from which it is installed.

    1. From the Server Console, select 9 - Manage Trusted Networks.

    2. Click Add a new trusted network.

    3. In the Network Address field, enter the IPv4 or IPv6 address of the network to designate as “local”.

    4. In the Subnet mask field, enter the dot-decimal subnet mask (for example, 255.0.0.0 if you intend to open up to the entire Class A subnet).

    5. In the Router field, enter the IP address of the router you will use to access the newly-added network.

    6. Click Add.

  5. When the MSL server configuration is complete, it might be necessary to add a local network to MSL if you intend to access Management Portal Virtual from a different network from which it is installed. The process consists of adding a local network, subnet, and router to the Local Networks panel in the server manager as follows:

  6. Log in using the admin user ID and root password created during the MSL server configuration.

    1. Using the arrow keys, select 11 - Access Server Manager.

    2. Log in using the same administrator user ID and password as in Step a.

    3. Using the arrow keys scroll down to Local Networks.

    4. Use the down arrow key to select Add Network. Press ENTER.

    5. Use the down arrow key to enter the following information:

      1. Subnet Mask (for example, 255.0.0.0 if you intend to open up to the entire Class A subnet).

      2. Router Address (for example, 192.168.1.x, the gateway IP provided during the MSL server configuration).

    6. Use the down arrow to select Add, then press ENTER. A status screen displays indicating success at creating the Local Networks.

    7. Type Q to quit, then select Exit and Yes.

    8. Using the down arrow key, scroll to Exit from the MSL Server Console.Press ENTER.

    9. You are now ready to configure the Management Portal application.

  7. Confirm the OVF memory and HDD configuration as follows:

    1. Right-click the newly created Management Portal virtual machine.

    2. Click Edit Settings.

    3. Under the Hardware tab, click Memory and set Memory Size to 6 GB.

    4. Under the Hardware tab, click Hard Disk and set Disk Provisioning to 50 GB.

    5. Under the Hardware tab, click CPUs and set Number of Virtual Sockets to 4.

    6. Click OK.

  8. Complete the OVF configurations as follows:

    1. Click Power → Power On.

    2. Click the Console tab and wait for server to startup. Login as root user (use password provided by Mitel).

    3. Select Timezone Configuration and set it based on your location. Click OK.

    4. Select Keyboard Configuration and set it based on your preference. Click OK.

    5. Select the Network Configuration option.

    6. Select Edit Devices → eth0.

    7. Uncheck the Use DHCP checkbox.

    8. Enter the appropriate Static IP, Netmask, and Default gateway IP address.

    9. Select Edit DNS Configuration and enter a Primary DNS server IP address.

    10. Click OK → Save → Save&Quit → Quit.

    11. Right-click the newly created Management Portal virtual machine.

9 Click Power → Shutdown Guest.

10 Right-click on the Management Portal virtual machine.

11 Click Power → Reset.