Install EMC ViPR SRM Using the Binary Installer

Table of Contents

Back to Top

Options for standard installation

You have several options when you perform a binary installation of the EMC M&R platform.

The EMC M&R platform infrastructure consists of three types of hosts:

Note Image
You can have only one Primary Backend host. You can add Additional Backend hosts to scale out a deployment.

The EMC M&R platform binary installation package supports the following installation options.

Default (UNIX) or Recommended Modules (Windows) installation

To install all of the modules in the EMC M&R platform binary installation package, use this option.

You can use this option on a single host and enable it to serve as a Frontend, Backend, and Collector host. You can customize this host further by manually adding or removing specific modules.

Host-specific installations

To install software only on a specific host (Frontend, Backend or Collector host), use the same EMC M&R platform binary installation package and select the type of host to install.

Minimal (UNIX) or Base Installation (Windows)

To install the minimum modules required for any host type, use this option. You can customize this host by manually adding specific modules.

Back to Top

Installing EMC M&R platform on UNIX

You can install the EMC M&R platform on supported UNIX hosts. This procedure specifically uses the Linux installation procedure as an example.

Before you begin

  • When you install EMC M&R platform on a UNIX server, assign executable permissions to the installation script.
  • Ensure that you have a login with root privileges to run the installer.
  • Download the installation package from support.emc.com, and place it in a temporary location on the server. For ViPR SRM 3.5, the file is EMC_MnR_6.4_Linux_64-bit_Setup_File.sh. For ViPR SRM 3.5.1, the file is ViPR_SRM_3.5.1_Linux_x86_64.tgz.

Procedure

  1. Log in to the server as root.
  2. For ViPR SRM 3.5.1, extract the ViPR_SRM_3.5.1_Linux_x86_64.tgz file.
  3. Change the permissions of the installer.
    For example, for the Linux 64-bit executable, type:

    chmod +x EMC_MnR_<version_number>_Linux_64-bit_Setup_File.sh

  4. Run the installer from the directory.
    Example:

    ./EMC_MnR_<version_number>_Linux_64-bit_Setup_File.sh

  5. Read and accept the End User License Agreement.
  6. Accept the default installation directory of /opt/APG or type another location.
  7. Accept the default user account name of apg or type another name.
  8. Accept the default location of service scripts of /etc/init.d or type another location.
  9. Accept the default base directory of/etc for runlevel scripts or type another base directory.
  10. Depending on the host purpose, select one of the following options:
    Option Description
    Default Installs recommended modules available in the binary installation package. You can use this option on a single host, which enables it to serve as a Frontend, Backend and Collector host. To customize this host further, manually add or remove specific modules.
    Frontend Installs web services and front end applications.
    Backend Installs the database and backend services.
    Collector Installs base modules to perform data collection and enrichment.
    Minimal Installs the minimal modules required for any host type. To customize this host further, manually add specific modules.
Back to Top

Installing EMC M&R platform on Windows Server

You can install the EMC M&R platform on supported Windows Server hosts.

Before you begin

  • Ensure that you have a login with system administrator privileges to run the installer.
  • Download the installation package from support.emc.com, and place it in a temporary location on the server. For ViPR SRM 3.5, the file is EMC_MnR_6.4_Windows_64-bit_Setup_File.exe. For ViPR SRM 3.5.1, the file is ViPR_SRM_3.5.1_Win64.zip

Procedure

  1. For ViPR SRM 3.5.1, extract the zip file to temporary location.
  2. Double-click the setup file, for example: EMC_MnR_<version_number>_Windows_64-bit_Setup_File.exe
  3. Click Next on the > Welcome screen.
  4. Read and accept the End User License Agreement. Click I Agree.
  5. Select the Destination Folder:
    1. Change the drive to a Windows non-root drive.
    2. Maintain the default folder structure (Program Files\APG).
    3. Click Next.
  6. Depending on the host purpose, select one of the following options:
    Option Description
    Recommended Modules Installs all recommended modules available in the binary installation package. You can use this option on a single host, which enables it to serve as a Frontend, Backend and Collector host. To customize this host further, manually add or remove specific modules.
    Frontend Modules Installs web services and front end applications.
    Backend Modules Installs the database and backend services.
    Collector Modules Installs base modules to perform data collection and enrichment.
    Base Installation Installs the minimal modules required for any host type. To customize this host further, manually add specific modules.
  7. Click Install.
  8. When the installation is complete, click Next.
  9. To close the installer, click Finish.
Back to Top

Configuring virus-scanning software

Running virus-scanning software on directories containing MySQL data and temporary tables can cause issues, both in terms of the performance of MySQL and the virus-scanning software misidentifying the contents of the files as containing spam.

After installing MySQL Server, it is recommended that you disable virus scanning on the directory used to store your MySQL table data (such as C:\Program Files\APG\Databases\MySQL\Default\data). In addition, by default, MySQL creates temporary files in the standard Windows temporary directory. To prevent scanning the temporary files, configure a separate temporary directory for MySQL temporary files and add this directory to the virus scanning exclusion list. To do this, add a configuration option for the tmpdir parameter to your my.ini configuration file.

Back to Top

Starting the EMC M&R platform services from the command line

After you install EMC M&R platform, start required services.

Before you begin

  • Before you start EMC M&R platform services, ensure the library search path is correct on the server that hosts EMC M&R platform. This requirement applies to the libaio package on Linux.
  • Ensure that you have a login with root, APG, or system administrator privileges. The user apg is the account that the EMC M&R platform application uses instead of root.

Procedure

Type the command for your operating system from the bin directory of the installation:
Operating system Command
UNIX

./manage-modules.sh service start all

Windows

manage-modules.cmd service start all

Results

The platform displays a list of services.

Example:

* Starting 'topology-mapping-service Default'... [ OK ] * Starting 'webservice-gateway Default'... [ OK ] * Starting 'mysql Default'... [ OK ] * Starting 'alerting-backend Default'... [ OK ] * Starting 'backend Default'... [ OK ] * Starting 'collector-manager Default'... [ OK ] * Starting 'collector-manager Generic-SNMP'... [ OK ] * Starting 'collector-manager Load-Balancer'... [ OK ] * Starting 'collector-manager emc smarts'... [ OK ] * Starting 'event-processing-manager emc smarts'... [ OK ] * Starting 'tomcat Default'... [ OK ] * Starting 'task-scheduler Default'... [ OK ]

Back to Top

Verifying if the EMC M&R platform services are running

Verify the EMC M&R platform services are running on each host by obtaining the status.

Before you begin

Ensure that you have a login with root, APG, or system administrator privileges. The user apg is the account that the EMC M&R platform application uses instead of root.

Procedure

  1. Type the command for your operating system from the bin directory of the EMC M&R platform installation:
    Operating system Command
    UNIX ./manage-modules.sh service status all
    Windows manage-modules.cmd service status all
  2. Verify that each service has a status of running in the output.

Results

Example:

* Checking 'topology-mapping-service Default'... [ running ] * Checking 'webservice-gateway Default'... [ running ] * Checking 'mysql Default'... [ running ] * Checking 'alerting-backend Default'... [ running ] * Checking 'backend Default'... [ running ] * Checking 'collector-manager Default'... [ running ] * Checking 'collector-manager Generic-SNMP'... [ running ] * Checking 'collector-manager Load-Balancer'... [ running ] * Checking 'collector-manager emc smarts'... [ running ] * Checking 'event-processing-manager emc smarts'... [ running ] * Checking 'tomcat Default'... [ running ] * Checking 'task-scheduler Default'... [ running ]

Back to Top

Troubleshooting service start-up problems on UNIX

Check the log files when services do not start.

Before you begin

Ensure that you have logged in with root or APG privileges to check the log files.

Procedure

To troubleshoot startup problems, check the following logs in the /opt/APG/ directory:

Databases/MySQL/Default/data/[SERVER NAME].err Backends/Alerting-Backend/Default/logs/alerting-0-0.log Backends/APG-Backend/Default/logs/cache-0-0.log Collecting/Collector-Manager/Default/logs/collecting-0-0.log Web-Servers/Tomcat/Default/logs/service.log Tools/Task-Scheduler/Default/logs/scheduler-0-0.log Tools/Webservice-Gateway/Default/logs/gateway-0-0.log

Back to Top

Troubleshooting service start-up problems on Windows

Check the log files when services do not start.

Before you begin

Ensure that you have logged in with system administrator credentials to check the log files.

Procedure

To troubleshoot start-up problems, check the following logs in the C:\Program Files\APG directory:

Databases\MySQL\Default\data\[SERVER NAME].err. Backends\Alerting-Backend\Default\logs\alerting-0-0.log Backends\APG-Backend\Default\logs\cache-0-0.log Collecting\Collector-Manager\Default\logs\collecting-0-0.log Web-Servers\Tomcat\Default\logs\service.log Tools\Task-Scheduler\Default\logs\scheduler-0-0.log Tools\Webservice-Gateway\Default\logs\gateway-0-0.log

Back to Top

Logging in to the User Interface

Log in to view reports or test user access.

Procedure

  1. Open a browser, and then type the URL.
    Example: http://<Frontend-hostname>:58080/APG
  2. Log in.
    1. Type the login credentials.
      The default username is admin. The default password is changeme.
    2. Click Sign In.

After you finish

You are automatically logged off after four hours.

Back to Top

Connecting to Centralized Management

Connect to the server so that you can access Centralized Management to install and administer SolutionPacks.

Centralized Management is one of the multiple web applications available in EMC M&R platform.

Procedure

  1. Open a browser.
  2. Type http://<serverIP:port>/centralized-management.
    The serverIP is the fully qualified hostname or IP address of the server where EMC M&R platform runs.
    The port is the port number of the server.

    Example:

    http://myHost.emc.com:58080/centralized-management

  3. Log in.
    1. Default username is admin.
    2. Default password is changeme.
    3. Click Sign In.

After you finish

You are automatically logged off after four hours.

Back to Top

Confirming settings for the first time

After you first log in with administrator credentials for EMC M&R platform, you must confirm the configuration settings for the server.

Procedure

To accept the predefined values for the server, click Save.
Blank fields must remain blank.