Installing the virtual appliance

Before you begin

Before you start the installation procedure, ensure the following:

  • You have identified a server onto which you will deploy your BMC Atrium Discovery virtual appliance
  • The server has sufficient spare resources to support the intended configuration of the virtual appliance.
  • You have identified the VMware Administrator who will be installing the virtual appliance.

BMC Software no longer provide 32 bit virtual appliances or kickstarts of BMC Atrium Discovery.

Third party software

BMC Atrium Discovery is built as an appliance that is not intended to have any additional software installed on it. If you have an urgent business need to install additional software on the appliance, read the third party software support page.

No OS customizations are supported on the appliance

The BMC Atrium Discovery software is delivered as an appliance model (either virtual or physical), and includes the entire software stack from a Linux OS to the BMC application software. The OS must not be treated for general purpose use, but rather as a tightly integrated part of the BMC Atrium Discovery solution. As such, customizations to the OS should only be made at the command line level if explicitly described in this online documentation, or under the guidance of BMC Customer Support. If you have an urgent business need to change any OS configuration, you must contact BMC Customer Support before doing so.

Supported virtualization platforms

The BMC Atrium Discovery Virtual Appliance is supplied as an OVF (Open Virtualization Format) file and is only supported on the VMware platforms described in this section.

For production use:

For testing and development

VMware Virtual Infrastructure (ESX/ESXi) — 4.1 and later

To install the BMC Atrium Discovery Virtual Appliance onto VMware Virtual Infrastructure (ESX/ESXi) version 4 and 5.

You must add a CD-ROM drive to the virtual machine before you can install VMware tools. Do this before starting the virtual machine.

The major steps in this procedure are outlined below. For full information, see the VMware documentation.

  1. Copy and extract the BMC Atrium Discovery Virtual Appliance zip file to the local file system.
  2. In VMware Virtual Infrastructure, from the File menu, select Deploy OVF Template.
    The wizard guides you through the rest of the process described here.
  3. Enter the file name of the BMC Atrium Discovery OVF file into the Filename dialog box, or click Browse... to locate the file.
    Click Next.
  4. Review the details provided.
    Click Next.
  5. Provide a name for the virtual machine.
    Click Next.
  6. Choose datastore location for the virtual machine.
    Click Next.
  7. Choose thin or thick disk format. The default is thick which pre-allocates all disk space.
    Click Next.
  8. Review the configuration and click Finish to proceed.
    A progress bar is displayed while the virtual machine is deployed.
  9. Click the Hardware tab and click Add.
  10. Select DVD/CD-ROM Drive and click Next.
  11. Accept the defaults for the drive.
    Optionally you can now add additional disk storage which can be managed with the disk configuration utility.
  12. Click the Hardware tab and click Add.
  13. Select Hard Disk and click Next.
  14. Choose the disk capacity and other options. For information about recommended capacity, see the Hardware requirements.
  15. Click Next.
  16. Review the settings and click Finish.
  17. Click OK to save the changes.
    You can now start the virtual machine.

VMware Workstation — 8.0.2 and later

To install the Virtual Appliance on VMware Workstation 6 or 8.

  1. Copy and extract the BMC Atrium Discovery Virtual Appliance zip file to the local file system.
  2. In VMware Workstation, from the File menu, select Open.
  3. Enter the file name of the BMC Atrium Discovery OVF file into the Filename dialog box, or click select OVF as the file type and click Browse... to locate the file.
    Click Open.
  4. Enter a name for the virtual machine and click Import.
    VMware Workstation imports the virtual machine and the virtual machine is displayed in the virtual machine library.

VMware Player — 5.0.3 and later

You cannot install or run an OVF virtual machine in Windows by double-clicking it. An error message "Invalid option t" is displayed. Instead, follow the procedure below.

To install the Virtual Appliance on VMware Player 5.0.3.

  1. Copy and extract the BMC Atrium Discovery Virtual Appliance zip file to the local file system.
  2. In VMware Player, from the File menu, select Open.
  3. Enter the file name of the BMC Atrium Discovery OVF file into the Filename dialog box, or click select OVF as the file type and click Browse... to locate the file.
    Click Open.
  4. Enter a name for the virtual machine and click Import.
    VMware Player imports the virtual machine.
  5. When imported, the virtual machine appears in the virtual machine library.

Earlier versions

VMware Player 4.x can fail to build VMware Tools with the latest revision of Red Hat Enterprise Linux version 6. Some older versions of VMware tools do not natively support Red Hat Enterprise Linux version 6.

VMware Workstation version 7 and earlier and VMware Player version 3 and earlier do not directly support appliances generated by their current tools. However, you can convert the OVF file using the OVF converter in order to import it.

To convert, enter the following at a command prompt:

"c:\Program Files\VMware\VMware OVF Tool\ovftool" 
    ADDM_VA_64_8.90.5_123456_dev_Community.ovf 
        ADDM_VA_64_8.90.5_123456_dev_Community.vmx

When you have converted the file, you can install it using File > Open.

Post Installation

Important Post Installation Steps

It is important to consider the following steps after installing.

VMware tools

VMware Tools is required but is not installed on the shipped BMC Atrium Discovery Virtual Appliance, as the correct version of the tools is dependent on the version of the VMware host. When you have installed the BMC Atrium Discovery Virtual Appliance, you must always install VMware Tools.

To install VMware Tools

The following procedure describes how to install VMware Tools. For full information, see the documentation available on the VMware Support site:

  1. From VMware Infrastructure Client, right click the virtual machine in the left pane.
  2. Select Install/Upgrade VMware Tools. This makes a virtual CD device available to the virtual machine.
  3. Log in to the virtual machine command line, and change to the root user.
  4. To determine the device name/drive name for the currently installed and connected CD-ROMs or DVD-ROMs, issue the following command:
    cat /proc/sys/dev/cdrom/info | grep "drive name"
  5. Issue the following commands (change the XXX-nnnnnnin the RPM or tar file name below to the version presented by your VMware product):
    1. mkdir /mnt/cdrom
    2. mount -t iso9660 /dev/<device> /mnt/cdrom
      where <device> is the device name reported in step 4.
      Enter one of the following commands depending on whether VMware Tools is supplied on the virtual CD as an RPM, or a tar file.
      1. If you have an rpm enter the following command:
        rpm -i /mnt/cdrom/VMwareTools-XXX-nnnnnn.x86_64.rpm
        umount /mnt/cdrom
      2. If there is a tar file, enter the following commands:
        cd /tmp
        tar zxvf /mnt/cdrom/VMwareTools-XXX-nnnnnn.tar.gz
        umount /mnt/cdrom
        cd vmware-tools-distrib
        ./vmware-install.pl
  6. Respond to the configuration questions on the screen. Press Enter to accept the default value.

If at any later point, you need to re-run the VMware tools script, the default location will be:
/usr/bin/vmware-install.pl

Setting up NTP

It is essential to configure ntp on your BMC Atrium Discovery Virtual Appliance. If significant clock skews occur then it can impact the functioning of the system or even prevent the BMC Atrium Discovery product from starting. VMware have documented their recommended timekeeping best practices for Linux based VMs. The KnowledgeBase article can be found here.

Configure the appropriate time zone

It is sensible to configure the Virtual Appliance to be in the time zone appropriate to its location. See Localizing the appliance for more information about this.

Next Steps

Once the Virtual Appliance is installed it is a good time to configure it to have sufficient resources for its intended use. Doing so now will be easier than extending the resources once the Virtual Appliance has been in use for some time.

See Configuring the Virtual Appliance for details.

Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Lisa Keeler

    Post Installation should include something about getting an IP address if you do not run DHCP.  

    Sep 25, 2015 10:07