Performing the installation

This section describes how to install MVMA on a 64-bit Windows operating system environment. To confirm that MVMA supports your Windows environment, see Operating environments.

Installing on a Windows platform

The IBM MQ Java environment must be loaded before running the Installer. Verify the IBM MQ Java environment is loaded with the following command: dspmqver -p2 

Modify the output of the dspmqver command to a supported version of IBM MQ. Make sure that Name field says IBM MQ classes for Java and that the version is 9.2.0.0 or later (we recommend version 9.2.0 or later).

If the IBM MQ Java environment is not loaded, the following message is displayed:

Steps to install the application on Windows

1. Navigate to the directory where the installation files are located.
2. Change the directories to .\Disk1\InstData\Windows\VM.
3. Run install.exe from the directory. A message is displayed indicating that the wizard is being prepared.
4. On the Wizard introduction page, select Next to continue.
   1. Select one of the following installation sets based on your middleware administration infrastructure (IBM MQ, TIBCO EMS, or both), and then click Next:
      Full Administration Install Set-IBM MQInstall Set-TIBCO EMS Install Set.
5. The installation that you choose reflects your middleware administration infrastructure (IBM MQ, TIBCO EMS or both). The subsequent installation steps reflect your choice.
6. Read and accept the License Agreement that is displayed on the next Wizard page, and click Next.
7. Set the installation destination.  The default path is C:\BMC\MVMA. To accept the default path, click Next. To set an alternative path, click Choose. This opens the Windows file directory. Navigate to the desired installation directory, and click Next.
8. Installing as part of an upgrade from version 9.1, click Choose to select the location of the existing installation and then click Next. Note the MVMA services must be stopped prior to upgrading. In addition, you cannot upgrade an existing installation of MVMA 9.0 or earlier. 

If you selected the Full Administration Install Set or TIBCO EMS Install Set in step 4, now set the path name of the TIBCO EMS libraries, where the files should already be present. See the following example for setting the path.
{{code language="none"}}
C:\tibco\ems\
{{/code}}<version>{{code language="none" source="string:{{code language=~"none~"~}~}
\lib
{{/code~}~}"/}}{{/code}}, where <version> is the EMS version; for example C:\tibco\ems\8.6\lib

          9. Click Install. Installation progress is displayed on screen.

         10. When the Install Complete page is displayed, click Done to exit the wizard.

Installing on a Linux platform

This section describes how to install MVMA on Linux, via a Console or GUI. 

Installing in console mode on Linux

MVMAcan be installed in a supported Linux operating system. Refer to Operating-environments to confirm that your Linux environment matches those supported by MVMA

Steps to install the application on Linux using console mode

1. In a console, navigate to the directory where the installation files are located.
2. Run the command ./Disk1/InstData/Linux/VM/install.bin –i consoleA console opens to inform you that the installer is being launched.
3. On the license screen, read the license terms and press Enter.
4. Read the remaining information and enter Y to accept the licensing terms.
5. Select an Install folder for the application files.
   1. Press Enter to accept the default path;  /opt/BMC/MVMA
   2. Type in an alternative application file location that fits your installation. If you are upgrading from version 8.x, choose the location of the existing installation. Note that MVMA services must be stopped prior to upgrading. 

6. If TIBCO EMS support is included in your installation, enter a destination folder where EMS files are stored (example: /opt/tibco/ems/<version>/lib, where <version> is the EMS version; for example /opt/tibco/ems/8.6/lib). Press Enter.

   Important

   When installing TIBCO EMS components, TIBCO EMS must be installed on the server machine. If it isn't, copy the following files to the server machine:

   For TIBCO EMS 8.6 to 10.1:  jms-2.0.jar, tibjms.jar, tibjmsadmin.jar

   For TIBCO EMS 10.2 or later:  jakarta.jms-api-2.0.3.jar, tibjms.jar, tibjmsadmin.jar

   1. Select Install. Installation progress is displayed on the graphical wizard.
   2. When the Install Complete screen is displayed, select Done to exit the wizard.
7. Review the pre-installation summary and press Enter.
   The installation is completed but you must perform the procedures in Starting-services-after-installation and Accessing-MainView-Middleware-Administrator-after-installation before you can access MVMA.

To install the application on Linux using the silent option

Installing MVMA in silent mode requires an installer response file, which you must have recorded during a prior installation of MVMA in console mode (see the previous procedure) or created manually.

Here is an example of an installer response file:

1. In a console, navigate to the directory where the installation files are located.
2. Run the command ./Disk1/InstData/Linux/VM/install.bin –i silent -f <full_path_to_installer_response_file>
   where <full_path_to_installer_response_file> is the fully qualified path to the installer response file (for example, /tmp/installer.properties)
3. Wait until the installation is completed.
4. Verify from the installation log files created in the MVMA installation directory that the installation has completed successfully.

Installing with a GUI on Linux

To install the application to Linux in a GUI environment, follow the instructions below. Refer to Operating Environments to confirm that your Linux environment matches those supported by MVMA.

Steps to install the application on Linux using the installation wizard

1. Log in as the MainView Middleware Administrator user.
2. Navigate to the directory where the installation files are located.
3. Change the directories to ./Disk1/InstData/Linux/VM.
4. Run install.bin from the directory. 
   A dialog box is displayed indicating that the wizard is being prepared.
5. On the Wizard introduction page, select Next.
6. Select the required Install set from Full Administration Install Set, IBM MQ Install Set or TIBCO EMS Install Set.
   The installation that you choose reflects your middleware administration infrastructure (IBM MQ, TIBCO EMS or both). Depending on the set selected, the specific installation steps required reflect that choice.
7. Accept the License Agreement that is displayed in the next Wizard screen. Select Next to continue.
8. Set the installation destination (path). The default path is: /opt/BMC/MVMA
   1. To accept the default path, select Next.
   2. If you are upgrading from version 8.x, click Choose to select the location of the existing installation and then click Next. Note that the MVMA services must be stopped prior to upgrading. 
   3. To set an alternative path, select Choose. This opens the file system browser. Navigate to the required installation directory, and select Next.

9. If you select a Full Administration Installation or the TIBCO EMS Installation Set in Step 5, set the TIBCO EMS libraries path. The files should already be present. See the following example for setting the path.
   
   /opt/tibco/ems/<version>/lib, where <version> is the EMS version; for example /opt/tibco/ems/8.6/lib

   Important

   When installing TIBCO EMS components, either the server machine must have TIBCO EMS installed or these specific TIBCO files must be copied to the server machine:

   For TIBCO EMS 8.6 to 10.1:  jms-2.0.jar, tibjms.jar, tibjmsadmin.jar

   For TIBCO EMS 10.2 or later:  jakarta.jms-api-2.0.3.jar, tibjms.jar, tibjmsadmin.jar

   1. Select Install. Installation progress is displayed on the graphical wizard.
   2. When the Install Complete screen is displayed, select Done to exit the wizard.
10. Click Install. Installation progress is displayed on the graphical wizard.
11. When the Install Complete page is displayed, click Done to exit the wizard.

You can now start the MVMA service. See Starting-services-after-installation.