ACS Installation Manual - almamgr/AlmaAcs/OnlineDocs/ACS-Installation-Manual · PDF...

Click here to load reader

  • date post

    04-Jun-2018
  • Category

    Documents

  • view

    223
  • download

    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