ACS Installation Manual - almamgr/AlmaAcs/OnlineDocs/ACS-Installation-Manual · PDF...
date post
04-Jun-2018Category
Documents
view
223download
0
Embed Size (px)
Transcript of ACS Installation Manual - almamgr/AlmaAcs/OnlineDocs/ACS-Installation-Manual · PDF...
AtacamaLargeMillimeterArray
ALMANNNNN
Issue:3.1
20050310
ACSInstallationManual
G.CHIOZZI
Approvedby: Date: Signature:
ALMACommonSoftware
InstallationManual
GianlucaCHIOZZIPaolaSIVERAGiorgioFILIPPI
EuropeanSouthernObservatory
Keywords:ALMA,ACS,Installation,softwareOwner G.CHIOZZI([email protected])
ALMA ACSInstallationManual
ChangeRecordREVISION DATE AUTHOR SECTION/PAGE
AFFECTEDREMARKS
0.0/Prep.1 20000811 G.CHIOZZI All FirstrevisionforCDdistributedtoA.PerrigouardandR.Heald.
0.0/Prep.2 20000821 G.CHIOZZI All UpdatedafterinstallationfromA.PerrigouardandconvertedfromASCIItexttoHTML
0.0/Prep.3 20000913 G.CHIOZZI All Updatedvltroot,includedMACIinCoCoS,firstexampleofmodulartest.
0.0/Prep.4 20000919 G.CHIOZZI All Javaintegratedin$VLTROOT.NotanymoreaseparatepackageFixedminorproblemsin$VLTDATA.Newvltdata.tar.gz
0.0 20001018 G.CHIOZZI All ACSRelease0.0
0.1/Prep.1 20001208
20010116
G.CHIOZZI
G.CHIOZZI
3.1
3.5
NoteaboutRedHatLinux6.2.AddedsomenotesinVisualAgeinstallation
1.0/Prep.1 20010926 P.SIVERA
G.CHIOZZI
Alll ACSRelease1.0
1.0 20011004 P.SIVERA 3.1 AddedSUNkernelconfiguration
1.0Rev.1 20011008 P.SiveraG.Chiozzi
All AddedUpgradenotes.
Issue:4.0.2 Page2of19
ALMA ACSInstallationManual
Addeddescriptionofenvironmentvariables.Addedsubissuerevisionnumber.
1.0Rev.2 20011010 P.Sivera Section4.4All
ExtendedMinorchangesafterfeedbackfromtestinstallations
1.0Rev.3 20011023 G.Chiozzi Firstpage
Sections8
Newsection9
AdvancedCommonSoftwarereplacedwithALMACommonSoftware.MovedVAJinstallationafterINTROOTsetupAddedconfigurationofuseraccount
1.1 20010416 P.Sivera PortedtoACS1.1
1.1Rev.1 20020628 G.Chiozzi AppliedcommentsafterfirstsetofACS1.1installations.AddedcheckofLinuxNetworkconfiguration.
InstallationofVAJandABeansextendedandaddedpatchinstallationforabeans1.28
1.1Rev.2 20020711 G.Chiozzi UpdatedforacsBUILD1.79.
VAJinstallationimproved(abeans1.30).
Issue:4.0.2 Page3of19
ALMA ACSInstallationManual
1.1Rev.3 Addednoteaboutreplaced/etc/syslog.confand/var/spool/cron/crontabs/almamgr
2.0 20021216 P.Sivera UpdatedforACS2.0
2.0.1 20030207 P.Sivera ChangedACSSWSourcestoACS
2.1 20030604 P.Sivera UpdatedforACS2.1
2.1.1 20030611 D.Fugate Fixedgrammarproblemsandremoveddeprecatedsections.
3.0.0 20031115 G.Chiozzi UpdatedforACS3.0.0
3.1 20040507 P.Sivera UpdatedforACS3.1
4.0 20050310 J.Ibsen UpdatedforACS4.0
TableofContents
1Summary....................................................................................................................................6
2Introduction................................................................................................................................6
2.1Scope........................................................................................................................................62.2Preparingforinstallation...........................................................................................................62.3Installationprocedures.............................................................................................................62.4Glossary....................................................................................................................................72.5References................................................................................................................................7
3UpgradefromapreviousACSinstallation................................................................................8
4Basicinstallationandtools........................................................................................................8
4.1InstallRedHatLinux9orSunSolaris2.8................................................................................84.2LoadtheACSRelease4.0CDROM......................................................................................104.3ACSInstallation......................................................................................................................11
Issue:4.0.2 Page4of19
ALMA ACSInstallationManual
5BuildtheACSlibraries............................................................................................................13
6Testthesoftware......................................................................................................................15
6.1Quicktest................................................................................................................................156.2Completetest..........................................................................................................................15
7SetuptheINTROOTfordevelopment......................................................................................16
8ConfigureauseraccountforACS...........................................................................................17
8.1Createtheaccount..................................................................................................................178.2Configuretheenvironment......................................................................................................178.3ConfiguretheINTROOTfortheuser......................................................................................178.4cvsconfiguration.....................................................................................................................17
AppendixI.EnvironmentVariables............................................................................................19
AppendixII.Verificationlogs......................................................................................................19
Issue:4.0.2 Page5of19
ALMA ACSInstallationManual
1 Summary
ThisistheInstallationManualfortheALMACommonSoftware(ACS)release4.0linuxandSUNOSmachines.
ThisdocumentassumesthatyouhaveanoverviewofACS(seealsoACSOverview2.5andALMACommonSoftwareReleaseNotesError:Referencesourcenotfound),UNIXknowhow,andsomeexperienceininstallingpublicdomainsoftware.Unlessyouarethesystemadministrator,youmayneedhis/herhelptoperformsomeoftheinstallationsteps.
2 Introduction
2.1 ScopeThismanualcoverstheinstallationofACSRelease4.0foraLinuxPC(Redhat9istheofficialLinuxversion,butACS4.0worksonRH7.2and7.3)andaSolarisworkstation(Solaris8)andisdistributedtogetherwithaCDcontainingallinvolvedsoftware.
TheinstallationonSUNincludesallsoftwarerelatedtoVxWorksneededforLCUconfiguration;thisisleftforbackwardcompatibility.
StartingwithACS4.0,onLinuxRH9theRTAIinstallationisalsoprovided.
2.2 PreparingforinstallationEvenifyouhaveinstalledACSmanytimes,wesuggestthatbeforestartinganewinstallationorupgradeyoualwaysprintthelatestversionofthismanual(fromError:Referencesourcenotfound)andreaditcarefully.
Duringtheinstallation,keeptheprintedcopyonyoursideanduseitasalogbook,checkingwithapenallstepsonebyonewhileyoucompletethemandnotingdownonthesideanystrangeorunexpectedresults.
Itisagoodpracticetodatethecoverofeachinstallationmanualandkeepitinafolderforlaterreference.
HelpandinformationonproblemscanbefoundintheACSFrequentlyAskedQuestions2.5.
2.3 InstallationproceduresWesupplytwoprocedurestoinstallACS:0_InstallACSforRedHatLinux9and0_InstallACS.SunforSolaris8.TheLinuxprocedureismoreflexible,youwillbeableto
Issue:4.0.2 Page6of19
ALMA ACSInstallationManual
choosethetoolsyouwanttoinstallamongtheonesprovidedwiththeCD.Youcanalsochangethedefaultlocation(/alma/ACS4.0)fortheinstallation.Inthiscaseyoucannotinstallthegnuandtcltktoolsfromourdistribution(theyneedtobeinstalledunderthedefaultlocationbecauseofhardcodedpathsinthebinaries)andyouhavetorelyonyourowninstallationofgnutoolsandtcl/tk.Theversionsshouldmatchwiththeonesofficiallyprovided.OnSun,westronglyrecommendinstallingeverything(allthetoolsfromourdistribution)under/alma/ACS4.0.
Forbothinstallationprocedures,thedefaultuserisalmamgrbutotheruserscanalsobechosentoperformtheinstallation.
OnLinuxRH9itispossibletoinstallAIPS++.Youneedtoberoottoperformthisinstallationand~650MBofspaceunder/usr.
Anotherimportantpointconcernsthesetofenvironmentvariables:tolettheinstallationuserpreservehisorherownenvironmentweprovideasimplefile,.bash_profile.acs,whichcontainsallthenecessaryenvironmentvariablestorunACS.ItisuptotheusertosourcethisfilebeforeworkingwithACS.Notethatthefileassumesthatyouareusingbashasthedefaultshell.
Thefilebelongstoadirectory,.acs,whichcontainssomeothersettingsforemacs.Thisdirectorygetsinstalledunderthehomedirectoryoftheuserwhoperformstheinstallation.WhentheACSlibrariesarebuilt(see5),acopyofthedirectoryisalsoinstalledunder/alma/ACS4.0/ACSSW/configinordertoletotheruserswhowanttoworkwithACSontheinstalledmachineaccessthesameenvironmentvariables.
2.4 Glossaryhttp://www.alma.nrao.edu/development/computing/docs/joint/draft/Glossary.htm
2.5 References[1] ACSwebpages:http://www.eso.org/~almamgr/AlmaAcs/index.html
[2] ACSOverview:http://www.eso.org/~gchiozzi/AlmaAcs/OnlineDocs/ACSOverview.pdf
[3] ACSReleaseNotes:http://almasw.hq.eso.org/almasw/bin/view/ACS/ReleaseNotes
[4] ACSInstallationManual:(thismanual):http://www.eso.org/~gchiozzi/AlmaAcs/OnlineDocs/ACSInstallationManual.pdf
[5] ACSFrequentlyAskedQuestionshttp://almasw.hq.eso.org/almasw/bin/view/ACS/AcsFAQ
Issue:4.0.2 Page7of19
http://almasw.hq.eso.org/almasw/bin/view/ACS/AcsFAQhttp://www.eso.org/~gchiozzi/AlmaAcs/OnlineDocs/ACS-Installation-Manual.pdfhttp://www.eso.org/~gchiozzi/AlmaAcs/OnlineDocs/ACS-Installation-Manual.pdfhttp://almasw.hq.eso.org/almasw/bin/view/ACS
