HP Application Lifecycle Management Installation and Upgrade Guide - Windows

208 Pages·2015·1.41 MB·English

HP ALM
Software Version:12.50
Installation and Upgrade Guide - Windows
DocumentReleaseDate:December2015
SoftwareReleaseDate:December2015
InstallationandUpgradeGuide-Windows
Legal Notices
Warranty
TheonlywarrantiesforHPproductsandservicesaresetforthintheexpresswarrantystatementsaccompanyingsuch
productsandservices.Nothinghereinshouldbeconstruedasconstitutinganadditionalwarranty.HPshallnotbeliable
fortechnicaloreditorialerrorsoromissionscontainedherein.
Theinformationcontainedhereinissubjecttochangewithoutnotice.
Restricted RightsLegend
Confidentialcomputersoftware.ValidlicensefromHPrequiredforpossession,useorcopying.ConsistentwithFAR
12.211and12.212,CommercialComputerSoftware,ComputerSoftwareDocumentation,andTechnicalDatafor
CommercialItemsarelicensedtotheU.S.Governmentundervendor'sstandardcommerciallicense.
Copyright Notice
©Copyright2002-2014Hewlett-PackardDevelopmentCompany,L.P.
TrademarkNotices
Adobe™isatrademarkofAdobeSystemsIncorporated.
Microsoft®andWindows®areU.S.registeredtrademarksofMicrosoftCorporation.
UNIX®isaregisteredtrademarkofTheOpenGroup.
Thisproductincludesaninterfaceofthe'zlib'generalpurposecompressionlibrary,whichisCopyright©1995-2002
Jean-loupGaillyandMarkAdler.
Documentation Updates
Thetitlepageofthisdocumentcontainsthefollowingidentifyinginformation:
SoftwareVersionnumber,whichindicatesthesoftwareversion.
l
DocumentReleaseDate,whichchangeseachtimethedocumentisupdated.
l
SoftwareReleaseDate,whichindicatesthereleasedateofthisversionofthesoftware.
l
Tocheckforrecentupdatesortoverifythatyouareusingthemostrecenteditionofadocument,goto:
https://softwaresupport.hp.com.
ThissiterequiresthatyouregisterforanHPPassportandsignin.ToregisterforanHPPassportID,goto
https://softwaresupport.hp.comandclickRegister.
Support
VisittheHPSoftwareSupportOnlinewebsiteat:https://softwaresupport.hp.com
Thiswebsiteprovidescontactinformationanddetailsabouttheproducts,services,andsupportthatHPSoftware
offers.
HPALM(12.50) Page2
InstallationandUpgradeGuide-Windows
HPSoftwareonlinesupportprovidescustomerself-solvecapabilities.Itprovidesafastandefficientwaytoaccess
interactivetechnicalsupporttoolsneededtomanageyourbusiness.Asavaluedsupportcustomer,youcanbenefitby
usingthesupportwebsiteto:
Searchforknowledgedocumentsofinterest
l
Submitandtracksupportcasesandenhancementrequests
l
Downloadsoftwarepatches
l
Managesupportcontracts
l
LookupHPsupportcontacts
l
Reviewinformationaboutavailableservices
l
Enterintodiscussionswithothersoftwarecustomers
l
Researchandregisterforsoftwaretraining
l
MostofthesupportareasrequirethatyouregisterasanHPPassportuserandsignin.Manyalsorequireasupport
contract.ToregisterforanHPPassportID,goto:https://softwaresupport.hp.comandclickRegister.
Tofindmoreinformationaboutaccesslevels,goto:https://softwaresupport.hp.com/web/softwaresupport/access-
levels.
HP Software Solutions& Integrationsand Best Practices
VisitHPSoftwareSolutionsNowathttps://h20230.www2.hp.com/sc/solutions/index.jsptoexplorehowtheproducts
intheHPSoftwarecatalogworktogether,exchangeinformation,andsolvebusinessneeds.
VisittheCrossPortfolioBestPracticesLibraryathttps://hpln.hp.com/group/best-practices-hpswtoaccessawide
varietyofbestpracticedocumentsandmaterials.
HPALM(12.50) Page3
InstallationandUpgradeGuide-Windows
Contents
Welcome tothisGuide 9
Part 1:InstallationOverview 11
Chapter1:AboutALMTechnologyandArchitecture 13
UnderstandingtheALMComponents 14
ExampleofBasicALMConfiguration 15
ExampleofClusteredALMConfiguration 16
Chapter2:HowtoInstallandUpgrade 19
Chapter3:CommonInstallationScenarios 21
NewALMInstallation 22
UpgradeALMwithNewSchema 22
UpgradeALMwithCopiedSchema 23
UpgradeALMwithSameServer 24
UpgradeALMwithSameDatabaseServer 25
Part 2:PatchInstallation 27
Chapter4:InstallingALMPatches 29
Pre-InstallationChecksandConsiderations 30
SystemRequirements 31
RequiredPermissions 31
ClusteringConfiguration 32
InstallingthePatch 32
UninstallingthePatch 34
Part 3:InstallationPrerequisites 35
Chapter5:Pre-InstallationChecklist 37
Chapter6:Prerequisites:WindowsOperatingSystems 39
SystemConfigurations:Windows 40
RequiredPermissions:Windows 40
Clustering:Windows 41
ALMRepositoryPath:Windows 42
Chapter7:Prerequisites:OracleDatabaseServers 43
ConnectingALMtoanOracleDatabaseServer 44
UserPermissionsforConnectingALMtoanOracleDatabaseServer 46
DatabaseAdministrativeUserPrivileges 46
ProjectUserPrivileges 48
SiteAdministrationDatabaseSchemaConsiderations: Oracle 49
HPALM(12.50) Page4
InstallationandUpgradeGuide-Windows
OracleRACSupport 49
Chapter8:Prerequisites:MicrosoftSQLDatabaseServers 51
ConnectingALMtoaMicrosoftSQLDatabaseServer 52
UserPermissionsforConnectingALMtoaMicrosoftSQLDatabaseServer 53
SiteAdministrationDatabaseSchemaConsiderations:SQL 54
Chapter9:Prerequisites:General 57
LicenseFile 58
SecurityPassphrases 58
MailServerInformation 58
ConflictingApplications 58
Chapter10:Prerequisites:Client-side 59
SystemConfigurations 60
RequiredSoftware 61
AdditionalConsiderations 61
PermissionsRequiredtoDownloadALMClientComponents 61
InternetExplorerConfiguration 62
EnablingUserAccountControl(UAC) 63
Part 4:Pre-InstallationProject Upgrade Steps 65
Chapter11:ProjectUpgradeConsiderations 67
UpgradeVersions 68
SuggestedALMSystemConfiguration 69
AdditionalProjectUpgradeDocumentation 70
Chapter12:ProjectUpgradePre-InstallationActivities 71
BackUpProjectsinExistingALMInstallation 72
VerifyingDomainsandProjects 73
VerificationProcessOverview 74
DefineanExceptionFile 74
VerifyaProject 76
VerifyaDomain 77
RepairingDomainsandProjects 78
RepairingaProject 79
RepairingaDomain 80
RestoringBackedUpProjectsandRepositories 81
RestoringProjectsfromaMicrosoftSQLDatabaseServer 82
RestoringProjectsfromanOracleDatabaseServer 82
RestoringaRepositoryfromtheFileSystem 83
RestoringLAB_PROJECT 83
VerifyProjectsAgain 83
CopySiteAdministrationDatabaseSchematotheNewDatabaseServer 84
Chapter13:UpgradingtheSiteAdministrationDatabaseSchema 85
HPALM(12.50) Page5
InstallationandUpgradeGuide-Windows
SchemaUpgradeGuidelines 86
RecoveringaLostConfidential DataPassphrase 86
ManagingSchemaChanges 87
Part 5:ALM InstallationandConfiguration 91
Chapter14:InstallingALMonMicrosoftWindowsSystems 93
InstallingALM:Windows 94
InstallingALMinSilentMode:Windows 108
ConfiguretheIISMailService 109
Chapter15:LAB_PROJECTInstallationConsiderations 111
Chapter16:StartingALM 113
BrowsingtheALMProgramFolder 114
StartingandStoppingALMServices 114
StartingALMonaClientMachine 114
RegisteringALMonaClientMachine 117
Chapter17:IntegratingtheALMApplicationServerwithaWebServer 119
ConfiguringIIS asareverseproxy 119
ConfiguringIIS asaSecureReverseProxy 121
ConfiguringtheIISWebServerforSSL Offloading 122
ConfiguringApacheasareverseproxy 122
ConfiguringApacheasaSecureReverseProxy 124
ConfiguringtheApacheWebServerforSSL Offloading 126
Chapter18:ManagingtheALMApplicationServer 127
ChangingtheHeapMemorySize 128
ChangingtheApplicationServerPortNumber 128
ConfiguringSecureAccessonWindowsSystems 129
ConfiguringSecureDatabaseAccess 132
ApplicationServerManagementTools 137
Chapter19:CustomizingSystemFiles 139
CustomizingSiteAdministration 140
CustomizingtheSiteAdministrationRepository 141
CustomizingtheqcbinApplication 141
CustomizingMenus 141
UnderstandingtheALMSystemTrayIcon 144
Chapter20:UninstallingALM 145
UninstallingALMfromWindowsSystems 146
RemovingALMClientComponentsfromaClientMachine 146
Part 6:Project Upgrade 147
Chapter21:UpgradingProjects 149
DeactivateandRemoveProjectsfromExistingALM/QualityCenterInstallation 150
HPALM(12.50) Page6
InstallationandUpgradeGuide-Windows
CopyProjectDatabaseSchemastotheNewDatabaseServerMachine 150
RestoreALMProjectsinNewSiteAdministrationDatabaseSchema 151
UpgradeProjects 153
AboutUpgradingDomainsandProjects 154
UpgradingaProject 155
UpgradingaDomain 156
Chapter22:MigratingtheProjectRepository 159
AbouttheRepositoryMigration 160
RepositoryMigrationStatusWindow 161
ConfigureMigrationPriority 162
Chapter23:PerformanceCenter/LAB_PROJECTPost-UpgradeSteps 165
Part 7:Appendix 167
AppendixA:TroubleshootingtheALMInstallation 169
DisablingValidationChecksfortheInstallationWizard 170
CheckingtheInstallationandConfigurationLogFiles 174
ALMInstallationAlreadyExists 174
DatabaseValidatorFails 174
MonitoringALMServerFails 175
AppendixB:UpgradePreparationTroubleshooting 177
Overview 178
QuickWarningReference 178
GeneralIssues 179
SchemaIssues 179
DataIssues 181
GeneralValidation 181
SupportedDatabaseVersion 182
ValidDatabaseUserSchemaName 182
MixedTableOwnership 182
RepositoryoverDatabaseFeature 183
VersionControlValidation 183
DatabasePermissions 183
TextSearchConfiguration 184
SchemaValidation 185
Tables 187
Columns 188
IndexesandConstraints 190
Triggers 193
Sequences 193
InternalQualityCenterChanges 194
DataValidation 196
HPALM(12.50) Page7
InstallationandUpgradeGuide-Windows
DuplicateValues 197
DuplicateIDs 197
TreeInconsistencies 198
Views 199
OrphanedEntities 199
MissingEntities 200
MissingListsand/orListValues 200
EncryptedValues 200
ChangingtheDatabaseUserSchema 202
MissingDatabaseObjects 203
MissingListWarning 203
SequencesWarning 203
ChangedDatabaseObjects 203
ExtraDatabaseObjects 204
SendUsFeedback 207
HPALM(12.50) Page8
InstallationandUpgradeGuide-Windows
Welcome to this Guide
WelcometoHPApplicationLifecycleManagement(ALM).ALMempowersorganizationstomanagethe
coreapplicationlifecycle,fromrequirementsthroughdeployment,grantingapplicationteamsthe
crucialvisibilityandcollaborationneededforpredictable,repeatable,andadaptabledeliveryofmodern
applications.
Thishelpcontainsthefollowinginformation:
Step-by-stepinstructionsforinstallingandconfiguringALM12.50.
l
Step-by-stepinstructionsforupgradingprojectsfromearlierversionsofALM/QualityCentertowork
l
inALM12.50.
GenericinstructionsforinstallingonALM12.50.
l
Note: ToconfigureALMtoworkwithexternalauthentication,refertotheHP Application
LifecycleManagementExternalAuthenticationConfigurationGuide.
HPALM(12.50) Page9
InstallationandUpgradeGuide-Windows
HPALM(12.50) Page10