MS_MUSI_InstallationGuide_Linux MS MUSI Installation Guide Linux

User Manual:

Open the PDF directly: View PDF .
Page Count: 33

Download
Open PDF In Browser	View PDF

MetricStream Universal Installer
INSTALLATION GUIDE
(FOR LINUX)
RELEASE 6.1 SP1 ‐ PATCH 3
SEPTEMBER 2014

MSUI 6.1 SP1 Patch 3 ‐ Installation Guide

Copyright Notices
Copyright © 2014 MetricStream Inc. All Rights Reserved.
The MetricStream MetricStream Universal Installer Installation Guide Release 6.1 SP1 ‐ Patch 3, as
well as the software described within it, is furnished under license and may only be used or copied with‐
in the terms of that license. The information in this document is provided for informational purposes
only, is subject to change without notice, and should not be construed as a commitment by Metric‐
Stream, Inc. MetricStream, Inc. assumes no responsibility or liability for any errors or inaccuracies that
may appear in this document.
Except as permitted by license, no part of this publication may be reproduced, stored in a retrieval sys‐
tem, or transmitted, in any form or by any means – electronic, mechanical, recording, or otherwise –
without the prior written permission of MetricStream, Inc.
Written and designed at MetricStream, Inc., 2600 East Bayshore Road, Palo Alto, CA 94303, U.S.A.
Printed in the U.S.A.
CAUTION
This document contains proprietary, confidential information that is the exclusive property of Metric‐
Stream, Inc. If you do not have a valid contract with MetricStream for the use of this document, or have
not signed a non‐disclosure agreement with MetricStream, then you received this document in an un‐
authorized manner and are not legally entitled to possess or read it.
Use, duplication, and disclosure are subject to restrictions stated in your contract with MetricStream,
Inc. Use, duplication, and disclosure by the Government are subject to restrictions for commercial soft‐
ware and shall be deemed to be Restricted Rights software under Federal Law.

Page ii

MSUI 6.1 SP1 Patch 3 ‐ Installation Guide

Table of Contents
About This Guide ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐v
Preface ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ v
Documentation Conventions ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ v
Target Audience ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ v
Chapter Summaries ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐vi
Related Documents ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐vi
Documentation Feedback ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐vi

Chapter 1. MSUI ‐ Features and Prerequisites ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 1
Key Features of MSUI ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 2
Prerequisites and Assumptions ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 2
Software and Hardware Requirements ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 3
Additional Requirements ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 3

Chapter 2. Installing MSUI ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 5
Installation Overview ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 6
Command Line (Silent) Installation ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 6
Re‐Installing MSUI ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 7

Chapter 3. Installing GRC Platform and Applications ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 9
Pointers Before Installing GRC Platform and Applications ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 10
Using MSUI Command Line Interface ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 11
Commands ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 12
Command Options ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 14

Using the MSUI‐GUI Interface ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 16
Database Configuration ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 17
EGRCP Configuration ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 18
Web Sever Configuration ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 19
Application Server Configuration ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 20
Install Modules ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 21
Available Installers Pane ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 21
Selected Installers Pane ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 22

MSUI Interface Buttons ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 22

Pointers After Installing EGRCP and Other Applications ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ 23
#DATABASE Parameters ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ I

Page iii

MSUI 6.1 SP1 Patch 3 ‐ Installation Guide

#APACHE Parameters ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ I
#Tomcat Parameters ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ II
#Apache Tomcat Service Names ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ II
#ECP Logs ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ II

Xmanager ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ III
PuTTY ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ ‐ III

Page iv

MSUI 6.1 SP1 Patch 3 ‐ Installation Guide

About This Guide
Preface
The MetricStream MetricStream Universal Installer Installation Guide Release 6.1 SP1 ‐ Patch 3 pro‐
vides information on using the MetricStream MetricStream Universal Installer (MSUI) tool. The Met‐
ricStream Universal Installer tool is used to install and configure database, web server, EGRCP and
other MetricStream applications.

Documentation Conventions
The following conventions are used in this document.
Conventions

Description

Note:

Key pointers, in the form of notes, to help you use this application
effectively and efficiently are provided throughout this guide. You
can recognize a note when you come across a new paragraph in
italics with the word ‘Note’ in red at the beginning of the para‐
graph.
For example:
Note: The installer uses the parameters from the property file to
perform its task, make sure you enter the enter correct values in the
file before the installation.

Boldface

All MetricStream application names, software references, and doc‐
ument names appear in boldface.
Examples:
• Application Name: MetricStream Universal Installer
• Software reference: Selected Installers pane
References to different topics within this User Guide.
For example:
For more information on the parameters, refer to the
Appendix section.

Target Audience
This guide is intended for users who want to install and use the MetricStream Universal Installer tool.
This tool is used for installing MetricStream applications such as EGRCP, Audit Management, Risk Man‐
agement, and so on.

Page v

MSUI 6.1 SP1 Patch 3 ‐ Installation Guide

Chapter Summaries
This guide consists of the following chapters.
Chapter Title

Description

MSUI ‐ Features and Prereq‐
uisites

Provides an overview on the MetricStream Universal Installer
application.

Installing MSUI

Provides information on how to install MSUI.

Installing GRC Platform and
Applications

Provides information on installing GRC platform and other Metric‐
Stream applications using MSUI.

Appendix

Provides information on the Parameters.properties file.

Related Documents
You can refer to the following documents:
•

MetricStream Universal Installer Guide Windows Release 6.1 SP1 ‐ Patch 3

Documentation Feedback
MetricStream welcomes customers' comments and suggestions on the quality and usefulness of this
document.
Your feedback is important. It helps us to best meet your needs as a user of our products. If you have
any suggestions for improvement or have your answer as ‘No’ for any of the following questions, write
to us.
•

Did you understand the context of the procedures?

•

Did you find any errors in the information?

•

Does the structure of the information help you to complete your tasks?

•

Do you need different information or graphics? If so, where, and in what format?

•

Are the examples correct? Do you need more examples?

Send your comments to: Documentation@metricstream.com
If you need training or product support, contact MetricStream Support Services at support@metric‐
stream.com or 800‐858‐5658.
A list of MetricStream offices is available on our Web site: http://www.metricstream.com/

Page vi

MSUI ‐ Features and Prerequisites

This chapter provides an overview on the MetricStream Universal Installer tool, minimum system re‐
quirements to install the MetricStream Universal Installer.
Sections of this chapter:
1.

Key Features of MSUI

Prerequisites and Assumptions

Software and Hardware Requirements

Additional Requirements

Page 1

MSUI 6.1 SP1 Patch 3 ‐ Installation Guide

Key Features of MSUI
Following are the important features of MSUI:


Easy installation, upgrade, and configuration of Apache and Tomcat serevers



Installation, upgrade, and configuration of GRC platform and other MetricStream applications



Configurator interface to modify the client.config.xml values



Log records of installation for easy debugging of errors



Database verification of prerequisites



Automatic backups of files while upgrading the applications



Automatic update of client.config.xml values after installation of GRC platform and applications



Dependency check across modules and versions and related alert messages to complete the instal‐
lations



Supports silent (command line) and GUI modes of installation

Prerequisites and Assumptions
The following are the prerequisites and assumptions for Installing MSUI:


An application server is a database server



Oracle client must be present and installed on the application server (This prerequisite will be dep‐
recated shortly)



Minimum of 5GB free space on application server and 7GB on database server



The MSUI supports any combination of operating system on application and database server

Page 2

MSUI ‐ Features and Prerequisites

Software and Hardware Requirements
The following table provides the hardware and software requirements for installing MSUI.
Type

Requirement

Operating System

Red Hat Enterprise Linux, CentOS Linux (32‐bit and 64‐bit)

RAM

4GB

HDD Size

40GB

Application Servers

Oracle 11.2.0.3 (client and Server) with a database schema

MSUI

6.1 SP1

Additional Requirements


The MSUI supports Apache and Tomcat installations. Any server installation other than Apache
and Tomcat is handled manually.



You need to complete the database, web server installation, and configuration before installing the
MetricStream applications.

Page 3

MSUI 6.1 SP1 Patch 3 ‐ Installation Guide

Page 4

Installing MSUI

This chapter provides information on how to install MSUI.
Sections of this chapter:
1.

Installation Overview

Command Line (Silent) Installation

Re‐Installing MSUI

Page 5

MSUI 6.1 SP1 Patch 3 ‐ Installation Guide

Installation Overview
You can install MSUI using the command line on Linux and GUI on windows. The command line instal‐
lation is also termed as silent installation and you can execute the installer using Putty or Linux termi‐
nal.

Command Line (Silent) Installation
To install MSUI for Linux platform using the command line, perform the following steps:
Step 1

Download the installer software MS_Universal_Installer.bin.

Note: Provide execute permission to MS_Universal_Installer.bin (chmod 755
MS_Universal_Installer.bin).
Step 2

Execute the following command in the directory that contains the downloaded installer

./MS_Universal_Installer.bin

< MetricStream Installation directory>

The following message appears.

Figure 1: MSUI Installation Message
After installation the following directories are created in the MSUI installed folder.

Figure 2: Installation Directories

Page 6

Installing MSUI

Re‐Installing MSUI
To re‐install MUSI, perform the following step:


Extract a backup of the MS_Universal_Installer directory and re‐install in the same location.

Page 7

MSUI 6.1 SP1 Patch 3 ‐ Installation Guide

Page 8

Installing GRC Platform and Applications

This chapter provides information on installing GRC platform and other MetricStream applications us‐
ing MSUI.
Sections of this chapter:
1.

Pointers Before Installing GRC Platform and Applications



Using MSUI Command Line Interface
Commands
Command Options



Using the MSUI‐GUI Interface
Database Configuration
EGRCP Configuration
Web Sever Configuration
Application Server Configuration
Install Modules

Pointers After Installing EGRCP and Other Applications

Page 9

MSUI 6.1 SP1 Patch 3 ‐ Installation Guide

Pointers Before Installing GRC Platform and Applications
The below points are to be considered before you install EGRCP and other applications using the Com‐
mand Line interface (CLI):


Edit the property file of the MetricStream Installation directory\MS_Universal_Installer\msui\
parameters.Properties with the relevant values for your installation.
For more information on the parameters, refer to the Appendix section.

Note: The installer uses the parameters from the property file to perform its task, make sure you enter
the enter correct values in the file before the installation.


The default location for the parameters.properties file is MetricStream Installation direc‐
tory\MS_Universal_Installer\msui\. The entries in the Installer_List.txt must contain the list of
modules to be installed. The entries in the Installer_list.txt file must be the name of the installer
file including the extension. for example, ISM_6.1.1.jar



Do not delete or rename the text file Installer_List.txt present in the MS_Installers directory.

Page 10

Installing GRC Platform and Applications

Using MSUI Command Line Interface
To install EGRCP using MSUI Command line interface, perform the following steps:
Step 1

Change the working directory to MetricStream Installation directo‐
ry\MS_Universal_Installer

Step 2

Run the following command.

./MS_Universal_Installer.sh

[-f] [-health] [-help] [-p ] [-s ]

The installer is invoked. To continue the installation use the commands provided in the below table.
Note: If the schema already exists, then MSUI installs the products mentioned in the Installer_list.prop‐
erties.

Page 11

MSUI 6.1 SP1 Patch 3 ‐ Installation Guide

Commands
The following table provides the commands and its descriptions.
Command

Use this Command to...

Usage

‐f

Run in command/shell
mode with force installa‐
tion.

Not applicable

‐health

Validate the system
health.

This command prompts the user to provide the schema
password. If valid password in entered, it performs the
validation and generates the report. The reports are
available at MetricStream Installation directory\logDir or
in the log directory configured in the parameters.proper‐
ties. The file name is HealthCheck_ (timestamp).html
The output for the command is given below:
..\MS_Universal_Installer>MS_universal_Install
er -health
MetricStream Universal Installer - [
Version - 6.1.1.0 Alpha ]
Press ENTER to use the property file from
default location OR provide the fully qualified
path of the property file:[ENTER]

Next, system will prompt for the properties file as:
Input:

Enter Oracle Schema Password

(Invisible)::

‐help

Page 12

View the version num‐
bers and available
options for installation.

usage: ./MS_Universal_Installer.sh [-f] [health] [-help] [-i] [-p
] [-s ]
-f
Script will Run in Command/Shell Mode with force
installation.
-health
Health check of Database
-help
To see the Version and
Available Options.
-i
For Interactive Mode
Installation. Supported Only
on GUI Console ( eg: XManager ).
-p
Silent boot Mode for
EGRCP and Module Installation.
-s Silent boot Mode for
1. Installing and configuring Apache.
2. Installing and configuring Tomcat.
3. Creating database
schema if not pre
sent and
4. Installation of
EGRCP and modules.

Installing GRC Platform and Applications

Command

Use this Command to...

Usage

‐s ‐p
‐f

Run the installers in silent
mode.

Use this command to install individual applications. If
you want to install any application, copy the installers or
jars to MetricStream Installation directory\MS_Installers
directory. Make an entry (installer name with extension)
in the Installer_List.txt file in the order in which the mod‐
ules need to be installed before initiating the installation
process.
If the schema password is not entered in the command
line, then the system will prompt for the schema pass‐
word.
The output for the command is given below:
..MS_Universal_Installer>MS_universal_Installe
r -p
MetricStream Universal Installer - [
Version - 6.1.1.0 Alpha ]
Input:
ble)::

‐p ‐F
and ‐s

Run the GRCG platform
and application installers
in silent mode.



Enter Oracle Schema Password (Invisi-

‐p ‐f option is used for force
installation of modules. (that is, reinstall even if the
application is successfully installed earlier).
‐p ‐s option perform a silent
installation of the modules specified in the
Installer_list.txt file. Copy the installers or jars to
MetricStream Installation directory\MS_Installers
directory. Make an entry (installer name with exten‐
sion) in the Installer_List.txt file in the order in which
the modules need to be installed before initiating the
installation process. The system will prompt the user
for the schema password.
Next, system will prompt for the properties file as
shown below:

Press ENTER to use the property file from
default location OR provide the fully qualified
path of the property file:[ENTER]

After choosing ‐s option the system allows the user to
perform the following administrate related activities:
If the system password is not entered in the command
line, the system prompts the user to enter the system
password as shown below:
..\MS_Universal_Installer>MS_universal_Install
er.bat -s
MetricStream Universal Installer - [
Version - 6.1.1.0 Alpha ]
Input: Enter Oracle System Password (Invisible)::
System

prompts for the properties file as shown

below:
Press ENTER to use the property file from
default location OR provide the fully qualified
path of the property file:[ENTER]

Page 13

MSUI 6.1 SP1 Patch 3 ‐ Installation Guide

Command

Use this Command to...

Usage




If ‐p option and schema password is not available on
the command line along with ‐p, then the system dis‐
plays the message to the user for providing valid
schema password.
If valid system password and schema password is
entered, and if MSUI cannot find the schema in the
database mentioned, then the system will prompt
the user as shown below:

For more information on command options, refer to the below table.

Command Options
The following table provides information on the command options. These options enables you to install
Apache, Tomcat, and configure the database. The entries in the Installer_List.txt contain the list of
modules to be installed. The installer performs a validation of the data provided and you can view the
results at MetricStream Installation directory\MS_Universal_Installer\HealthCheck_xxx(time‐
stamp).html.
Option

Description

Install Apache and Tomcat?
[y/n]



Configure Apache and Tom‐
cat? [y/n]



Configure Database? [y/n]



Y: To install Apache, select this option
N: To skip installation of Apache, select this option.
Y: To install Tomcat, select this option
N: To skip installation of Tomcat, select this option.
Y: If you want the installer to perform the database configura‐
tion, select this option.
N: If you do not want the installer to perform the database con‐
figuration, select this option.

Note: You can use the option y where the database configuration is
yet to be done.

Page 14

Installing GRC Platform and Applications

Option

Description

Install the Applications? [y/
n]




Y: To install selected applications, select this option.
N: To skip installation of selected applications, select this
option.

Note: To install any application, copy the installers or jars to Metric‐
Stream Installation directory\MS_Installers directory. Make an en‐
try (installer name with extension) in the Installer_List.txt file in the
order in which the modules need to be installed.
CONFIRM: Are you sure? [Y/
N]




Y: To confirm the choice and continue the installation, select
this option.
N: To reenter the choice and cancel the installation, select this
option.

Page 15

MSUI 6.1 SP1 Patch 3 ‐ Installation Guide

Using the MSUI‐GUI Interface
You can install the EGRCP and other applications using the MSUI interface. To perform tasks using the
GUI installation, you need to use Xmanager or any other tool which supports Linux GUI based installa‐
tion.
The following figure depicts the MSUI interface.

Tool Bar

Option Sceens
Figure 3: MSUI Interface
The MSUI interface comprises the following options.
Option Screen Number

Use this Option to...

Configure the Database

Configure the GRC platform.

Install and configure the Tomcat server.

Configure the Web server.

Install the selected applications.

Page 16

Installing GRC Platform and Applications

Database Configuration
Use the Database Configuration screen to provide the database configuration details. You must pro‐
vide the valid database details in this screen. The following table provides the fields of this screen.

Figure 4: Database Configuration Screen
Field Name

Type the...

Database URL

URL of the target DB.
Example: jdbc:oracle:thin:@localhost:1521:orcl

Database Driver

Driver of the database.
Example: oracle.jdbc.OracleDriver

System Password

Password for the DB system.

Schema User Name

Name of the DB schema that you want to create.

Schema Password

Password of the DB schema that you want to create.

Confirm Schema Password

Re‐enter the same password entered in the Schema Password
field.

Data Tablespace Name

Name of the tablespace that you want to create.

Data Tablespace Location

Physical location of the DB tablespace.

Index Tablespace Name

Name of the index tablespace that you want to create.

Index Tablespace Location

Physical location of the index tablespace.

Temp Tablespace Name

Name of the temp tablespace.

Default Locale

Default language that needs to be considered.

Page 17

MSUI 6.1 SP1 Patch 3 ‐ Installation Guide

EGRCP Configuration
Use the Configure GRC Platform screen to configure the GRC platform. The information provided in
this screen is used by MSUI to configure EGRCP whenever it is installed or upgraded.
Field Name

Description

Deployment Type

Displays the value “Single Node Deployment”.

Use Secure Installation

Yes: If you want to secure the installation, select this option.
No: If you do not want to secure the installation, select this option.

Min Heap Size

Type the minimum heat size.
Example: 256m

Max Heap Size

Type the maximum heat size.
Example: 1024m

Enterprise Name

Type the Enterprise name.
Example: MetricStream
Note: ‘ECP’ must not be provided as the Enterprise Name.

Webserver Admin Email

Type the e‐mail ID of the admin server.
Example: abcd@metricstream.com

Webserver Domain Name

Type the name of the domain web server.
Example: msi‐l1234.metricstream.com

Work Flow Host Name

Type the workflow host name.
Example: msi‐l1234.metricstream.com

Agent Port Number(SQL
Infolet)

Type the port number for SQL infolet.
Example: 8277

Agent Port Number(Non‐SQL
Infolet)

Type the port number for non‐SQL infolet.

Web Service Port Number

Type the port number of the web server.
Example: 8279

Log Directory

Type the name of the directory where MSUI needs to record the
logs.

Page 18

Installing GRC Platform and Applications

Web Sever Configuration
Use the Web Sever Configuration screen to configure the Apache web server. The following table pro‐
vides the fields of this screen.

Figure 5: Web Server Configuration
Field Name

Type the...

Web Server Host Name

Name of the host server.
Example: msi‐l1234.metricstream.com

Web Server Service Name

Name of the Apache server that needs to be created.
Example: MSApache25

Web Server Port Number

Port number of the Apache server that needs to be created.
Example: 8055

Page 19

MSUI 6.1 SP1 Patch 3 ‐ Installation Guide

Application Server Configuration
Use the Application Sever Configuration screen to configure the Tomcat application server. The fol‐
lowing table provides the fields of this screen.

Figure 6: Application Server Configuration Screen
Field Name

Description

User Load balancing?

This field has the following option buttons:
 Yes: If you want to distribute the data load across multiple com‐
puting resources, select this option.
 No: If you do not want to distribute the data load across multi‐
ple computing resources, select this option.
Note: Load balancing optimizes resource use, maximize through‐
put, minimize response time, and avoid overload of any one of the
resources.

Tomcat Connector Port(AJP)

Type the unique port that is used for connecting Tomcat with
Apache server.
Example: 8217

Tomcat Connector
Port(HTTP)

Type the unique port number for Tomcat to listen to HTTp requests.
Example: 8218

Tomcat Control Port

Type the unique control port number for the Tomcat server.
Example: 8219

Page 20

Installing GRC Platform and Applications

Field Name

Description

Application Server Host
Name

Type the host name of the sever where you want to host the Tom‐
cat server.
Example: msi‐l1234.metricstream.com
Note: This field is made unavailable if you select the value No in the
User Load balancing? field.

Tomcat Service Name

Type the name of the Tomcat host service.
Example: MSTomcat25
Note: This field is made unavailable if you select the value No in the
User Load balancing? field.

Install Modules
Use the Install Modules screen to install the GRC platform and other applications. This screen compris‐
es the following panes:


Available Installers



Selected Installers

Available Installers Pane
The Available Installers pane shows the list of Installers that are available. You need to place the in‐
stallers in the ms_installer folder of the MSUI. You can use WinScp to copy the required installers.
Click the Install >> Modules option on the Tool bar to populate the list of available installers in this
pane.
The following table provides the list of buttons available in this pane.
Button

Use this Button to...
Move all the available installers from the Available Installer pane
to the Selected Installer pane.
Move the selected installers from the Available Installer pane to
the Selected Installer pane.
Move the selected installers from the Selected Installer to the
Available Installer pane to pane.
Move all the selected installers from the Selected Installer to the
Available Installer pane to pane.

Page 21

MSUI 6.1 SP1 Patch 3 ‐ Installation Guide

Selected Installers Pane
The Selected Installers pane shows the list of Installers that you have choosen. You need to use the
buttons available in the Available Installers pane to move the required installers that you want to in‐
stall. You can also define the sequence in which you want to install the applications in this pane.
The following table provides the list of buttons available in this pane.
Button

Use this Button to...
Move the selected installer to the top.

Move the selected installer upwards.

Move the selected installer downwards.

Move all the selected installers to the bottom.

MSUI Interface Buttons
The MSUI user interface include common buttons. The following table provides the a list of buttons and
their descriptions.
Button

Use this Button to...
Discard the entered details and close the screen.
Note: After clicking this button, the MSUI start screen appears.
Save the details entered in the screen.
Note: After clicking this button, the MSUI start screen appears.
Configure or Install the application or server.

Page 22

Installing GRC Platform and Applications

Pointers After Installing EGRCP and Other Applications
The below points are to be considered after you install EGRCP and other applications using the com‐
mand line interface (CLI):


After installation you can view all the configuration parameters for the application at MetricStream
Installation directory\MS_Universal_Installer\msui\msuiConfig.xml.



Generate fresh license keys and copy them to MetricStream Installation directory\SYSTEMi\Sys‐
temi\keys folder.

Page 23

MSUI 6.1 SP1 Patch 3 ‐ Installation Guide

Page 24

Appendix
The following section provides information on the Parameters.properties file.

#DATABASE Parameters
Comment

Description

DatabaseHostName =

Host name of the database server

DbPort =1521

Database port

Sid=

Database name of the INSTANCE.

Oracle_Client=thin

Value as thin/ thick Oracle client [ default thin]

SchemaName=

Schema Name for Metricstream Application.

TableSpace_Data=

Data Tablespace name only

TableSpace_IDX=

Index Tablespace name only

TableSpace_Idx_Location=

Complete path to the TableSpace_IDX without tablespace name

TableSpace_Data_Location=

Complete path to the TableSpace_Data without table space name

TableSpace_Temp=TEMP

Use value TEMP tablespace name

EnterpriseName=

Enterprise name for Metricstream Application

Locale=en_US

Default locale

DataBaseDriverName=ora‐
cle.jdbc.OracleDriver

The driver class for database connection

JdbcExecutionFlag=No

Whether the JDBC connection needs to be used for running Data‐
base scripts or not

#APACHE Parameters
Comment

Description

Deployment_Type=Single

Single / multi node deployment [ default single]

HostName=

Metricstream application host name

WebServer_HostName=

MetricStream Web server Name

Admin_Email=

admin email id to be used

Webserver_Port=8085

Metricstream application host name

WorkFlow_HostName=

Host name

Sql_AgentPort=8274

Metricstream application host name

NonSql_AgentPort=8278

Metricstream application host name

Secure_Option=No

Metricstream application host name

Java_Min_HeapSize=256m

Minimum value for the heap size to be used by JVM

Page I

MSUI 6.1 SP1 Patch 3 ‐ Installation Guide

Comment

Description

Java_Max_HeapSize=1024m

maximum value for the heap size to be used by JVM

WebService_Port=8201

web service port number

#Tomcat Parameters
Comment

Description

AjpPort=8202

AJP connector port

HttpPort=8203

Http port to be used by the application

CtrlPort=8204

Control port Number

Tomcat_ApplicationHostNam
e=

MetricStream Tomcat Hostname

#Apache Tomcat Service Names
Comment

Description

ApacheServiceName=

Service name for Apache

TomcatServiceName=

Service name for Tomcat

#ECP Logs
Comment

Description

EcpLogsDirectory=

Complete path to the directory where the logs should be gener‐
ated

Page II

MSUI 6.1 SP1 Patch 3 ‐ Installation Guide

Xmanager
The Xmanager is a powerful and easy‐to‐use PC X server software program that runs on a Windows
platform. It allows you to bring remote UNIX/Linux desktops to your Windows PC seamlessly. You can
also run remote X applications securely through the SSH (Secure Shell) protocol even when your Win‐
dows PC is inside a private network and a firewall is between your PC and the remote server. The Xman‐
ager incorporates a variety of new features such as multiple server profiles, multi‐visual, multi‐monitor
support, multi‐user configuration, multiple XDMCP sessions and SSH security enhancement. It offers
many advanced options to meet the needs of professional users and also has been designed as simply
as possible for beginners. For more information, refer to http://www.netsarang.com/docs/
xmanager30_manual.pdf.

PuTTY
PuTTY is a free software application for various operating systems which can be used to make an SSH
connection to your server.

Page III

Source Exif Data:

File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.6
Linearized                      : Yes
Language                        : en
Tagged PDF                      : Yes
XMP Toolkit                     : Adobe XMP Core 5.2-c001 63.139439, 2010/10/03-12:08:50
Create Date                     : 2014:09:23 16:29:56Z
Creator Tool                    : FrameMaker 10.0.2
Modify Date                     : 2014:09:23 16:30:53+05:30
Metadata Date                   : 2014:09:23 16:30:53+05:30
Producer                        : Acrobat Elements 10.0.0 (Windows)
Format                          : application/pdf
Title                           : MS_MUSI_InstallationGuide_Linux.book
Creator                         : sherins
Document ID                     : uuid:5d351638-c187-4099-ac5d-f614a8706f05
Instance ID                     : uuid:ed972490-8aaf-4965-aabe-749b06501261
Page Mode                       : UseOutlines
Page Count                      : 33
Author                          : sherins

EXIF Metadata provided by EXIF.tools

MS_MUSI_InstallationGuide_Linux MS MUSI Installation Guide Linux

Navigation menu

Versions of this User Manual:

Views

Navigation