MS_MUSI_InstallationGuide_Linux MS MUSI Installation Guide Linux

User Manual:

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

INSTALLATIONGUIDE

(FORLINUX)

RELEASE6.1SP1‐PATCH3

SEPTEMBER2014

MetricStreamUniversalInstaller

MSUI6.1SP1Patch3‐InstallationGuide

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.

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

MSUI6.1SP1Patch3‐InstallationGuide

Pageiv Copyright©2014MetricStreamInc.

#APACHEParameters‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐I

#TomcatParameters ‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐II

#ApacheTomcatServiceNames ‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐II

#ECPLogs ‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐II

Xmanager ‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐ III

PuTTY ‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐ III

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.

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.

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.

MSUI6.1SP1Patch3‐InstallationGuide

Pagevi Copyright©2014MetricStreamInc.

ChapterSummaries

Thisguideconsistsofthefollowingchapters.

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/

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.

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:

MSUI‐FeaturesandPrerequisites

1. KeyFeaturesofMSUI

2.PrerequisitesandAssumptions

3.SoftwareandHardwareRequirements

4.AdditionalRequirements

MSUI6.1SP1Patch3‐InstallationGuide

Page2Copyright©2014MetricStreamInc.

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

MSUI‐FeaturesandPrerequisites

SoftwareandHardwareRequirements

ThefollowingtableprovidesthehardwareandsoftwarerequirementsforinstallingMSUI.

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.

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

MSUI6.1SP1Patch3‐InstallationGuide

Page4Copyright©2014MetricStreamInc.

ThischapterprovidesinformationonhowtoinstallMSUI.

Sectionsofthischapter:

InstallingMSUI

1. InstallationOverview

2.CommandLine(Silent)Installation

3.Re‐InstallingMSUI

MSUI6.1SP1Patch3‐InstallationGuide

Page6Copyright©2014MetricStreamInc.

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2Execute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

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.

MSUI6.1SP1Patch3‐InstallationGuide

Page8Copyright©2014MetricStreamInc.

ThischapterprovidesinformationoninstallingGRCplatformandotherMetricStreamapplicationsus‐

ingMSUI.

Sectionsofthischapter:

InstallingGRCPlatformandApplications

1. PointersBeforeInstallingGRCPlatformandApplications

2.-UsingMSUICommandLineInterface

Commands

CommandOptions

3.-UsingtheMSUI‐GUIInterface

DatabaseConfiguration

EGRCPConfiguration

WebSeverConfiguration

ApplicationServerConfiguration

InstallModules

4.PointersAfterInstallingEGRCPandOtherApplications

MSUI6.1SP1Patch3‐InstallationGuide

Page10 Copyright©2014MetricStreamInc.

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.

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.

Formoreinformationontheparameters,refertotheAppendixsection.

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2Runthefollowingcommand.

./MS_Universal_Installer.sh [-f] [-health] [-help] [-p <schemapassword>] [-s <sys-

tempassword>]

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.

MSUI6.1SP1Patch3‐InstallationGuide

Page12 Copyright©2014MetricStreamInc.

Commands

Thefollowingtableprovidesthecommandsanditsdescriptions.

Command UsethisCommandto... Usage

‐fRun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 Viewtheversionnum‐

bersandavailable

optionsforinstallation.

usage: ./MS_Universal_Installer.sh [-f] [-

health] [-help] [-i] [-p

<schemaPassword>] [-s <systemPassword>]

-f Script will Run in Com-

mand/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: XMan-

ager ).

-p <schemaPassword> Silent boot Mode for

EGRCP and Module Installation.

-s <systemPassword> Silent boot Mode for

1. Installing and config-

uring Apache.

2. Installing and con-

figuring Tomcat.

3. Creating database

schema if not pre

sent and

4. Installation of

EGRCP and modules.

InstallingGRCPlatformandApplications

‐s<system

password

>‐p

<schema

password

>‐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: Enter Oracle Schema Password (Invisi-

ble)::

‐p<schem‐

apass‐

word>‐F

and‐s

RuntheGRCGplatform

andapplicationinstallers

insilentmode.

-‐p<schemapassword>‐foptionisusedforforce

installationofmodules.(thatis,reinstallevenifthe

applicationissuccessfullyinstalledearlier).

-‐p<schemapassword>‐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 (Invisi-

ble)::

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]

Command UsethisCommandto... Usage

MSUI6.1SP1Patch3‐InstallationGuide

Page14 Copyright©2014MetricStreamInc.

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.

-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.

Option Description

InstallApacheandTomcat?

[y/n]

-Y:ToinstallApache,selectthisoption

-N:ToskipinstallationofApache,selectthisoption.

ConfigureApacheandTom‐

cat?[y/n]

-Y:ToinstallTomcat,selectthisoption

-N:ToskipinstallationofTomcat,selectthisoption.

ConfigureDatabase?[y/n] -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.

Command UsethisCommandto... Usage

InstallingGRCPlatformandApplications

InstalltheApplications?[y/

-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/

-Y:Toconfirmthechoiceandcontinuetheinstallation,select

thisoption.

-N:Toreenterthechoiceandcanceltheinstallation,selectthis

option.

Option Description

MSUI6.1SP1Patch3‐InstallationGuide

Page16 Copyright©2014MetricStreamInc.

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.

Figure3:MSUIInterface

TheMSUIinterfacecomprisesthefollowingoptions.

OptionScreenNumber UsethisOptionto...

01 ConfiguretheDatabase

02 ConfiguretheGRCplatform.

03 InstallandconfiguretheTom catserver.

04 ConfiguretheWebserver.

05 Installtheselectedapplications.

OptionSceens

ToolBar

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.

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.

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

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

InstallingGRCPlatformandApplications

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.

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.

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.

FieldName Description

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.

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...

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.

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.

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.

MSUI6.1SP1Patch3‐InstallationGuide

Appendix

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

#DATABASEParameters

#APACHE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

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

MSUI6.1SP1Patch3‐InstallationGuide

#TomcatParameters

#ApacheTomcatServiceNames

#ECPLogs

Java_Max_HeapSize=1024m maximumvaluefortheheapsizetobeusedbyJVM

WebService_Port=8201 webserviceportnumber

Comment Description

AjpPort=8202 AJPconnectorport

HttpPort=8203 Httpporttobeusedbytheapplication

CtrlPort=8204 ControlportNumber

Tomcat_ApplicationHostNam

MetricStreamTomcat Hostname

Comment Description

ApacheServiceName= ServicenameforApache

TomcatServiceName= ServicenameforTomcat

Comment Description

EcpLogsDirectory= Completepathtothedirectorywherethelogsshouldbegener‐

ated

Comment Description

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.

MS_MUSI_InstallationGuide_Linux MS MUSI Installation Guide Linux

Navigation menu

Versions of this User Manual:

Views

Navigation