Install the MediaAgent - Windows

Where to Install

Install the MediaAgent on a Windows computer that satisfies the minimum requirements specified in System Requirements.

Review the following requirements based on your environment:

  • In a cluster environment, you must install the MediaAgent on a physical computer.
  • If you want to install the MediaAgent on a virtual machine, the virtual machine must be configured with fast-access storage media. Ensure that the CPU and memory resources recommended in System Requirements are always available for the virtual machine.

The computer will be added as a client in the CommCell as soon as the installation completes successfully.

Before You Begin

System Requirements

Verify that the computer in which you wish to install the software satisfies the minimum requirements specified in System Requirements.

Download Software Packages

Download the latest Simpana® software using the Download Manager application. The Download Manager bundles an installation package from the Simpana components that you chose to download. Use the installation package to launch the software installer on a client computer.

See Download Manager - Getting Started for instructions on creating an installation package.

Installation

The software can be installed using one of the following methods:

Method 1: Remote Install Using the CommCell Console

Use this procedure to install remotely on a client computer.

Method 2: Interactive Install - Standard

Use this procedure to install the software using the standard installation options.

Method 3: Interactive Install - Custom

Use this procedure to install the software by specifying installation settings and options.

Method 1: Remote Install Using the CommCell Console

  1. Open CommCell Console:

    • Click Start and point to All Programs.
    • Click Commvault .
    • Click Simpana  Administrative Console.
  2. From the CommCell Browser, click Tools | Add/Remove Software | Install Software.

  3. Click Next.

  4. Click Next.

  5. Click Manually Select Computers.

    Click Next.

  6. Enter the fully qualified domain name of the client computer.

    For example: mycomputer.mydomain.mycompany.com

    Click Next.

    • Do not use space and the following characters when specifying the Host Name:

      \|`~!_@#$%^&*()+=<>/?,[]{}:;'"

  7. Choose one of  the following:

    • Click Next if you want to use the default cache location
    • Click Override Software Cache and specify a new location in the Software Cache box and then click Next

    • The software cache is the location from where the remote install program installs the software.
    • This screen will not appear if the remote cache is not configured. For more information, see Managing Cache - Remote Cache.

  8. Specify the User Name and Password that must be used to access the client computer, and then click Next.

    • The user must be an Administrator or a member of the Administrator group on that computer.
    • Account information is required while performing remote installs for the first time on a client. For subsequent remote installs on that client, click Next without specifying the account information.

  9. Click MediaAgent.

    Click Next

  10. From the Storage Policy to use list, select a storage policy, and then click Next.

    If you want to add this computer to a client group, select a client group from the Available list and click Add >.
    This option will be displayed only if client groups are configured in the CommCell Console. For more information, see Client Computer Groups.

  11. Click Next.

    If necessary you can select additional options. Click the Help button to get more information on the available options.

  12. Click Next.

    If necessary you can select optional settings. Click the Help button to get more information on the available options.

  13. Select one of the following:

    • If firewall configuration is not required, click Next.
    • If this computer and the CommServe is separated by a firewall, click Configure firewall services.

    For firewall options and configuration instructions, see Firewall Configuration and continue with the installation.

  14. Select Immediate.

    Click Next.

  15. Click Finish.

    This screen will reflect the components you selected for install, and may look different from the example shown.

  16. You can track the progress of the job from the Job Controller window of the CommCell console.
    • From the Home menu, click Job Controller.

    Once the job is complete, view the job details from the Admin Job History.

    • Right-click the <CommServe>, point to View and then click Admin Job History.
    • Click Select Install/Upgrade/Remove/Repair Software.
    • Click OK.

  • You can view the following by right-clicking the job:
    • Details of the job
    • Option to Resubmit the job
    • Events associated with the job
    • Logs associated with the job
    • Option to send the Logs associated with the job

Several additional options are available for remotely installing the software from CommCell Console, refer to Install Software from the CommCell Console (Remote Install) for more information.

Method 2: Interactive Install - Standard

  1. Log on to the client computer as an Administrator or as a member of the Administrator group on that computer.
  2. Run SetupAll.exe from the installation package that was created using the Download Manager.
  3. Click I accept the terms in the license agreement.

    Click Next.

  4. Click Standard.

    Click Next.

  5. Click Join an Existing CommCell.

    Click Next.

  6. Click MediaAgent.

    Click Next.

  7. Verify the default location for software installation.

    Click Next.

    If necessary, click Browse... to change the default location.

    • Do not install the software to a mapped network drive
    • Do not use the following characters when specifying the destination path: / : * ? " < > | #
    • It is recommended that you use alphanumeric characters only

  8. Click Install.

    The Summary on your screen should reflect the components you selected for install, and may look different from the example shown.

  9. Click Yes.

  10. Click Next.

  11. Select one of the following:

    • If firewall configuration is not required, click Next.
    • If this computer and the CommServe is separated by a firewall, click Configure firewall services.

    For firewall options and configuration instructions, see Firewall Configuration and continue with the installation.

  12. Enter the fully qualified domain name of the CommServe in the CommServe Host Name box.
    • Do not use space and the following characters when specifying the CommServe Host Name:

      \|`~!@#$%^&*()+=<>/?,[]{}:;'"

    Click Next.

  13. Enter the following:
    • The local (NetBIOS) name of the client computer is displayed in the Select a Client name list.

      If necessary you can also type a new (friendly) name for the client in this box. This name will be used in the CommCell and will also be displayed in the CommCell Console.

      Do not use spaces when specifying a new name for the client.

    • The default network interface name of the client computer is displayed if the computer has only one network interface (NIC card).

      If the computer has multiple network interfaces, select the interface name that is preferred for communication with the CommServe.

    Click Next.

    If a component is already installed on this computer, this screen will not be displayed; instead, the install program will use the same name as previously specified.

  14. Select one of the following options:

    • If you do not want to disable Windows Firewall, click Next.
    • If you want to disable Windows Firewall for all profiles, click Yes, disable Windows Firewall for all profiles and then click Next.

    You will get this screen if you did not configure the firewall settings in step 11.

  15. Select a storage policy from the Storage Policy list.

    Click Next.

    If you do not have a Storage Policy, the list will not be displayed. You can create the Storage Policy later.

  16. Click Finish.

    This screen will reflect the components you selected for install, and may look different from the example shown.

  17. If you have installed the software on a clustered computer, install the software on all the physical nodes and then configure the cluster group client. For more information, see Cluster Configuration.

Components Installed by Default during Standard Install

Listed below are the components that are installed by default while performing the Standard Install:

selected Package Components installed
MediaAgent
  • MediaAgent
  • VSS Provider
  • File System Core
  • Windows File System

Method 3: Interactive Install - Custom

  1. Log on to the client computer as an Administrator or as a member of the Administrator group on that computer.
  2. Run SetupAll.exe from the installation package that was created using the Download Manager.
  3. Click I accept the terms in the license agreement.

    Click Next.

  4. Click Custom.

    Click Next.

  5. Click Select components to install on this computer and click Next.

  6. Expand Storage Resources and then click MediaAgent.

    Click Next.

  7. Verify the default location for software installation.

    Click Next.

    If necessary, click Browse... to change the default location.

    • Do not install the software to a mapped network drive
    • Do not use the following characters when specifying the destination path: / : * ? " < > | #
    • It is recommended that you use alphanumeric characters only

  8. Click Install.

    The Summary on your screen should reflect the components you selected for install, and may look different from the example shown.

  9. Click Yes.

  10. Click Next.

  11. Select one of the following:

    • If firewall configuration is not required, click Next.
    • If this computer and the CommServe is separated by a firewall, click Configure firewall services.

    For firewall options and configuration instructions, see Firewall Configuration and continue with the installation.

  12. Enter the fully qualified domain name of the CommServe in the CommServe Host Name box.
    • Do not use space and the following characters when specifying the CommServe Host Name:

      \|`~!@#$%^&*()+=<>/?,[]{}:;'"

    Click Next.

  13. Enter the following:
    • The local (NetBIOS) name of the client computer is displayed in the Select a Client name list.

      If necessary you can also type a new (friendly) name for the client in this box. This name will be used in the CommCell and will also be displayed in the CommCell Console.

      Do not use spaces when specifying a new name for the client.

    • The default network interface name of the client computer is displayed if the computer has only one network interface (NIC card).

      If the computer has multiple network interfaces, select the interface name that is preferred for communication with the CommServe.

    Click Next.

    If a component is already installed on this computer, this screen will not be displayed; instead, the install program will use the same name as previously specified.

  14. Select one of the following options:

    • If you do not want to disable Windows Firewall, click Next.
    • If you want to disable Windows Firewall for all profiles, click Yes, disable Windows Firewall for all profiles and then click Next.

    This screen will appear when Windows Firewall settings is enabled for profiles.

  15. Select Add programs to the Windows Firewall Exclusion List, to add CommCell programs and services to the Windows Firewall Exclusion List.

    Click Next.

    This option enables CommCell operations across Windows firewall by adding CommCell programs and services to Windows firewall exclusion list.

    It is recommended to select this option even if Windows firewall is disabled. This will allow the CommCell programs and services to function if the Windows firewall is enabled at a later time.

  16. Select one of the following:
    • Click Use Cell level Policy to inherit the global filter policy configuration set for the CommCell.
    • Click Always use Global Filters to apply the global filters policy to the default subclient regardless of the policy set for the CommCell.
    • Select Do not use Global Filters if you plan to define specific filters for the Agent.

    Click Next.

  17. Click Next.

  18. Click Finish.

    This screen will reflect the components you selected for install, and may look different from the example shown.

Additional Installation Methods

Custom Package

Create a compact software package for quick deployment to multiple clients.

Decoupled Install

Install the software first and later register the client in the CommCell.

Remote Install

Deploy the software from CommCell Console on multiple clients.

Installing Restore only Agents

Setup a client in the CommCell for restore purposes.

Silent Install

Deploy the software silently on multiple clients.