[an error occurred while processing this directive]

ViPR SRM 3.6 – Install Using the Binary Installer

Table of Contents

Options for standard installation

Learn how to install the EMC M&R platform using a binary installation package.

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

Procedure

  1. Log in to the server as root.
  2. Change the permissions of the installer.
    For example:
    chmod +x <file_name>.sh
  3. Run the installer from the directory.
    For example:
    ./<file_name>.sh
  4. Read and accept the End User License Agreement.
  5. Accept the default installation directory of /opt/APG or type another location.
  6. Accept the default user account name of apg or type another name.
  7. Accept the default location of service scripts of /etc/init.d or type another location.
  8. Accept the default base directory of/etc for runlevel scripts or type another base directory.
  9. 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 file from support.emc.com, and place it in a temporary location on the server.

Procedure

  1. Double-click the .exe file.
  2. Click Next on the Welcome screen.
  3. Read and accept the End User License Agreement. Click I Agree.
  4. 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.
  5. 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.
  6. Click Install.
  7. When the installation is complete, click Next.
  8. 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

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.
Note Image
The list of available services will vary depending upon choices (Collector, Backend, Frontend, Default, or Minimal) made during installation.

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

Note Image
The list of available services will vary depending upon choices (Collector, Backend, Frontend, Default, or Minimal) made during installation.

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

Look for log files in these /opt/APG/ directory paths.
The list of available log files will vary depending upon choices made during installation. (Collector, Backend, Frontend, Default, or Minimal installations will generate different sets of log files.)
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

Look for log files in these C:\Program Files\APG directory paths.
The list of available log files will vary depending upon choices made during installation. (Collector, Backend, Frontend, Default, or Minimal installations will generate different sets of log files.)
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.
Back to Top

Configuring the user process limits for a Linux installation

Increase the user process limits for the user account to a maximum of 65534. This modification enables services to open 65534 files and 65534 processes when needed.

Before you begin

Procedure

  1. Open the /etc/security/limits.conf file.
  2. Add the following lines for the user.
    In this example, the user is apg.
    apg   hard  nofile  65534
    apg   soft  nofile  65534
    apg   hard  nproc   65534
    apg   soft  nproc   65534
    
  3. Save the file.
  4. To restart the services, type the following commands from the bin directory of the installation:
    ./manage-modules.sh service stop all
    ./manage-modules.sh service start all
  5. To verify the changes, type su apg -c 'ulimit -n -u'
Back to Top

Related Articles

Using the 1VM vApp to Scale Out the EMC ViPR SRM Environment - Describes a simple way to add backends and collectors to an existing EMC ViPR SRM base instance.

Using the Binary Installer to Scaleout the ViPR SRM Environment - Describes how to manually install a ViPR SRM solution that consists of a frontend, backend, additional backend, and one collector.

Back to Top
[an error occurred while processing this directive]