AccuRevGitCentric403forbidden

Revised11/20/15GitCentricInstallationandReleaseNotesVersion2015.
2CopyrightMicroFocus2015.
Allrightsreserved.
Thisproductincorporatestechnologythatmaybecoveredbyoneormoreofthefollowingpatents:U.
S.
PatentNumbers:7,437,722;7,614,038;8,341,590;8,473,893;8,548,967.
AccuRev,AgileCycle,andTimeSafeareregisteredtrademarksofAccuRev,Inc.
AccuBridge,AccuReplica,AccuSync,AccuWork,AccuWorkflow,Kando,andStreamBrowseraretrademarksofAccuRev,Inc.
Allothertradenames,trademarks,andservicemarksusedinthisdocumentarethepropertyoftheirrespectiveowners.
Revised11/20/15Introduction1HighlightsofthisRelease1GitCentricMulti-ThreadedBridge2PerformanceImpactSingleOperation2PerformanceImpactMulti-threadedoperations2Limitation:OperationswithinaRepoareStillSerialized2Configuration2HowtoInstallthekandoBridge.
warFile3GitCentricInstallationNotes5IntroducingGitCentric2015.
25PreparingforInstallation5RequiredSoftware5GenericNamesUsedDuringInstallation6SummaryofSteps7AboutUninstallingGitCentric7AboutMovingGitCentrictoaNewMachine7LinuxInstallation8ExistingLinuxServers8ToInstallLinux8AccuRevInstallation9GitCentricInstallation11InitialGitCentricLogIn12SSHKeyGeneration12LogInandSelf-Register12RegisterwithGitCentric14InstalltheAccuRevTrigger15Enabling/DisablingCodeReview16TesttheGitCentricInstallation16TesttheGitCentricBridgeConnection16ProceedtotheGUI17DisplayingtheUser'sHelp17Troubleshooting17IfYouCannotLogIn17General:TestingtheInstallation18General:TheTomcatLogs18General:Servers18General:Settings19LD_LIBRARY_PATH:psqlsharedlibraryerror19ASSIGN_USER_PRIVILEGEandCC_USER19DebugSettings20UninstallingGitCentric20RunningtheuninstallCommand20GitCentricReleaseNotes21UnderstandingIssueNumbers21ChangesinRelease2015.
221ChangesinRelease2015.
121ChangesinRelease2014.
124KnownIssues26GerritIssues28GitCentricInstallationandReleaseNotes1IntroductionAccuRevGitCentricprovidestheflexibilityofGitandthesecurityofAccuRev.
HighlightsofthisReleaseAccuRevGitCentricRelease2015.
2providesnewfeaturesandenhancements,anditaddressesissuesreportedinpreviousGitCentricreleases.
HighlightsofGitCentricRelease2015.
2include:GitCentricMulti-ThreadedBridge.
GitCentric2015.
2allowsthesynchronizationtasksinsidetheGitCentricBridgetobeMulti-Threaded.
Previously,thosesyncoperationswereserialized.
Customershadexperiencedpushoperationstakingalongtime-insomecaseasmuchas10minuteswhichwouldcausethepushtotimeoutandfail.
Thisfixwilleliminatethatproblemandgenerallyimproveperformanceonabusybridge.
IncreasekandoBridgelogfilesize.
Topreventsyncerrors,thekandoBridgelogfilesizehasbeenincreased.
Reducenoiseinlogs.
Changedsomelogsfromleveldebugtoleveltracetoreducenoiseinthelogs.
BetterloggingofAccuRevcommands.
ImprovedtheloggingofAccuRevcommandstiming.
AccuRevGitCentricRelease2015.
1providesnewfeaturesandenhancements,anditaddressesissuesreportedinpreviousGitCentricreleases.
HighlightsofGitCentricRelease2015.
1include:NewSSHcommandtodeleterepositories.
GitCentric2015.
1supportsdeletingrepositoriesusinganewSSHcommand,gitcentricdelete-repo.
SeeAppendixC.
Command-LineReferenceintheGitCentricUser'sHelpformoreinformation.
Newbackupandrestorecommands.
GitCentric2015.
1introducestwonewcommandsforbackupandrestoreoperations,full_backup.
shandfull_restore.
sh.
ThesecommandsprovidebroaderfunctionalitythanthecurrentbackupdbsandrestoredbscommandsandmakeiteasiertomigrateanexistingGitCentricinstallationtoanewserver.
SeeAppendixB.
BackupandRestoreintheGitCentricUser'sHelpformoreinformation.
SupportforGitCentricandAccuRevServersondifferenthosts.
Inpreviousreleases,specifyinganyvalueotherthanlocalhostfortheGitCentricbridgehostnameingerrit.
configpreventedyoufromhostingGitCentricandAccuRevserversondifferentmachines.
Thisproblemhasbeencorrectedinthecurrentrelease,andyoucannowspecifythemachinenameorIPaddressoftheGitCentricbridgehost.
Fordetailsaboutthisrelease,includingacomprehensivelistofchangesfrompreviousGitCentricreleases,seeGitCentricReleaseNotesonpage21.
ToinstallGitCentric,seeGitCentricInstallationNotesonpage5.
GitCentricInstallationandReleaseNotes2GitCentricMulti-ThreadedBridgePerformanceImpactSingleOperationSyncoperationsaretimedone-at-a-timewiththeoldsingle-threadedbridgeandthenewmulti-threadedbridge.
Thetimingswerewithinonesecondwiththetwodifferentbridges.
PerformanceImpactMulti-threadedoperationsTheframeworkwastestedwithfivethreadssimultaneouslycausingsyncoperationsandtimedthosesyncoperations.
Withthemulti-threadedbridgethesyncoperationswere50%slowerthanone-at-a-timeoperations.
Expectsomeslowdownbecausethebridge,AccuRevserver,andGerritserverwillbebusier.
Withthesingle-threadedbridgethefivethreadtestsyncoperationswereaboutthreetimesslowerthanone-at-a-timesyncoperations.
TheywerenotfivetimesslowerbecausesomeoftheactivityintheGerritserverandtheAccuRevserverisalreadymulti-threaded.
Themainrealizedobjectiveisthatpushoperationsnotbeblockedforthedurationofalongrunningoperation.
Limitation:OperationswithinaRepoareStillSerializedSynchronizationsareruninparallelnowexceptforsynchronizationsonthesamerepository.
Toavoidraceconditionsthatarerepositoryspecificdatastructures,thoseoperationsareserialized.
Thismeansthatifalongrunningoperationstartononebranchofarepository(forexample,andinitialsynchronizationwithastreamthathas20,000files)andapushoccursonasecondmappedbranchinthatsamerepository,thatpushwillstillblockuntilthelongrunningoperationcompletes.
ConfigurationToachievebestperformancefromGitCentric,correctconfigurationisnecessary.
Forthistest,modifythe/site/etc/gerrit.
configfile'ssshdsectionasfollows:[sshd]listenAddress=*:29418threads=48batchThreads=2streamThreads=50maxAuthTries=12IncreasingthenumberofthreadsmightfurtherimproveGitCentricperformance,iftheserverhassufficientcores.
Usethiswebpageasaguide:https://git.
help.
collab.
net/entries/24136638-sshd-settings-in-Gerrit-configuration.
Wealsomodifiedthetomcatenvironmentscriptin/WebUI/tomcat/bin/setenv.
shscripttothefollowing:exportCATALINA_OPTS="$CATALINA_OPTS-server-Xms256m-Xmx1024m"Notethat-Xmx1024mmeansmaximumheapsize1024Meg.
Givenavailablememory,alargerheapwillfurtherimproveperformance.
GitCentricInstallationandReleaseNotes3HowtoInstallthekandoBridge.
warFileToinstallthiskandoBridge.
warfileoveryourexistingGitCentric2015.
1installation,usethefollowingsteps.
1.
Shutdownthetomcatserver.
Use/WebUI/tomcat/bin/shutdown.
sh.
Sometimesitmayalsobenecessarytouseunix"kill"tostopthetomcatprocess.
2.
Renameyourcurrent/bin/kandoBridge.
wartokandoBridge.
old.
war.
3.
CopytheprovidedkandoBridge.
warto/bin/kandoBridge.
war.
4.
Restarttomcatserver.
Use/WebUI/tomcat/bin/startup.
sh.
GitCentricInstallationandReleaseNotes4GitCentricInstallationandReleaseNotes5GitCentricInstallationNotesIntroducingGitCentric2015.
2ThischapterdescribeshowtoinstallorupgradeGitCentricsoftwareatyoursite.
ItalsodescribestheprocessformigratinganexistingGitCentricinstallationtoanewmachine.
GitCentricRelease2015.
2isintendedfornewcustomersandcustomerscurrentlyusingapreviousGitCentricrelease.
ForahighlevelsummaryofnewfeaturesinRelease2015.
2,seeHighlightsofthisReleaseonpage1.
Foradetailedlistofknownissues,seeGitCentricReleaseNotesonpage21.
Note:IfyouareupgradingfromKando2012.
1,contactCustomerCareathttp://supportline.
microfocus.
com/.
PreparingforInstallationThissectiondescribesrequirementsforasuccessfulupgradeorinstallation.
RequiredSoftwareGitCentricrequiresthefollowingsoftwareforasuccessfulinstallation.
Note:Othercomponentsmayhavetheirownprerequisites.
Table1.
PrerequisitesandPlatformSupportComponentSupportedConfigurationOperatingSystemForGitCentricserver:Linux2.
6orlaterSUSE10SP2orlaterCompatibleUbuntuversionsare10.
10andlater,RedHat6.
2andlater.
Otherversionscanbesupported,buttheyhavenotbeencertified.
Webbrowserscanberunfromanyplatform.
BrowsersGitCentricissupportedonthesebrowsers:Chrome(latest)Firefox(latest)MicrosoftInternetExplorer9andlaterJavaJava1.
6orlater.
(TheAccuRevinstallationinstallsJavaat/jre.
Youmayneedtoupdateyour$PATHtopointtothis.
)AccuRevVersion5.
6orlater.
(NotethatAccuRevinstallationshavetheirownprerequisitessuchasPerlforrunningtriggers.
)6GitCentricInstallationandReleaseNotesGenericNamesUsedDuringInstallationThesetupprocessinvolvesanumberofconfigurableelements.
Forsimplicityandclarity,theinstructionsconsistentlyuseasetofgenericnames,usingthisfont.
Tip:UsetheNameatYourSitecolumninthefollowingtabletorecordthenamesyouplantouse.
Table2.
GenericnamesusedduringinstallationGenericNameNameatYourSiteDescriptionLinuxadminOSaccountforinstallingAccuRev,GitCentric,etc.
IfyouhaveanexistingAccuRevserveronLinux,thisshouldbetheaccountyouusedtoinstallit,suchas"acserver".
Ifyouarestartingfromscratch,youcancreateanewonesuchas"gcadmin".
ThisistheAccuRev"serviceaccount"(typically"gcSyncUser")thatGitCentricusestoautomaticallykeepGitandAccuRevinsync.
Thisisamemberofthe"scm_bridge_group"group,whichissettobethevalueof"ASSIGN_USER_PRIVILEGE"intheacserver.
cnfconfigurationfileoneachAccuRevservercontrolledbyGitCentric.
Foranysinglemappedrepository,thereisanAccuRevuserwhoistheserviceaccount.
Note:TheshouldNOTbeamemberofanAccuRevadministratorgroup.
LocationwhereGitCentricisinstalled.
Thisistypically:(Linux)~/AccuRevGitCentricLocationwhereAccuRevisinstalled.
ForGitCentric,thisistypically:(Linux)~/accurev(butsometimes/opt/accurevorelsewhere)Note:IfyouareusingAccuRevinareplicationenvironment,thisisthelocationoftheAccuRevmasterserver.
LocationwheretheTomcatwebserverisinstalled.
ForGitCentric,thisistypically:(Linux)/WebUI/tomcatPortnumberthatthedatabaseserverrunson.
Defaultsto5075.
Nameofthedatabasesuperuser.
Defaultstopostgres.
Passwordfor.
GitCentricInstallationandReleaseNotes7SummaryofStepsTheproceduresinthischaptercoverthedetailsforperformingthefollowingsteps:1.
InstallLinux,ifnecessary.
TheGitCentricserverneedstorunonaLinuxhost.
SeeLinuxInstallationonpage8.
2.
Create(oridentify)aOSadministrativeuser,andlogintothisaccounttoperformtherestoftheinstallation.
Youwillalsocontinuetousethisaccounttostartandstopservers.
SeeLinuxInstallationonpage8.
ThisusershouldalsohaveacorrespondingAccuRevaccountthatisamemberoftheAdmingroup.
3.
Downloadthecomponentsyouwillneedtoinstall(AccuRevinstaller,GitCentricinstaller,AccuRevandGitCentriclicensekeys,andsoon).
SeeLinuxInstallationonpage8,andAccuRevInstallationonpage9fordownloadinstructions.
4.
AsOSuser,installtheAccuRev(5.
6orhigher)Server,WebUIserver,andclient.
SeeAccuRevInstallationonpage9.
5.
AsOSuserinstallGitCentric.
SeeGitCentricInstallationonpage11.
6.
RestartTomcat.
7.
ConfigureGitCentricandAccuRev.
Thisconsistsofatleastdefiningan"ASSIGN_USER_PRIVILEGE"roleintheAccuRevserverconfigurationfile(acserver.
cnf)anditscorrespondinguserandscm_bridge_groupgroup.
Thenconfiguretheserver_master_trig.
plfileintheAccuRevtriggersdirectory.
SeeGitCentricInstallationonpage11.
Note:IfyouareusingGitCentricinareplicationenvironment,performallAccuRevserverconfigurationontheAccuRevmasterserver.
8.
BringuptheGitCentricWebUIandlogin.
SeeInitialGitCentricLogInonpage12.
AboutUninstallingGitCentricGenerallyspeaking,itisnotnecessarytouninstallyourcurrentGitCentricversionbeforeupgrading.
However,ifyouwishtouninstall,youshouldbesuretobackupyourcurrentGitCentricdatabase.
SeeUninstallingGitCentriconpage20formoreinformation.
AboutMovingGitCentrictoaNewMachineOnevariationoftheGitCentricinstallationprocessinvolvesmovingGitCentricrepositoriestoanewmachineonwhichanewversionofGitCentricisinstalled--asmightberequiredafteryouhaveupgradedaserver,forexample.
Thefollowingstepsoutlinetheproceduretofollow.
Note:RefertoChapter8,MovingtheAccuRevServerandRepositorytoAnotherMachineintheAccuRevAdministrator'sGuideforinformationrelatedtomovingAccuRev.
TomoveGitCentrictoanewmachine:OntheExistingMachine1.
Usingtarorasimilarcopyutility,makeacopyofallGitrepositoriesthataremappedtoAccuRev.
Gitrepositoriesaresavedinyour/site/gitdirectory.
8GitCentricInstallationandReleaseNotesOntheNewMachine2.
InstallGitCentricasdescribedinGitCentricInstallationonpage11ofthisbook.
3.
DroptheGitCentricrepositoriesyoucopiedinStep1to/site/gitinthenewGitCentricinstallation.
4.
StopandrestartTomcat:/bin/shutdown.
sh/bin/startup.
sh5.
ConfigureyournewGitCentricinstallation.
Ataminimum,thisrequirescreatingnewbranch-streammappingstoassociateyourGitrepositorieswithyourAccuRevdepots.
Inaddition,userswillneedtore-registerwithGitCentric.
Formoreinformation,see"MapaGitBranchtoanAccuRevStream"inChapter2,HowTo.
.
.
intheGitCentricUser'sHelpforinformationonthisandotherconfigurationtopics.
LinuxInstallationCurrentlytheGitCentricserverissupportedonlyonLinuxoperatingsystems.
ExistingLinuxServersIfyouhaveanexistingLinuxmachinethatyouwishtouseasahost,youcaninstallGitCentriconthatsystem.
1.
Createanadministrativeuserandlogintothisaccount.
ThisistheaccountyouwillusetoinstallAccuRevandtheGitCentricsoftware.
2.
ProceedtoAccuRevInstallationonpage9.
ToInstallLinuxIfyouneedtoinstallaLinuxoperatingsystemfromscratch,checkthesupportmatrixforthecurrentAccuRevreleaseandchooseaLinuxversion:http://supportline.
microfocus.
com/prodavail.
aspxAfterinstallation,youmayneedtoaddsomesupportpackagesanddosomeconfigurationasexplainedlaterinthisdocument.
1.
GotothedownloadpagefortheLinuxdistributionyouhavedecidedtouseandinstallthelateststablerelease.
Forexample,ifyoudecidetouseUbuntu,gotohttp://www.
ubuntu.
com/download.
2.
OnceyouhaveinstalledLinux,youwillbepromptedtosetupausernameandpassword.
Createauserandlogintothisaccount.
(ThisassumesthatyoudonotalreadyhaveanexistingLinuxAccuRevadminuseronyournetworksuchas"acserver".
)ThisistheaccountyouwillusetoinstallAccuRevandtheGitCentricsoftware.
Thisdocumentuses"gcadmin"asanexampleinstalleraccount.
3.
Asyouuseyournewsystem,youwillprobablyfindthatyouneedtoinstallextrapackages.
IfyouareaWindowsuser,readdocumentationaboutthe"apt-getinstall"commandonUbuntu(or"yum"onRedHatorCentOS).
BasicLinuxcommandsandproceduresarebeyondthescopeofthisdocument,sobepreparedtodosomewebsearching.
Mostbasicquestionscanbeansweredbysearchingforwhatevertaskyouwanttoperform,andappending"Ubuntu"or"RedHat"or"CentOS",andsoon.
GitCentricInstallationandReleaseNotes9AccuRevInstallationYouneedtohaveanAccuRev(5.
6orhigher)server(includingtheAccuRevWebUItomcatserverandtheAccuRevPostgreSQLserver)ontheLinuxmachinetoactastheGitCentricserver.
IfyoualreadyhaveAccuRev5.
6orhigherinstalledonaLinuxhostthatyoucanuseforGitCentric,justreviewthefresh-installinstructionsbelowtoensurethatyouhaveeverythingthatyouneed.
1.
LogintoLinuxastheadministrativeuser(whichyoushouldhavecreatedaboveinLinuxInstallation).
2.
Ensurethatyouhavea"Downloads"directory(forexample,"~/Downloads").
Ifyoudonot,createone:>cd>mkdirDownloads3.
Getacopyofthefull5.
6(orhigher)AccuRevinstallerfromtheAccuRevwebsite:http://supportline.
microfocus.
com/websync/productupdatessearch.
aspxThefullinstallerisforinstallingtheAccuRevserver(whichalsoinstallstheAccuRevdatabase),AccuRevWebUIserver(whichinstallsaTomcatwebserver),andalocalcopyoftheAccuRevclient.
4.
FollowtheproceduresintheAccuRevInstallationandReleaseNotestodoafullinstallastheOSusertoinstalltheAccuRevserver,AccuRevWebUIserver,database,andAccuRevclient.
Althoughyoucaninstallthesetowhereveryouwant,thedefaultistoinstallthemunderthehomedirectory(forexample,~/accurev).
Note:Ifyouchoosetoinstallinadifferentdirectorysuchastheroot-owned/optdirectory,youwillneedtobeabletoperformasudomkdircommand,andthenchmodandchownfor.
YoucannotinstallAccuRevorGitCentricasroot.
5.
Afterinstalling,makesurethattheAccuRevserver,AccuRevDBServer,andAccuRevTomcat(WebUI)serverarerunning.
Note:MakesurethattheAccuRevlicensefileyouacquireincludesalicenseforGitCentricaswellasforAccuRev.
6.
Whentheinstallationiscomplete,letAccuRevguideyouthroughtheQuickSetupWizardandcreateauseraccountfortheadminuser.
7.
UsetheuserandgroupoptionsundertheAdmin->SecuritymenuintheAccuRevGUI,orthemkuser,mkgroup,andaddmemberCLIcommands,tocreateAccuRevusersandgroupstoworkwithGitCentric.
Eithernoworlater,youcanalsochoosetocreateadditionalAccuRevuserswhoyouwanttohaveaccountsontheGitCentricAccuRevserver.
10GitCentricInstallationandReleaseNotesThefollowingtablesummarizestheminimalAccuRevusersandgroupsthatyoushoulddefinewhenfirstinstallingGitCentric.
Thespecificnamesshownaresuggestions;theyarenotrequiredtobeused.
Table3.
AccuRevUserandGroupAccountsRequiredbyGitCentric8.
OneachAccuRevserverthatwillhavestreamsmappedtoGitbranches(whichmayormaynotincludetheGitCentricAccuRevserver,dependingonyourconfiguration),opentheAccuRevserverconfigurationfile/bin/acserver.
cnfandaddthefollowingline:ASSIGN_USER_PRIVILEGE=scm_bridge_groupSaveacserver.
cnfandclosetheeditor.
Note:IfyouhaveanexistingAccuRevinstallationandtheacserver.
cnffilecontainsalinedefiningCC_USER,seeASSIGN_USER_PRIVILEGEandCC_USERonpage19intheTroubleshootingsection.
9.
RestarttheAccuRevserver:>acserverctlstop>acserverctlstartNameUserorGroupMemberofGroupDescriptionadmingroupN/AStandardAccuRevgroupforadministrativeusers.
scm_bridge_groupgroupN/AGroupofusersoneachAccuRevserverthattheGitCentricbridgeusestokeepGitbranchesinsyncwithAccuRevstreams.
TypicallyconsistsofatleastusergcSyncUser,andisassignedtoASSIGN_USER_PRIVILEGEineachAccuRevserver'sacserver.
cnffile.
Differentuserswithdifferentaccessrightscanbeassignedtothisgroupforsecurityreasons.
Valuedoesnotnecessarilyneedtobe"scm_bridge_group".
gcadminuseradminAdministrativeloginaccountontheGitCentricAccuRevserver.
Valuedoesnotnecessarilyneedtobe"gcadmin".
gcSyncUseruserscm_bridge_groupThe"serviceaccount"useroneachAccuRevserverthatismappedtobranchesinaGitrepository.
Memberofthescm_bridge_groupgroup,whichisassignedtotheASSIGN_USER_PRIVILEGEsettingineachAccuRevserver'sacserver.
cnffile.
(SeeStep8below.
)ShouldNOTbeamemberoftheadmingroup.
Youneedtohaveatleastoneserviceaccountuser,andyoucanhavemultiplesuchuserswithdifferentprivilegesfordifferentstreams.
Thisuser'sAccuRevElementACL(EACL)permissionsdeterminewhichfilescanbeeditedintheGitCentricrepository.
FilesthatcannotbeediteddonotappearatallintheGitCentricrepository.
YouwillsetupACLsaftertheinstallationiscomplete.
ThisprocessisreferencedintheGitCentricUser'sHelp,andisdocumentedintheAccuRevuserdocumentation.
GitCentricInstallationandReleaseNotes11GitCentricInstallationExceptwherenotedbelow,first-timeGitCentricinstallationsandupgradesfrompreviousGitCentricreleasesarethesame.
RefertoGenericnamesusedduringinstallation,Table2onpage6duringthisprocedure.
1.
Loginastheadministrativeuser(whichyoushouldhavecreatedaboveinLinuxInstallation).
shouldbethesameuserthatinstalledAccuRev.
Note:IfyouhavejustinstalledAccuRevforthefirsttimeasdescribedintheprevioussection,youshouldlogoutandlogbackintotheOStoensurethatenvironmentvariableswhichtheAccuRevinstallerappendedtoyour.
profile(JRE_HOMEandLD_LIBRARY_PATH)havebeensetandareavailabletotheGitCentricinstaller.
2.
GetacopyofthelatestGitCentricinstallerandsaveitinyourDownloadsdirectory.
YoucangettheGitCentricinstallerfromtheMicroFocusSupportLinewebsite:http://supportline.
microfocus.
com/websync/productupdatessearch.
aspx3.
TheGitCentricinstallationassumesthattheTomcatwebserverisrunning,andthat"hotdeploy"modeisenabled(thisisthedefaultmodewhenTomcatisinstalled).
Ifyoursitehasturnedoffthismode,MicroFocusrecommendsthatyouturnitbackonforthedurationoftheinstallationprocessbysettingautoDeploytotrueintheTomcatserver.
xmlconfigurationfile.
4.
MakesurethattheAccuRevdatabaseserverisrunning.
Youcanusethefollowingcommandstoverifythatthedatabaseserverisrunning:>/postgresql/bin/psql-hlocalhost-U-p-lNote:Thefinaloptionforthepsqlcommandis"hyphenlower-caseel".
5.
FromtheDownloadsdirectory,runtheinstaller,whereisthenameofthecurrentGitCentricinstallationpackage,suchasAccuRevGitCentric_2015_1_00_Linux_x86.
bin:>sh.
/.
binNote:Youcanruntheinstallerinanon-graphicalconsolemodewiththe-ioption:>sh.
/.
bin-iconsoleTheinstallerwillautomaticallyruninconsolemodeifitdeterminesthatitisunabletoruningraphicalmode.
6.
Theinstallerprocedureisfairlyself-explanatory.
Note:AdjustthepathoftheAccuRevserverasnecessary,andensurethatthepathisaccurate.
Forexample,ifthedefaultassumes/home//accurevandtheserverisactuallylocatedat/opt/accurev,adjustthepathaccordingly.
Note:IfyouareusingAccuRevinareplicationenvironment,thisisthelocationoftheAccuRevmasterserver.
AdjustthepathoftheGitCentricinstallationasnecessary.
Again,ifthedefaultis/home//AccuRevGitCentricandyouwanttoinstallin/opt/AccuRevGitCentric,adjustthepathaccordingly.
Note:Ifyouinstallin/optorsomeotherroot-owneddirectory,youmustusesudocommandstocreatetheinstallationdirectoryandensurethatownershipandpermissionsarecorrect.
12GitCentricInstallationandReleaseNotesUPGRADESONLY:IfyouareupgradinganexistingGitCentricinstallation,youmustspecifytheexistinginstallationpathasthelocationforthenewGitCentricinstallation.
Onthe"CodeReviewemailsettings"page,leavetheSMTPAccessUsernamefieldblankifyouarenotsurewhattoenter.
7.
RestartTomcat:/bin/shutdown.
sh,followedby/bin/startup.
sh.
InitialGitCentricLogInBeforeyoulogintoGitCentricforthefirsttime,ensurethat:YouhaveanAccuRevloginaccountthatbelongstotheAdmingroup(seeTable3above).
YouhaveanSSHpublickey.
SSHKeyGenerationIfyoudonotalreadyhaveanSSHkey,generateonenowfromtheOScommandline:>ssh-keygen-trsa-C"@"Thiscreatesapopulatedsubdirectoryat~/.
ssh.
Youwillneedthecontentsof~/.
ssh/id_rsa.
pubinupcomingsteps.
ThetopicofSSHkeysisbeyondthescopeofthisdocument,butthereisagreatdealofinformationonthewebthatyoucanlocatewithyourfavoritesearchengine.
Onesitethathasrelevantinformationishttps://help.
github.
com/articles/generating-ssh-keys.
LogInandSelf-RegisterPointyourbrowsertotheGitCentricinstallation.
Ifyouchosedefaultsduringinstallation,theaddressshouldbesimilarto:http://:8080/gitcentricAdjustthe"8080"portifnecessary.
SinceyouarethefirstusertologintoGitCentricafterinstallation,youarepresentedwithaone-time"bootstrap"screenwhichasksyoutospecifytheAccuRevserverandsomeadditionalinformation.
NoGitCentricmenusarevisibleintheGUIatthispoint.
GitCentricInstallationandReleaseNotes13Note:Whenyoucompletethisscreen,youareautomaticallyaddedtotheAdministratorsgroup,soyoushouldmakesurethatanadministratoris,infact,thefirstusertologintoanewGitCentricinstallation.
Table4.
InitialConnectionValuesUponcompletionofthebootstrapscreen,youaretakentotheself-registrationpage,whichisdescribedinthefollowingsection,RegisterwithGitCentriconpage14.
FieldExampleCommentsAccuRevServerlocalhostThisisthehostoftheAccuRevserverusedwithGitCentric.
YoumayaddotherAccuRevserverslater,butthisistheAccuRevserverwheretheGitCentricdatabaseandTomcatserverreside,andistypicallyonthesamemachineastheGitCentricinstallation.
Thevaluecanbethenameoftheserver,anIPaddress(notrecommended),or"localhost".
NotethatifyouareconnectingtoGitCentricfromaremotemachineviayourwebbrowser,localhostindicatestheAccuRevserveronthehostyouareconnectingto,notyourlocalmachinewhereyoustartedyourbrowser.
Port5050ThisistheAccuRevportnumber,andistypically"5050".
CLIPath/home/gcadmin/accurev/bin/accurevThisisthepathtotheAccuRevclientexecutableontheGitCentricserverthatshouldbeusedtocommunicatewiththeAccuRevserver.
Forexample:/bin/accurevWhereistheactualinstallationdirectory,suchas/home//accurev.
TheGitCentricserverrequireseitheramasterAccuRevserveroracompatibleAccuRevclientinstalledlocally.
InthecasewhereyouareusingAccuRevserversofdifferentrevisionlevels,youmusthaveacompatibleclientinstalledontheGitCentricservermachineforeachversionoftheAccuRevserveryouareusing,andeachmustbeconfiguredwithGitCentricusingitsspecificpath.
Forexample,ifyouneedtoworkwithtwoAccuRevservers--onerunningversion5.
7andonerunningversion6.
2--youwouldneedtwoAccuRevclientsinstalledontheGitCentricserver:one5.
7clienttoworkwiththe5.
7server,andaseparate6.
2clienttoworkwiththe6.
2server.
UserNameSpecifytheAccuRevcredentialsfor(suchas"gcadmin")thatyoucreatedduring"AccuRevInstallationonpage9.
Password14GitCentricInstallationandReleaseNotesRegisterwithGitCentricWhenanyuserlogsintoGitCentricforthefirsttime,GitCentricpromptsthatuserthroughaself-registrationprocess.
ThisisprovidedsothatuserswithvalidAccuRevaccountsdonotneedtoinvolveanadministratortogetsetuponGitCentric:Enteryourinformationasfollows:1.
FullName:Yourrealname(unlessthisisanaccountforarolesuchas"GuestUser").
2.
PreferredEmail:EnterthesameemailaddressherethatyouspecifyfortheGituser.
emailconfigurationforyourclones.
Ifthesedonotmatch,pushesfromyourclonewillfail.
Ifyouneedtomaintainmultipleemailaddresses,youcanaddthemlateratMyAccount->ContactInformation.
(See"ContactInformation"intheGitCentricUser'sHelp.
)3.
SSHkey:ClicktheAddbuttonandcopythecontentsofyourSSHpublickeyfilehere(seeSSHKeyGenerationonpage12)andSaveit.
(Note:IfyourAccuRevuseraccountisalreadyassociatedwithanSSHpublickey,thatkeywillbeautomaticallyinsertedinthisfield.
)YourpublicSSHkeyfileistypically~/.
ssh/id_rsa.
pub.
YoucanchoosetodothislaterthroughMyAccount->PublicKeysGitCentricInstallationandReleaseNotes15(seetheGitCentricon-linehelp),butuntilthisisset,youwillbeabletouseonlythecodereviewfeaturesofGitCentric.
4.
ClickContinuewhendone.
InstalltheAccuRevTriggerOncetheinstalleriscompleteandyouhavecompletedtheinitial"bootstrap"pageandtheself-registrationpage,youneedtoinstalltheAccuRevtriggerserver_master_trig.
plontheAccuRevserver:Note:IfyouareusingGitCentricinareplicationenvironment,youneedtoperformthisprocedureontheAccuRevmasterserver.
Inaddition,ifyoulateraddotherAccuRevserverstoyourGitCentricconfiguration,youmustinstallserver_master_trig.
plonthoseserversaswell.
1.
Checktoseeifatriggersdirectoryexistsunder/storage/site_slice.
Ifnot,createit.
2.
Copytheserver_master_trig.
plfilefrom/bintotheAccuRevservertriggersdirectory:>cd/bin>cpserver_master_trig.
pl/storage/site_slice/triggers>cd/storage/site_slice/triggers>chmod+xserver_master_trig.
pl3.
LocatetheACCUREVCLIENTPATHsectionintheserver_master_trig.
plfileandspecifythepathforyourAccuRevclient.
Forexample:$::AccuRev="/usr/accurev/bin/accurev";16GitCentricInstallationandReleaseNotes4.
Testthatserver_master_trig.
plcancompile:Lookatthefirstlineofserver_master_trig.
plandnotethePerlexecutablethatitexpectstofind(forexample,"#!
/usr/bin/perl").
Usingthispath,usethe"perl-c"commandtotestthetrigger:>/usr/bin/perl-c.
/server_master_trig.
plYouknowthatyourinstallationiscompleteandfunctioningwhenyouseethemessage:server_master_trigsyntaxokIfanyerrorsappear,addressthembeforeproceeding.
Forexample,ifPerlisnotinstalledintheexpectedlocation,modifythepathinserver_master_trig.
pl(orinstallitwherethescriptexpectstofindit).
IfanyoptionalPerlmodulesaremissing,suchasXML::Simple,installthem(forexample,asroottryinstallinglibxml-sax-expat-perlfollowedbycpaninstallXML::Simple).
Note:WheneveryouaddanyadditionalAccuRevserverstoGitCentric,youwillneedtorepeatthesestepsofcopyingandconfiguringtheserver_master_trig.
plfile.
Windowsonly:IfyouaddaWindows-basedAccuRevservertoyourGitCentricinstallation,youneedtoconvertthe.
plfiletoabatchfileusingthePL2BATutility(PL2BATshouldbepartofyourPerldistribution):>PL2BATserver_master_trig.
plEnabling/DisablingCodeReviewGitCentric'sGerritCodeReviewfeatureisoptional.
Youandyourusersmustperformsomeconfigurationstepstoreflectwhetherornotcodereviewispartofyourworkflow.
Seethe"Enable/DisableCodeReview"sectionoftheGitCentricUser'sHelpfordetails.
TesttheGitCentricInstallationPerformthefollowingteststoensurethatvariousGitCentricmodulesareinplaceandthattheoperatingsystemmeetsbasicrequirementstorunGitCentricsuccessfully.
TesttheGitCentricBridgeConnectionTesttheconnectiontotheGitCentricbridgeandensurethattherearenofirewallissues:1.
FromtheGitCentricservercommandline:wget-q-O-http://localhost:8080/kandoBridge/v1Youshouldseea"HTTPRequestsent"message,followedbyadditionalinformation,andendingwith"v1saved[nn/nn]"2.
Catthefile"v1":cat.
/v1YoushouldseeamessagedisplayingaSHA,likethis:{"sha",""}whereistheSHAvalue.
Anyotherresultindicatesaproblemthatshouldbecorrected.
GitCentricInstallationandReleaseNotes17ProceedtotheGUIPointyourbrowsertotheGitCentricinstallation:http://:8080/gitcentricAdjustthe"8080"portifnecessary.
Bringupthedocumentationasdescribedinthenextsection.
AfterreadingChapter1,ConceptsandOverview,proceedtoChapter2,Howto.
.
.
fortask-basedproceduresforbothendusersandadministrators.
DisplayingtheUser'sHelpTheGitCentricUser'sHelpisavailablefromtheGitCentricGUIasbothbrowseableandsearchableHTML,andasPDF.
OnceyoudisplaytheGitCentricGUIinabrowser,youcandisplaythehelpbyclickingthehelpbutton()attherightoftheGitCentricmenubar.
ToaccessthePDFversionoftheHelp,clickthePDFicon()intheupper-rightcorneroftheHelpdisplay.
Tip:WhenstartingtheGitCentricGUIforthefirsttime,werecommendthatyoubringuptheHelpandnavigatetoChapter1,ConceptsandOverviewandChapter2,Howto.
.
.
,whichwillguideyouthroughanumberof"gettingstarted"procedures.
TroubleshootingThissectiondescribessometroubleshootingtoolsandtechniquesyoucanusetohelpresolveissuesyoumightencounterwhenstartingandrunningGitCentric.
IfYouCannotLogInIfyourfirstattempttoconnecttotheGitCentricWebUIserverfailswithanerrorsuchas"UnabletoConnect"(Firefox),"Thewebpagecannotbedisplayed"(InternetExplorer),"Thiswebpageisnotavailable"(Chrome),orsomethingsimilar,checkthat:Yoursyntaxiscorrect(forexample,"http://localhost:8080/gitcentric")YouareactuallypointingtotheGitCentricserver(forexample,areyouspecifying"localhost:8080"whenthewebserverisactuallyinstalledonaremotemachine).
Yournetworkconnectionisworking.
TheTomcatserverneedstoberestarted.
(Thereisaknownissuewithre-installationsrequiringthatyoustopandstarttheTomcatserverwhentheinstallationisdone:/bin/shutdown.
sh,followedby/bin/startup.
sh.
)TheTomcatdeploymentconfigfile:(conf/Catalina/localhost/gitcentric.
xml)iscorrect.
Ifyoucanseetheinitialconnectiondialog(describedinInitialGitCentricLogInonpage12),butitisrejectingthevaluesyouenter,double-checkthatyouarespecifyingthecorrectserverandportvalues,andparticularlythatyouarespecifyingthecompletepathtotheAccuRevclientexecutableonthatserver.
Ifyoucanseethelogindialog,butget"InvalidUsernameorpassword"errors,checktheusualcredentialdetailslikecorrectspellingandproperpassword,andiftheselookcorrect,extendyourtroubleshootingto18GitCentricInstallationandReleaseNotesseeiftheAccuRevserverisactuallyupandrunning,andthatitslicenseserverisalsoupandrunning.
("Usernameandpassword"errorscansometimesbecausedbyfactorsbeyondthelogincredentials.
)TestthatyoucanactuallylogdirectlyintotheAccuRevserverwiththesamecredentials.
Ifyoustillhaveproblems,proceedthroughthefollowingtroubleshootingproceduresandsuggestions.
General:TestingtheInstallationMakesurethatyouperformedthetestsinTesttheGitCentricInstallationonpage16aspartoftheinstallationprocess.
Youcanalsoperformthesetestswheneveryoususpectthatsomethinghasstoppedworking.
General:TheTomcatLogsThebesttroubleshootingtool--onceyougetpastthebasicOSinstallationandgettheGitCentricinstallationrunning--istheTomcatserverlogs.
Wheneversomethingisnotworkingright,theselogsshouldbeyourfirststop.
Inorderofusefulness:/logs/kandoBridge.
log/logs/kandoGerrit.
log/logs/catalina.
out/logs/localhost.
.
logYoushouldcdtotheTomcatlogsdirectory,anddumpoutthelastseverallinesfromthemostrecentlogfiles.
Forexample:>tail-75kandoBridge.
log|moreScrollthroughandlookforerrormessagesthatcanhelppointyoutoproblemswithportsordatabasenames,ormissingdirectories,andsoon.
Example:Onecommonerroris"Youarenotauthorizedtousethe-Uoption.
",whichappearswhenfilesfailtoappearintheAccuRevstreamafterbeingpushedfromGit.
ThisindicatesthatthereisaproblemwiththeASSIGN_USER_PRIVILEGEsettinginacserver.
cnf.
Notethatyoucanmodifythesettingsinthefollowingfiletocontrolthelevelofdetailslogged:/webapps/[kandoBridge|gitcentric]/WEB-INF/classes/log4j.
propertiesYoucanalsochecktheAccuRevserverlogs:/storage/site_slice/logs/acserver.
log/storage/site_slice/logs/trigger.
logGeneral:ServersToconfirmiftheTomcatwebserverisrunningatall,fromawebbrowserrunningontheserver,enter:http://localhost:8080IfyougetthegenericApacheSoftwareFoundationpage,theTomcatserveratleastisrunning,andyourproblemisfurtherdownstream.
Note:IfyouhavemultipleTomcatinstallations,thiscouldcausetheGitCentricinstallationtohang.
Set$CATALINA_HOMEtopointtotheTomcatwhichissupposedtoworkwithGitCentric.
ToconfirmiftheAccuRevserverisrunningandconfigured,trylogginginfromtheCLI:>accurevloginGitCentricInstallationandReleaseNotes19Ifyougeta"Connectionrefused".
.
.
"AccuRevError:1"message,trystartingtheserverwith:>/bin/acserverctlstartToconfirmiftheAccuRevPostgreSQLdatabaseisrunningandrecognizestheGitCentricdatabase:>/postgresql/bin/psql-hlocalhost-Upostgres-p5075-l(Thatlastargumentis"hyphen-lower-case-el",not"hyphen-numeral-one".
)Youshouldgetadisplayshowingalldatabasesandtheirowners.
If"accurev"appearsinthislistbut"kando"doesnot,youneedtore-examinetheinstallationsteps(oryourmanualsteps)executingthekandoMaintaincommand.
Ifyoucannotbringupthislistatall,youneedtore-examineyourstepsinstallingandstartingtheAccuRevserver(whichalsoinstallandstartthePostgreSQLserver).
General:SettingsThereareseveralpartsthatneedtoworktogetherinasuccessfulGitCentricinstallation.
Hereisalistofthingstodouble-check.
Makesurethat:ASSIGN_USER_PRIVILEGEisdefinedinacserver.
cnffortheAccuRevserver,andthatyourestarttheAccuRevserverafterdefiningorchangingit.
thetwo.
warfileshaveexpandedintheTomcatwebappsdirectory,creatingdirectoriesnamedgitcentricandkandoBridge.
/dbsettings.
confexistsandcontainsvalidentriesforthedatabaseport(typicallylocalhost:5075),anddatabaseusername/password(typically"postgres"/"postgres"unlessyouchangetheseforsecurityreasons).
yourAccuRevservercontainsproperlyinstalledandconfiguredtriggersfiles(seeInstalltheAccuRevTriggeronpage15).
youclearyourbrowsercacheafterupdatingtothelatest.
warfiles.
Also,rememberthatGit,unlikeAccuRev,doesnottrackemptydirectories.
Finally,experiencedGerritusersmayrecognizethatGitCentricincludesaGerritCodeReviewinstallation,althoughsomedetailsmaybemodifiedorignoredintheGitCentricenvironment.
Forexample,certaincodereviewinstallationvalues(suchasthehttpdjettywebserverportsetting)arenotusedintheGitCentricenvironment.
LD_LIBRARY_PATH:psqlsharedlibraryerrorThisshouldbedoneautomaticallybytheGitCentricinstaller,butifyoutrytorunthepsqlcommandandgetanerrorregardinglibpq.
so.
5,youneedtoupdateyourLD_LIBRARY_PATHtopointtothelibsubdirectoryundertheAccuRevversionofPostgreSQL:>exportLD_LIBRARY_PATH=/postgresql/lib:$LD_LIBRARY_PATHwhereisthedirectorywhereAccuRevisinstalled.
ASSIGN_USER_PRIVILEGEandCC_USERGitCentricrequiresthattheacserver.
cnffileoneachAccuRevserverthathasstreamsmappedtoGitbranchesviaGitCentriccontainsasettingcalledASSIGN_USER_PRIVILEGE.
ExistingAccuRevinstallationsthatincludedearlyreleasesofGitCentric,orwhichmadeuseoftheAccuRev"ClearCaseAdapter"product,mayhaveasimilarsettinginthisfilenamedCC_USER.
Ifthissettingisinuse,thefollowingruleapplies:20GitCentricInstallationandReleaseNotesIfyouspecifybothCC_USERandASSIGN_USER_PRIVILEGE,theCC_USERtakesprecedence.
DebugSettingsSeetheGitCentricConfigurationSettingssectionofAppendixA,ThekandoMaintainUtilityintheGitCentricUser'sHelpforsettingsthatmightbehelpfulfordebuggingpurposes.
Forexample,totroubleshooterrorsduringimportandexportoperationsyoucanusekandoMaintaintoenablealoggingfileandpreservetemporaryfiles:kandoMaintainaddconfig-u-nACCUREV_COMMAND_LOGFILE-vkandoMaintainaddconfig-u-nPRESERVER_TEMP_FILES-vyUninstallingGitCentricTheGitCentricuninstallerremoveseverythingintheGitCentricinstallationdirectory,includingtheGitCentricdatabase.
Therefore,beforerunningtheuninstaller,youshouldbackupanyfilesyouwishtokeep,andyoushouldusethefull_backup.
shcommandtobackuptheGitCentricdatabase.
SeeAppendixB,BackupandRestoreintheGitCentricUser'sHelponthedatabasebackupprocessbeforerunningtheuninstallcommand.
RunningtheuninstallCommandTheGitCentricuninstallcommandmustberunfromthehomedirectoryoftheuserwhoperformedtheGitCentricinstallation,.
TouninstallGitCentric,fromthislocationrun:.
/Uninstall\AccuRevGitCentricTheuninstallerdisplaysawarningmessage.
Youcancanceltheuninstalloperationatthistimeifyouchoose.
GitCentricInstallationandReleaseNotes21GitCentricReleaseNotesThischapterprovidesdetailedinformationaboutthechangesandknownissuesinthecurrentGitCentricrelease,GitCentric2015.
2,aswellasinpreviousGitCentricreleases.
UnderstandingIssueNumbersIncaseswhereanissueisidentifiedwithtwonumbers,34987(2788687),forexample,thefirstrepresentstheissuenumberintheAccuWorkissuetrackingsystem;thesecond,inparentheses,istheissuenumberintheSupportLinesystemusedbyCustomerCare.
ChangesinRelease2015.
2ThechangesforGitcentric2015.
2areenhancement-based,notissue-based.
Therefore,therearenotrackingissuenumberstolist.
TheIntroductionchapterexplainstheenhancementchangesforthisrelease.
ChangesinRelease2015.
1ThissectiondocumentschangesinRelease2015.
1.
33546--FilesattopleveldirectorynotexportedtoGitifnamestartswithaperiodInpreviousreleases,whenusingGitCentricwithAccuRev6.
1,filesatthetopleveldirectoryofastreamwerenotexportedtoGitiftheirnamestartedwithaperiod(.
).
ThisproblemhasbeencorrectedinthecurrentGitCentricrelease.
34353,34786--GitCentricdisplaysunpackerrorwhenpushingwithGit1.
8.
4andlaterInpreviousreleases,ifyouwereusingGit1.
8.
4.
3andlaterwithGerritCodeReview2.
6andlater,pusheswouldfailwhentheclientpushedareferencetoanobjectbutnottheobjectitself,aswhenyoupushanamendedcommitwithoutchangingtheobject,forexample.
Inthiscaseyoumightseeanerrorlikethefollowing:error:unpackfailed:errorMissingtreefatal:Unpackerror,checkserverlogThisproblemhasbeencorrectedinthecurrentreleasebysettingthegerrit.
configfileparameterreceive.
checkRefencedObjectsAreReachable=falsebydefault.
35018(1095884)--PushingignoredfilesresultsinaprotocolerrorInpreviousreleases,GitCentricdisplayedthefollowingerrorifyouwerepushingtoabranchthatwasmappedtoanAccuRevstreamthatcontaineda.
acignorefileandoneormoreofthefilesbeingpushedwasbeingignoredbyaruledefinedinthe.
acignorefile:fatal:protocolerror:badlinelength229122GitCentricInstallationandReleaseNotesThisproblemhasbeencorrectedinthecurrentrelease,andignoredfilesnolongerresultinanerrorwhentheyarepushed.
35326--"TransactionTooHigh"erroronexportbehaviorcorrectedInpreviousreleases,whenexporttriggersfiredoutoforder,theerror"TransactionTooHigh"wouldappearintheGitCentricGUIandinthekandoBridge.
log,sometimesloggingattheERRORlevel.
Thisbehavior,however,isnotanerror,andthemessagehasbeenchangedtothefollowinginthecurrentrelease:"ignoringtransactionalreadyprocessed".
35437--GitCentricinstallerdoesnothandleinvalidDBAdminpasswordsInpreviousreleases,theGitCentricinstallerdidnotproperlyhandleinvalidDBAdminpasswords,requiringtheusertoquitandrestarttheinstallerinordertoenterthecorrectpassword.
Thisproblemhasbeencorrectedinthecurrentrelease,andtheinstallernowallowsyoutoreentertheDBAdminpasswordusingtheinstaller'sBackbutton,avoidingtheneedtoquittheinstaller.
35626--ChangingtheGitCentricserverhostnamecausespushestofailInthepreviousrelease,changingtheGitCentricserverhostnamecausedsubsequentpushestofailbecauseexistingworkspaceswerenotrecognizedonthenewhost.
Thisproblemhasbeencorrectedinthecurrentrelease.
36069(1095727)--SupportforGitCentricandAccuRevserversondifferenthostsInpreviousreleases,specifyinganyvalueotherthanlocalhostfortheGitCentricbridgehostnameingerrit.
configcausedpushestofail.
Thisproblemhasbeencorrectedinthecurrentrelease,andyoushouldnowspecifythemachinenameorIPaddressoftheGitCentricbridgehost.
36260--New:SSHcommandallowsyoutodeleterepositoriesAnewSSHcommand,gitcentricdelete-repo,allowsyoutodeleterepositories.
Inadditiontodeletingtherepository,thiscommandalsodeletesGitCentricdatabaserecordsrelatedtotherepositoryandconfigurationinformationlikeAccuRevserversettingsandbranch-streammappings.
36559(1096247)--New:improvementstobackupandrestoreGitCentric2015.
1introducestwonewcommandstoperformbackupandrestoreoperations:full_backup.
shandfull_restore.
sh.
ThesenewcommandsaddressdifficultiessomeusersexperiencedusingGitCentric'sbackupdbsandrestoredbscommandsrunusingkandoMaintain,especiallywhenusingthemtomigrateGitCentricfromoneservertoanother.
Amongtheimprovementsprovidedbyfull_backup.
shandfull_restore.
sh:full_backup.
shbacksupallrepositories,databases,andconfigurationfilesneededtosuccessfullymigrateGitCentricfromonemachinetoanother.
Inthepreviousrelease,the.
tarfilecreatedbythebackupdbscommandomittedGitrepositories,Gerritconfigurationfiles,andthedatabaseconnectionconfigurationfile.
OnrestoringGitCentric,younolongerhavetomanuallycopytheAllProjects.
gitfiletothenewserver.
Inaddition,changesweremadetoboththermdbandrestoredbscommands,whichnowproperlydropbothdatabasesrequiredtorestoreGitCentric.
GitCentricInstallationandReleaseNotes23MicroFocusrecommendsthatyouusefull_backup.
shandfull_restore.
shtobackupandrestoreGitCentric.
SeeAppendixB.
BackupandRestoreintheGitCentricUser'sHelpformoreinformation.
24GitCentricInstallationandReleaseNotesChangesinRelease2014.
1ThissectiondocumentschangesinRelease2014.
1.
31299--ImprovementstotheStatusMonitorTheStatusMonitor,whichdisplayssynchronizationinformationforbranch-streammappings,hasbeenimprovedforGitCentric2014.
1:Theuserinterfaceislabeled.
TheStatusrownowshowsthetasknamefirst,thenthephase.
Forexample,FullExport:streamToCommit-ProcessElements.
Whenabridgetaskcompletes,theStatusareanowdisplaysIdle.
32096--ImprovementstotheAccuRevConnectorTheuserinterfaceandmessagesassociatedwiththeAccuRevConnectorwereenhanceforGitCentric2014.
1toimproveusability.
32332--InstallerimprovementsTheinstallerhasanumberofimprovements,including:Inpreviousreleases,iftheinstallerdidnotlocatesoftwarerequiredbyGitCentric(postgresorAccuRev,forexample),itsimplydisplayed"None"intheVersioncolumnofthetablelistingrequiredsoftware.
Thisproblemhasbeencorrectedinthecurrentrelease,andtheinstallernowdisplays"notfound"whenitisunabletolocaterequiredsoftware.
(33178)TheconsolemodenowallowsyoutospecifyalternatelocationsforLinuxbinarydependencies.
(32332)Note:TheuninstallernowcompletelyoverwritestheexistingGitCentricinstallation,includingtheGitCentricdatabase.
SeeGitCentricInstallationNotesonpage5forimportantinformationregardingthischange.
(32392,32464,33683)32630--IncorrectsyntaxusedforrootpathsInpreviousreleases,theGitCentricbridgedidnotdisplaythemountpointtreecorrectly.
Thisproblemhasbeencorrectedinthecurrentrelease.
32742--ServerpropertiescheckedeachtimeTomcatisstartedAnenhancementinGitCentric2013.
3(31617)automatedthespecificationoftheGitCentricserver'sURLandUUID.
AnenhancementinGitCentric2014.
1ensuresthatthesesettingsarechecked(and,ifnecessary,reset)eachtimetheGitCentricbridgeisrestarted.
32879--GitCentricnowusesJGitPreviousversionsofGitCentric,includingtheGitCentricinstalleritself,reliedonGit.
GitCentricnowusesaninternalcopyofJGit,removingthedependencyonainstalledGit.
GitCentricInstallationandReleaseNotes2532889--New:ToolsforBrowsingtheRepositoryNew:ToolsforBrowsingtheRepository.
GitCentric2014.
1introducesseveralnewtoolsthatmakeiteasytoexploretherepository:TheCommitspageletsyouviewthecommithistoryofaspecificbranchortag.
TheCommitspageisdisplayedbydefaultwhenyoustartGitCentric.
TheSourceTreepageletsyoureviewthefiles--new,deleted,ormodified--associaedwithaspecificcommit.
Clickingatextfiledisplaysitscontentsinafileviewer,whichcanbeusefulwhendevelopersaretroubleshootingproblemswithnewcode.
TheBranchespagehelpsyoudeterminehowdivergentbranchesinarepositoryhavebecome,enablingyoutotakeappropriateactionon"dead"or"stale"branches(bymergingorpruning,forexample).
Aspartofthischange,theGitCentricuserinterfacehasundergoneseveralotherchangestoimproveusability:TheGitCentricuserdocumentationisnowdisplayedusingthehelp()button.
UseraccountinformationisaccessibleusingtheMyAccountlinkintheuserdrop-downmenu.
Repository,group,andserveradministrationfunctionsareavailablefromtheAdministrationbuttononthetoprightoftheGitCentricinterface.
GitCentricnotestherepositoryandbranchthatareactiveatthetimeyoulogout,andusesthatinformationtoreturntotheselectedrepositoryandbranchthenexttimeyoulogin.
33068--InitialemptycommitsnowperformedautomaticallyGitCentricnowenforcesthebestpracticeofmakinganinitialemptycommitwhencreatingarepository.
33071--ClonecommandnowusesSSHInpreviousreleases,GitCentricusedtheHTTPprotocolasthedefaultforgitclonecommandscopiedontheGeneralpaneloftheRepositoriespage.
GitCentricnowusestheSSHprotocolasthedefaultforcopiedgitclonecommands.
33130--ACCUREV_HOMEnowsettoanewdirectoryInpreviousreleases,thebridgesettheACCUREV_HOMEenvironmentvariableto/tempeachtimeanAccuRevcommandwasrun.
Usingthe/tempdirectoryhadthepotentialtointerferewiththeSecureSocketsLayer(SSL)protocolintroducedinAccuRev6.
1.
Toresolvethisproblem,theGitCentricinstallationcreatesanewdirectory,/AccuRevGitCentric/accurev,andthebridgenowsetsACCUREV_HOMEtoit.
NotethatifyouhaveimplementedSSLforyourAccuRevinstallation,theSSLcertificatesmustbeplacedin/AccuRevGitCentric/accurev/.
accurev.
33247--XMLrepliestoRESTAPIcallsareproperlyescapedInpreviousreleases,GitCentricdidnotproperlyescapespecialcharactersintheXMLrepliestoRESTAPIcallsinitiatedbytheGitCentricbridge--typicallysuccessandfailuremessages--andthissometimescausedanerrorduringGitCentricoperations.
Thisproblemhasbeencorrectedinthecurrentrelease.
26GitCentricInstallationandReleaseNotes33267--CommitauthorscannowreuseemailaddressesInpreviousreleases,pusheswouldfailifthesameemailaddresswasassociatedwithmultiplecommitauthors,ascouldbethecasewhenoneuserusedthesameemailaddressacrossmultipleservers.
Thisproblemhasbeencorrectedinthecurrentrelease:GitCentricnowincludestheAccuRevserverIDwhenqueryingfortheemailaddress,whichresolvesmostcases.
Intheeventthatauniqueemailaddresscannotbedetermined,GitCentricrejectsthepushanddisplaysanerrormessageindicatingthereason.
33452--InitialexportoperationisretriedwhentheAccuRevsessionexpiresInpreviousreleases,theinitialexportoperationthatpopulatesaGitbranchmappedtoanAccuRevstreamwouldsometimestime-outwhentheAccuRevstreamwasthesource.
RatherthantryingtologintheGitCentricuserandtryingtheoperationagain,GitCentricwouldbehaveasiftheoperationsucceeded,butcreatingmultiple0-lengthfilesintherepositoryasaresult.
Thisproblemhasbeencorrectedinthecurrentrelease,andiftheGitCentricusersessiontimesoutduringalengthyoperation,itattemptstologintheGitCentricuserandtrytheoperationagain.
33599--SecurityerrorsdisplayedintheGitCentricGUIInpreviousreleases,whensecurity-relatederrorsoccurred(401Unauthorized,403Forbidden,and405Methodnotallowed,forexample)theywerewrittenonlytothekandoGerrit.
logfile.
InGitCentric2014.
1,security-relatederrormessagesarenowdisplayedinadialogboxallowingforeasiertroubleshootinganddiagnosis.
33731--GerritCodeReviewupgradedto2.
7GitCentric2014.
1usesGerritCodeReviewVersion2.
7.
33760--ImportHistoryremovedfromGitCentric2014.
1TheabilitytoimportthecompleteGithistoryoftherepositoryintoAccuRev,whichwasinBetainthepreviousrelease,hasbeentemporarilyremovedfromGitCentric.
Thisfunctionalityisexpectedtobemadeavailableinafuturerelease.
KnownIssuesMicroFocusisawareofthefollowingissuesaffectingthecurrentGitCentricrelease.
24861--ChangepackagegapsIfyouusechangepackages(CPKs)withGitCentricinAccuRev5.
7orearlier,beawarethatGitCentricdoesnotcurrentlyspanCPKgapsautomatically.
ThisisnotanissueinAccuRev6.
0owingtochangesinCPKfunctionality.
27473--emailconfirmationGitCentriccurrentlydoesnotprovideconfirmationemailforaccountverification.
GitCentricInstallationandReleaseNotes2727790--AuthorizationGitCentriccurrentlysupportsonlyAccuRevauthentication(thatis,GitCentricusersmusthaveavalidAccuRevaccount).
GitCentricdoesnotcurrentlysupportotherauthorizationtypessuchasLDAP,OpenID,etc.
28337--LoginlicensemanagererrorsIfthelicensemanagerisnotrunningwhenyoutrytologintoGitCentric,theerror(s)displayedbythesystemmaynotclearlyindicatethecauseoftheproblem.
28936--kandoMaintainbackupfilesThekandoMaintainbackupdbscommandcreatesbackupfilesinthesamedirectoryasthekandoMaintain.
jar,notwherekandoMaintainisrunfrom.
29070--Re-installsrequireTomcatrebootIfyoure-installGitCentricoveranexistinginstallation,sometimesyoucannotlogintoGitCentricwhentheinstallationisdone.
Tofixthis,restartTomcat(/bin/shutdown.
sh,followedby/bin/startup.
sh).
29564--RegisterallIPaddressesforaserverForsecurityreasons,theGitCentricbridgeacceptscommandsonlyfromIPaddressesthatitrecognizes.
IfyouhaveregisteredanAccuRevserverthathasmultipleIPaddresses(forexample,iftheserverhasmultipleEthernetcards)youmustaddserverentriesforeachIPaddress.
Inthiscase,youshouldperformGitCentricoperationsonlyagainstoneoftheseserversentries--typicallyonewhereyouhavespecifiedahostnameratherthananIPaddress.
IfyouhaveasituationwhereIPaddressescanchangeovertime(suchasdynamicIPaddressesassignedviaDNS),youmayneedtoconsidersettingAC_BRIDGEAPI_SECURITY_POLICYtoAllowAnyHost.
Note,however,thatthisworkaroundhasasecurityimpactthatyouneedtocarefullyconsiderbeforeimplementingit.
ProceduresforaddingserverentriesandGitCentricconfigurationsettingsaredocumentedintheGitCentricOn-lineHelp.
29089--Errorsincatalina.
outlogfileYoumayseeinstancesof"SEVERE"errorsincatalina.
out,relatingto"failuretounregisterJDBCdriver"and"removethreadsonexit".
Theseerrorscanbesafelyignoredinthisrelease.
30954--SomestringswithspecialcharactersrequirequotemarksAknownissuewithGerritrequiresthatyouenclosecertainvaluesingerrit.
configandsecure.
configfilesindoublequotesiftheycontainspecialcharacters,assummarizedinthefollowingtable.
ConfigFileSectionValuegerrit.
config[gerrit]basepath[httpd]listenURL[kando]KANDOHOMEbridgeURLsecure.
config[database]password28GitCentricInstallationandReleaseNotesForexample,ifthepasswordinyoursecure.
configfileismy!
pass#ord,youwouldneedtoencloseitindoublequotes,likethis:password="my!
pass#ord".
Thegerrit.
configandsecure.
configfilesarelocatedin/site/etc.
31660--CodeReviewGitCentricCodeReviewsubmit/mergeoperationsdonotreturnissuesthathavebeenclosedinchangecomments.
34757--ProblemdisplayingonlinehelpinInternetExplorerClickingthehelpbuttondoesnotopentheGitCentriconlinehelpintheseversionsofInternetExplorer:IE9,version9.
0.
8112.
16421IE10,version10.
0.
9200.
16899Forbestresults,usethelatestversionofInternetExplorer.
Toworkaroundthisissue,addthefollowingsectiontogerrit.
config(in/site/etc/):[receive]checkReferencedObjectsAreReachable=falseGerritIssuesSinceGitCentricincorporatesGerritCodeReview,youshouldchecktheGerritCodeReviewissuespageforproblemsthatyoumightencounterwhileusingGerritCodeReviewinGitCentric.