HP Application Lifecycle Management Installation and Upgrade Guide - Windows

214 Pages·2016·1.26 MB·English

HP ALM
SoftwareVersion:12.53
Installation and Upgrade Guide - Windows
DocumentReleaseDate:May2016|SoftwareReleaseDate:May2016
Legal Notices
Warranty
TheonlywarrantiesforHewlettPackardEnterpriseDevelopmentLPproductsandservicesaresetforthintheexpress
warrantystatementsaccompanyingsuchproductsandservices.Nothinghereinshouldbeconstruedasconstitutingan
additionalwarranty.HPshallnotbeliablefortechnicaloreditorialerrorsoromissionscontainedherein.
Theinformationcontainedhereinissubjecttochangewithoutnotice.
RestrictedRightsLegend
Confidentialcomputersoftware.ValidlicensefromHPrequiredforpossession,useorcopying.ConsistentwithFAR12.211
and12.212,CommercialComputerSoftware,ComputerSoftwareDocumentation,andTechnicalDataforCommercialItemsare
licensedtotheU.S.Governmentundervendor'sstandardcommerciallicense.
CopyrightNotice
©Copyright2002-2016HewlettPackardEnterpriseDevelopmentLP
TrademarkNotices
Adobe™isatrademarkofAdobeSystemsIncorporated.
Microsoft®andWindows®areU.S.registeredtrademarksofMicrosoftCorporation.
UNIX®isaregisteredtrademarkofTheOpenGroup.
OracleandJavaareregisteredtrademarksofOracleand/oritsaffiliates.
Documentation Updates
Thetitlepageofthisdocumentcontainsthefollowingidentifyinginformation:
l SoftwareVersionnumber,whichindicatesthesoftwareversion.
l DocumentReleaseDate,whichchangeseachtimethedocumentisupdated.
l SoftwareReleaseDate,whichindicatesthereleasedateofthisversionofthesoftware.
Tocheckforrecentupdatesortoverifythatyouareusingthemostrecenteditionofadocument,goto:
https://softwaresupport.hpe.com.
ThissiterequiresthatyouregisterforanHPEPassportandsignin.ToregisterforanHPEPassportID,goto
https://softwaresupport.hpe.comandclickRegister.
Support
VisittheHPESoftwareSupportOnlinewebsiteat:https://softwaresupport.hpe.com
Thiswebsiteprovidescontactinformationanddetailsabouttheproducts,services,andsupportthatHPESoftwareoffers.
HPESoftwareonlinesupportprovidescustomerself-solvecapabilities.Itprovidesafastandefficientwaytoaccess
interactivetechnicalsupporttoolsneededtomanageyourbusiness.Asavaluedsupportcustomer,youcanbenefitbyusing
thesupportwebsiteto:
HPALM(12.53) Page2of214
InstallationandUpgradeGuide-Windows
l Searchforknowledgedocumentsofinterest
l Submitandtracksupportcasesandenhancementrequests
l Downloadsoftwarepatches
l Managesupportcontracts
l LookupHPEsupportcontacts
l Reviewinformationaboutavailableservices
l Enterintodiscussionswithothersoftwarecustomers
l Researchandregisterforsoftwaretraining
MostofthesupportareasrequirethatyouregisterasanHPEPassportuserandsignin.Manyalsorequireasupport
contract.ToregisterforanHPEPassportID,goto:https://softwaresupport.hpe.comandclickRegister.
Tofindmoreinformationaboutaccesslevels,goto:https://softwaresupport.hpe.com/web/softwaresupport/access-levels.
HPESoftwareSolutions& IntegrationsandBestPractices
VisitHPESoftwareSolutionsNowathttps://softwaresupport.hpe.com/group/softwaresupport/search-result/-
/facetsearch/document/KM01702710toexplorehowtheproductsintheHPE Softwarecatalogworktogether,exchange
information,andsolvebusinessneeds.
VisittheCrossPortfolioBestPracticesLibraryathttps://hpln.hpe.com/group/best-practices-hpswtoaccessawidevariety
ofbestpracticedocumentsandmaterials.
HPALM(12.53) Page3of214
InstallationandUpgradeGuide-Windows
Contents
WelcometothisGuide 9
Part1:InstallationOverview 11
Chapter1:AboutALMTechnologyandArchitecture 13
UnderstandingtheALMComponents 14
ExampleofBasicALMConfiguration 15
ExampleofClusteredALMConfiguration 16
Chapter2:HowtoInstallandUpgrade 19
Chapter3:CommonInstallationScenarios 21
NewALMInstallation 22
UpgradeALMwithNewSchema 23
UpgradeALMwithCopiedSchema 24
UpgradeALMwithSameServer 25
UpgradeALMwithSameDatabaseServer 26
Part2:PatchInstallation 29
Chapter4:InstallingALMPatches 31
Pre-InstallationChecksandConsiderations 32
SystemRequirements 33
RequiredPermissions 33
ClusteringConfiguration 34
InstallingthePatch 34
UninstallingthePatch 36
Part3:InstallationPrerequisites 37
Chapter5:Pre-InstallationChecklist 39
Chapter6:Prerequisites:WindowsOperatingSystems 43
SystemConfigurations:Windows 44
RequiredPermissions:Windows 44
Clustering:Windows 45
ALMRepositoryPath:Windows 46
Chapter7:Prerequisites:OracleDatabaseServers 47
ConnectingALMtoanOracleDatabaseServer 48
UserPermissionsforConnectingALMtoanOracleDatabaseServer 50
DatabaseAdministrativeUserPrivileges 50
ProjectUserPrivileges 52
SiteAdministrationDatabaseSchemaConsiderations: Oracle 53
OracleRACSupport 54
HPALM(12.53) Page4of214
InstallationandUpgradeGuide-Windows
Chapter8:Prerequisites:MicrosoftSQLDatabaseServers 57
ConnectingALMtoaMicrosoftSQLDatabaseServer 58
UserPermissionsforConnectingALMtoaMicrosoftSQLDatabaseServer 59
SiteAdministrationDatabaseSchemaConsiderations:SQL 61
Chapter9:Prerequisites:General 63
LicenseFile 64
SecurityPassphrases 64
MailServerInformation 64
ConflictingApplications 64
Chapter10:Prerequisites:Client-side 65
SystemConfigurations 66
RequiredSoftware 67
AdditionalConsiderations 67
PermissionsRequiredtoDownloadALMClientComponents 67
InternetExplorerConfiguration 68
EnablingUserAccountControl(UAC) 69
Part4:Pre-InstallationProjectUpgradeSteps 71
Chapter11:ProjectUpgradeConsiderations 73
UpgradeVersions 74
SuggestedALMSystemConfiguration 75
AdditionalProjectUpgradeDocumentation 76
Chapter12:ProjectUpgradePre-InstallationActivities 77
BackUpProjectsinExistingALMInstallation 78
VerifyingDomainsandProjects 78
VerificationProcessOverview 80
DefineanExceptionFile 80
VerifyaProject 81
VerifyaDomain 83
RepairingDomainsandProjects 84
RepairingaProject 84
RepairingaDomain 86
RestoringBackedUpProjectsandRepositories 87
RestoringProjectsfromaMicrosoftSQLDatabaseServer 87
RestoringProjectsfromanOracleDatabaseServer 88
RestoringaRepositoryfromtheFileSystem 88
RestoringLAB_PROJECT 89
VerifyProjectsAgain 89
CopySiteAdministrationDatabaseSchematotheNewDatabaseServer 89
Chapter13:UpgradingtheSiteAdministrationDatabaseSchema 91
SchemaUpgradeGuidelines 92
HPALM(12.53) Page5of214
InstallationandUpgradeGuide-Windows
RecoveringaLostConfidential DataPassphrase 93
ManagingSchemaChanges 94
Part5:ALM InstallationandConfiguration 97
Chapter14:InstallingALMonMicrosoftWindowsSystems 99
InstallingALM:Windows 100
InstallingALMinSilentMode:Windows 114
ConfiguretheIISMailService 115
Chapter15:LAB_PROJECTInstallationConsiderations 117
Chapter16:StartingALM 119
BrowsingtheALMProgramFolder 120
StartingandStoppingALMServices 120
StartingALMonaClientMachine 120
RegisteringALMonaClientMachine 123
Chapter17:IntegratingtheALMApplicationServerwithaWebServer 125
ConfiguringIIS asareverseproxy 125
ConfiguringIIS asaSecureReverseProxy 127
ConfiguringtheIISWebServerforSSL Offloading 128
ConfiguringApacheasareverseproxy 128
ConfiguringApacheasaSecureReverseProxy 130
ConfiguringtheApacheWebServerforSSL Offloading 131
Chapter18:ManagingtheALMApplicationServer 133
ChangingtheHeapMemorySize 134
ChangingtheApplicationServerPortNumber 134
ConfiguringSecureAccessonWindowsSystems 135
ConfiguretrustontheALMserver 135
ConfigureasecureconnectiontotheALMapplicationserver(Jetty) 135
UseTLS1.2insteadTLS1.1,TLS1.0orSSLv3 138
Redirecthttptohttps 139
Setupencryptedcommunicationwithcookies 139
ConfiguringSecureDatabaseAccess 139
ApplicationServerManagementTools 144
Chapter19:CustomizingSystemFiles 145
CustomizingSiteAdministration 146
CustomizingtheSiteAdministrationRepository 147
CustomizingtheqcbinApplication 147
CustomizingMenus 147
UnderstandingtheALMSystemTrayIcon 149
Chapter20:UninstallingALM 151
UninstallingALMfromWindowsSystems 152
RemovingALMClientComponentsfromaClientMachine 152
HPALM(12.53) Page6of214
InstallationandUpgradeGuide-Windows
Part6:ProjectUpgrade 153
Chapter21:UpgradingProjects 155
DeactivateandRemoveProjectsfromExistingALM/QualityCenterInstallation 156
CopyProjectDatabaseSchemastotheNewDatabaseServerMachine 156
RestoreALMProjectsinNewSiteAdministrationDatabaseSchema 157
UpgradeProjects 159
AboutUpgradingDomainsandProjects 160
UpgradingaProject 161
UpgradingaDomain 162
Chapter22:MigratingtheProjectRepository 165
AbouttheRepositoryMigration 166
RepositoryMigrationStatusWindow 167
ConfigureMigrationPriority 169
Chapter23:PerformanceCenter/LAB_PROJECTPost-UpgradeSteps 171
Part7:Appendix 173
AppendixA:TroubleshootingtheALMInstallation 175
DisablingValidationChecksfortheInstallationWizard 176
CheckingtheInstallationandConfigurationLogFiles 180
ALMInstallationAlreadyExists 181
DatabaseValidatorFails 181
MonitoringALMServerFails 182
AppendixB:UpgradePreparationTroubleshooting 183
Overview 184
QuickWarningReference 184
GeneralIssues 185
SchemaIssues 186
DataIssues 187
GeneralValidation 188
SupportedDatabaseVersion 189
ValidDatabaseUserSchemaName 189
MixedTableOwnership 189
RepositoryoverDatabaseFeature 190
VersionControlValidation 190
DatabasePermissions 190
TextSearchConfiguration 191
SchemaValidation 192
Tables 194
Columns 195
IndexesandConstraints 197
Triggers 200
HPALM(12.53) Page7of214
InstallationandUpgradeGuide-Windows
Sequences 200
InternalQualityCenterChanges 201
DataValidation 204
DuplicateValues 205
DuplicateIDs 205
TreeInconsistencies 206
Views 206
OrphanedEntities 207
MissingEntities 207
MissingListsand/orListValues 208
EncryptedValues 208
ChangingtheDatabaseUserSchema 209
MissingDatabaseObjects 210
MissingListWarning 210
SequencesWarning 210
ChangedDatabaseObjects 210
ExtraDatabaseObjects 211
SendUsFeedback 213
HPALM(12.53) Page8of214
InstallationandUpgradeGuide-Windows
Welcome to this Guide
WelcometoHPApplicationLifecycleManagement(ALM).ALMempowersorganizationsto
managethecoreapplicationlifecycle,fromrequirementsthroughdeployment,granting
applicationteamsthecrucialvisibilityandcollaborationneededforpredictable,repeatable,and
adaptabledeliveryofmodernapplications.
Thishelpcontainsthefollowinginformation:
Step-by-stepinstructionsforinstallingandconfiguringALM12.53.
l
Step-by-stepinstructionsforupgradingprojectsfromearlierversionsofALM/QualityCenter
l
toworkinALM12.53.
GenericinstructionsforinstallingonALM12.53.
l
Note:ToconfigureALMtoworkwithexternalauthentication,refertotheHP Application
LifecycleManagementExternalAuthenticationConfigurationGuide.
HPALM(12.53) Page9of214
InstallationandUpgradeGuide-Windows
HPALM(12.53) Page10of214