Meridium APM Installation

464 Pages·2017·4.64 MB·English

by  Meridium, Inc.

MeridiumAPMInstallation
Meridium APM Installation
V3.6.1.6.0
Copyright©2017General Electric Company. All rightsreserved. • Page1of464
CopyrightandLegal
Meridium APM Installation
V3.6.1.6.0
©2017 General Electric Company.
GE, the GEMonogram, and Predix are either registered trademarksor trademarksof
General Electric Company. All other trademarksare the property of their respective
owners.
Thisdocumentmay containConfidential/Proprietary informationof General Electric
Company and/or its suppliersor vendors. Distributionor reproductionis prohibited
withoutpermission.
THISDOCUMENTAND ITSCONTENTSAREPROVIDED "ASIS," WITH NO
REPRESENTATIONORWARRANTIESOF ANY KIND, WHETHEREXPRESSORIMPLIED,
INCLUDING BUTNOTLIMITED TO WARRANTIESOF DESIGN, MERCHANTABILITY, OR
FITNESSFORA PARTICULARPURPOSE. ALL OTHERLIABILITY ARISING FROM RELIANCE
UPONANY INFORMATIONCONTAINED HEREINISEXPRESSLY DISCLAIMED.
Accessto and use of the software described in thisdocumentis conditioned on accept-
ance of the End User License Agreementand compliance with its terms.
Copyright©2017General Electric Company. All rightsreserved. • Page2of464
AboutThisDocument
About This Document
Thisfileis provided so thatyou can easilyprintthissectionof theMeridium APMHelp
system.
You should, however, use the Help system instead of aprinted document. Thisis
becausetheHelp system provideshyperlinksthatwill assistyou in easilylocatingthe
related instructionsthatyou need. Such linksarenotavailablein aprintdocument
format.
TheMeridium APMHelp system can beaccessed withinMeridium APMitself or viathe
Meridium APMDocumentationWebsite(https://www.me-
ridium.com/secure/documentation/WebHelp/Home.htm).
Note: If you do nothaveaccessto theMeridium APMDocumentationWebsite, con-
tactGEGlobal Support(https://www.ge.com/digital/asset-performance-management).
Copyright©2017General Electric Company. All rightsreserved. • Page3of464
TableofContents
Table of Contents
Meridium APM Installation 1
Copyrightand Legal 2
AboutThisDocument 3
Table of Contents 4
Aboutthe Installation, Upgrade, and System AdministrationDocumentation 10
IHave my Meridium APM DistributionPackage - Now What? 12
DeployingMeridium APM for the FirstTime 13
Updatingor UpgradingMeridium APM to V3.6.1.6.0 14
Directory of Shortcutsto the MostFrequently Visited Topics 25
Directory of Additional Meridium APM Components 26
Overview: The Basic Meridium APM System 33
The Basic Meridium APM System Architecture 34
Meridium APM ApplicationServer - Hardware and Software Requirements 38
Aboutthe OperatingSystem in the Meridium APM TestingEnvironment 45
ApplicationServer Role Services 48
Web Server Role Services 50
EnablingWebDAV 53
Settingthe Local DTC Property Settings 54
Aboutthe OperatingSystem in the Meridium APM TestingEnvironment 59
ApplicationServer Role Features 62
Web Server Role Features 63
EnablingWebDAV 67
Settingthe Local DTC Property Settings 68
MicrosoftACEand the ApplicationServer 73
Meridium APM Framework - Hardware and Software Requirements 74
RecommendedScreenResolution 77
Meridium APM Framework Machine - RecommendedUser Permissions 78
Database Server Machine - Hardware and Software Requirements 79
Copyright©2017General Electric Company. All rightsreserved. • Page4of464
TableofContents
OracleRequirements 80
SQL Server Requirements 81
Settingthe Local DTC Property Settings 82
SQL Server ReportServer - Hardware and Software Requirements 87
How the SQL Server ReportServer Workswith Meridium APM 89
Aboutthe SQL Server ReportManager 92
AboutCommunicationMethods 93
Aboutthe Meridium APM Server and Add-OnsInstaller 94
Aboutthe Meridium APM Framework Installer 97
Installingthe ApplicationServer Software 99
InstallingAdditional ApplicationServer ComponentsAfter the Initial Installation 111
InstallingOnly the Meridium APM Framework Application 117
Installingthe Meridium APM Framework and SelectAdministrative Applications127
PerformingaSilentInstallationon APM Framework Machines 139
GrantingWindowsSecurity Permissions 141
InstallingMicrosoftVisual Studio Toolsfor Applications 142
InstallingMicrosoftVisual Studio 2005 Remote Debugger 144
ReportServer Installationand ConfigurationTasks 152
Installingthe Meridium APM Adapter for SSRS 155
ConfiguringPermissionsfor the ReportServer 164
ConfiguringMeridium APM to Use the ReportServer 166
AboutReportDeployment 169
DeployingAll Reportsto the ReportServer 171
Aboutthe Meridium APM Database 175
Database Server Installationand ConfigurationTasks 176
Installingthe Database Upgrade Manager Application 179
InstallingOracle Server Software 180
ConsideringOracle Server GlobalizationSoftware 181
Creatingand Configuringthe Oracle Database 182
AboutCreatingthe Oracle Schema 184
Copyright©2017General Electric Company. All rightsreserved. • Page5of464
TableofContents
Creatingthe Meridium APM Oracle Schema 185
ConsideringSQL Server Localization 187
Installingthe SQL Server Software 188
AboutCreatingand Configuringthe SQL Server Database 189
Creatingthe SQL Server Database 190
Configuringthe SQL Server Database 191
InstallingOracle DataAccessComponents(ODAC) 193
Configuringthe TNS_ADMINEnvironmentVariable 195
ConfiguringAn Oracle NetService Name 200
Updatingor UpgradingApplicationServer Instancesto V3.6.1.6.0 201
AboutUpgradingMeridium APM Framework Machines 220
Updatingor UpgradingMeridium APM Framework Machinesto V3.6.1.6.0 222
Upgradingthe Meridium APM Framework and SelectAdministrative Applic-
ationsFrom V3.4.5 to V3.6.1.6.0 239
Upgradingthe Meridium APM Adapter for SSRS 251
How Can ITell WhatVersionis Currently Installed? 263
MergingConfigurationFilesAfter an Upgrade or an Update 265
AboutAutomatic Upgrades 266
Runningthe ALT_MI_USERScript 267
TermsUsed in thisDocumentation 268
AboutUpgradingYour Database 270
How Customized Database Contentis Protected 273
Protected Database Content 276
How Do IDetermine WhatWill be Replaced and WhatWill be Protected? 281
AboutObtainingBaseline ContentAfter an Upgrade 283
Aboutthe Database Upgrade Manager 285
Accessingthe Database Upgrade Manager 290
Initiatingthe Database Upgrade Process 291
AboutMonitoringthe Database Upgrade Process 299
Aspectsof the Upgrade DetailsGrid 302
Copyright©2017General Electric Company. All rightsreserved. • Page6of464
TableofContents
Pausingthe Database Upgrade Process 304
ResumingaPaused Database Upgrade Process 305
The Final Stage of the Database Upgrade Process 306
AboutReviewingthe Logfor Duplicate Records 307
Reviewingthe Logfor Duplicate Records 308
Sendingthe Database Upgrade Logsto Meridium, Inc. 311
Isee aFailure. Now What? 312
The EventsLog 313
Bootstrap Error 315
Configuringthe ApplicationServer for Oracle Components 316
AboutComparingDatabases 317
Database ComparisonOptions 319
AboutAccessingthe Meridium APM Database ComparisonTool 321
Deployingthe Tool Manually 322
Configuringthe ApplicationServer for aPre-Upgrade Database Comparison 330
Accessingthe Tool Manually 331
Accessingthe Tool From the ConfigurationManager 333
Aboutthe Meridium APM Database ComparisonTool 334
Runningthe ComparisonAgainstaPre-Upgraded Database 337
Runningthe ComparisonAgainstan Upgraded Database 342
Savingthe Resultsto a.ZIP File 346
ReloadingPreviousComparisonResults 348
Aspectsof the ComparisonResultsGrid 351
ViewingDetailed Differencesin WinMerge 355
Example: You Have Modified aBaseline Query 358
Exportingthe Resultsto an Excel File 364
AboutSpecifyingDataSources 366
AddingDataSources 368
TestingaDataSource Connection 371
ModifyingaDataSource 372
Copyright©2017General Electric Company. All rightsreserved. • Page7of464
TableofContents
AboutEnablingScheduled Item Execution 373
SpecifyingaDataSource as the Default 374
RemovingDataSources 375
Aboutthe Meridium APM System AdministrationTool Documentation 376
Accessingthe Meridium APM System AdministrationTool 377
GettingStarted: Meridium APM System AdministrationTool 379
AboutLicense Activation 382
ActivatingLicenses 384
ActivatingLicensed Modulesand Products 387
Overview of the Import/ExportMetadataTool 389
DataTypesAvailable for Importand Export 390
Accessingthe Import/ExportMetadataTool 394
Aspectsof the Import/ExportMetadataWindow 395
ExportingMetadata 398
AboutImportingMetadata 400
Performingthe ImportProcedure 401
MakingSelectionsfor an Export 403
MakingSelectionsfor an Import 404
SelectingChanged Items 405
SelectingSome Itemsto Importor Export 407
ExportingRecordsand Links 410
SavingYour Importor ExportSelections 412
LoadingSaved Importor ExportSelections 413
Aboutthe Excel File 414
Aboutthe XML File 416
AboutActionIndicators 417
Possible Valuesfor ActionIndicators 418
Aboutthe FilesFolder 419
ResettingSelectionson the Import/ExportMetadataWindow 421
Viewingthe Import/ExportLog 422
Copyright©2017General Electric Company. All rightsreserved. • Page8of464
TableofContents
Meridium APM Supported Software and Devices 423
AboutConfigurationFilesand Server Upgrades 440
How Do ApplicationUpdatesWork? 442
AboutUninstallingand RepairingMeridium APM Installations 443
UninstallingAll Meridium APM Componentson an ApplicationServer Machine 444
UninstallingSpecific ComponentsUsingthe ApplicationServer and Add-Ons
Installer 447
RepairingApplicationServer Software and Add-on ComponentInstallations 452
UninstallingAll the Meridium APM Applicationson aFramework Machine 456
UninstallingSpecific ApplicationsUsingthe Meridium APM Framework Installer 459
Meridium APM Licenses 463
Copyright©2017General Electric Company. All rightsreserved. • Page9of464
AbouttheInstallation,Upgrade,andSystemAdministrationDocumentation
About the Installation, Upgrade, and System Admin-
istration Documentation
Thisdocumentationprovidesdetailson performingthetasksthatarerequired for:
Installingand configuringthecomponentsof thebasic Meridium APMsystem
l
architecture, which is required byallMeridium APMcomponents.
Upgradingthecomponentsof thebasic Meridium APMsystem architecturefrom
l
thefollowingversions:
V3.6.0
l
V3.5.1
l
V3.5.0SP1LP
l
V3.5.0
l
V3.4.5
l
Note: Theupgradepathsprovided in thisdocumentationassumethat
you haveoneof thesebaseversionsinstalled. If you haveapplied ahotfix
or patch to your currentversion, upgradingmaycauseyou to losesomeor
all of thechangesthatyou applied throughyour supportrelease. For more
information, consultthehotfix or patch documentationfor your current
version.
Deployingtranslated stringsfor all Meridium APMapplications.
l
Specific instructionsfor installing, upgrading, and configuringindividual modulesand
featuresis located in thedocumentationfor thatmoduleor feature. Becauseyou can
useMeridium with multiplecombinationsof featuresand modulelicensesthatrequire
differentor overlappingconfigurationsand machines, you should read theinstructions
for each moduleor featurethatyou wantto deployin your system and consolidatethe
stepswheretheyoverlap. For your convenience, adirectoryof theadditional com-
ponentsthatyou can deploywith Meridium APMis provided here.
ŗIMPORTANT: All thedocumentationin theroot-level Installation, Upgrade, and Sys-
tem Administrationsectionof thehelp system assumesthatyou arelogged in as a
WindowsUser with anAdministratoraccountto themachinewhereyou will perform
each step.
TheInstallation, Upgrade, and System Administrationdocumentationprovidesdetails
on thefollowingspecific items:
Hardware and Software (HW and SW) requirementsfor the Meridium APM
l
installers. Thisdocumentationdoesnotprovidealistof HW and SW requirements
for individual modulesor features. Instead, therequirementsfor an individual
modulesand featuresarelocated in thedocumentationfor thatmoduleor fea-
ture. Thisdocumentationdoes, however, provideadirectoryof theadditional
Meridium APMcomponentswith alink to thesystem requirementsfor that
Copyright©2017General Electric Company. All rightsreserved. • Page10of464