Install on a virtual machine

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.

Install and activate the Management Portal virtual software using the following steps:

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

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

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

Collect site requirements

The following information is required during the installation and configuration. For efficient installation, we recommend that you gather this information before you start.

  • 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, for example 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 will 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.

To install Management Portal on a virtual machine:

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

  1. Install VMware vSphere client as follows:

    1. Open a web browser and enter the IP address of the VMware server.

    2. Click Download vSphere Client to download the client.

    3. Run and complete installation wizard.

  2. Retrieve the latest Management Portal OVF template (Oria.ova file) from Mitel ConnectDownloads.

  3. Open the vSphere client to connect to the virtual machine:

    1. Enter IP address of VMware server.

    2. Login as the root user.

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

  5. Select one of the following tasks:

    1. 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.

    2. 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.

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

  7. Click Next.

  8. Click Accept to accept the license agreement and click Next.

  9. Enter a meaningful name for the Management Portal virtual machine, or accept the default name. Click Next.

  10. Click Thick Provisioned Lazy Zeroed. Click Next.

  11. 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.

  12. Click Next.

  13. Review the information and click Finish.
    Note: This process may take up to 10 minutes to complete depending on network traffic and the performance of the server.

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

  15. Click the Management Portal Virtual.

  16. After 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 the newly created Management Portal virtual machine and select Open Console.

    2. Click the Launch Virtual Machine Console icon in the tool bar.
      Note: VMware Tools are pre-loaded as part of Management Portal Virtual.

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

  2. Click inside the MSL Server 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, you may need 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 MSL Server Console window, 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. After the MSL server configuration is complete, you may need 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 includes 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 and press ENTER.

    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 the Management Portal virtual machine.

  11. Click Power → Reset.