Professional Documents
Culture Documents
Rosetta Installation
Version 3.x
CONFIDENTIAL INFORMATION
TheinformationhereinisthepropertyofExLibrisLtd.oritsaffiliatesandanymisuseorabuse
willresultineconomicloss.DONOTCOPYUNLESSYOUHAVEBEENGIVENSPECIFIC
WRITTENAUTHORIZATIONFROMEXLIBRISLTD.
Thisdocumentisprovidedforlimitedandrestrictedpurposesinaccordancewithabinding
contractwithExLibrisLtd.oranaffiliate.Theinformationhereinincludestradesecretsandis
confidential.
DISCLAIMER
Theinformationinthisdocumentwillbesubjecttoperiodicchangeandupdating.Pleaseconfirm
thatyouhavethemostcurrentdocumentation.Therearenowarrantiesofanykind,expressor
implied,providedinthisdocumentation,otherthanthoseexpresslyagreeduponinthe
applicableExLibriscontract.ThisinformationisprovidedASIS.Unlessotherwiseagreed,Ex
Librisshallnotbeliableforanydamagesforuseofthisdocument,including,withoutlimitation,
consequential,punitive,indirectordirectdamages.
Anyreferencesinthisdocumenttothirdpartymaterial(includingthirdpartyWebsites)are
providedforconvenienceonlyanddonotinanymannerserveasanendorsementofthatthird
partymaterialorthoseWebsites.ThethirdpartymaterialsarenotpartofthematerialsforthisEx
LibrisproductandExLibrishasnoliabilityforsuchmaterials.
TRADEMARKS
ExLibris,theExLibrisbridge,Primo,Aleph,Alephino,Voyager,SFX,MetaLib,Verde,
DigiTool,Rosetta,URM,Voyager,ENCompass,EndeavoreZConnect,WebVoyage,Citation
Server,LinkFinderandLinkFinderPlus,andothermarksaretrademarksorregistered
trademarksofExLibrisLtd.oritsaffiliates.
Theabsenceofanameorlogointhislistdoesnotconstituteawaiverofanyandallintellectual
propertyrightsthatExLibrisLtd.oritsaffiliateshaveestablishedinanyofitsproducts,features,
orservicenamesorlogos.
Trademarksofvariousthirdpartyproducts,whichmayincludethefollowing,arereferencedin
thisdocumentation.ExLibrisdoesnotclaimanyrightsinthesetrademarks.Useofthesemarks
doesnotimplyendorsementbyExLibrisofthesethirdpartyproducts,orendorsementbythese
thirdpartiesofExLibrisproducts.
OracleisaregisteredtrademarkofOracleCorporation.
UNIXisaregisteredtrademarkintheUnitedStatesandothercountries,licensedexclusively
throughX/OpenCompanyLtd.
Microsoft,theMicrosoftlogo,MS,MSDOS,MicrosoftPowerPoint,VisualBasic,VisualC++,
Win32,
MicrosoftWindows,theWindowslogo,MicrosoftNotepad,MicrosoftWindowsExplorer,
MicrosoftInternetExplorer,andWindowsNTareregisteredtrademarksandActiveXisa
trademarkoftheMicrosoftCorporationintheUnitedStatesand/orothercountries.
UnicodeandtheUnicodelogoareregisteredtrademarksofUnicode,Inc.
GoogleisaregisteredtrademarkofGoogle,Inc.
CopyrightExLibrisLimited,2012.Allrightsreserved.
Documentreleased:July2012
Webaddress:http://www.exlibrisgroup.com
Table of Contents
Table of Contents 3
Chapter1
Overview .....................................................................................................5
Chapter2
ServerHardwareandSoftwareRequirements ....................................7
ServerRequirements ..................................................................................7
FileSystemandDiskSpace.......................................................................9
BackupandRecoveryMediaandProcedures......................................11
Chapter3
WorkstationHardwareandSoftwareRequirements........................13
StaffPCConfiguration.............................................................................13
Display ...................................................................................................14
Miscellaneous .........................................................................................14
UnicodeFont .............................................................................................15
Chapter4
CommunicationRequirements .............................................................17
NetworkConfiguration ...........................................................................17
ServerAccess.............................................................................................18
LDAPConfiguration ................................................................................18
PortsandActivityTypes .........................................................................19
Chapter5
RequirementsforExLibrisInstallation ..............................................21
ServerAccess.............................................................................................21
RootAccess................................................................................................21
ListofOperationsthatShouldBeAvailableforsudo.........................22
AdditionalRequirements ........................................................................22
Chapter6
July 2012
ResponsibilitiesChecklist .....................................................................23
July 2012
1
Overview
Thisdocumentdescribestherequirementsfortheinstallationanduseof
Rosetta.Beforepurchasingandinstallingthehardwareandoperatingsystem,
youmustreceiveconfirmationfromExLibrisregardingthehardwareand
operatingsystemrequirements.Notethattheserequirementsmaychangeasa
resultofExLibrisdevelopmentneeds.
TorequestaRosettainstallationatyoursite,completetheRequestforRosetta
InstallationformandsendittoyourExLibrisrepresentative.
July 2012
July 2012
2
Server Hardware and Software
Requirements
Thissectionincludes:
ServerRequirementsonpage 7
FileSystemandDiskSpaceonpage 9
BackupandRecoveryMediaandProceduresonpage 11
Server Requirements
InstallRosettaandtheOracledatabaseondedicatedserverswiththe
specificationslistedinthetablebelow.
IMPORTANT:
AlltheRosettaapplicationserversthatyouareusingmustbededicatedto
Rosettaonly.IfyouareusingaseparateOracledatabaseserver,thisserver
maybeshared.
Table 1. Specification Per Server
Specification
Description
Operatingsystem/platform
Linux:RedHatAS/ES5.xand6.064bit
Sun:Solaris10ona64bitx86processor
July 2012
CPUs*
Minimumof8
RAM*
Minimumof16GB
Specification
Description
Mediafordataexchange
FTPandanInternetconnection(see
CommunicationRequirementsonpage 17)
CDROMdrivefordataandsoftware
exchange(incaseFTPistemporarily
unavailable,orifExLibrishasapproved
workwithoutanInternetconnection)
Database**
Oracle64bit
NOTE:
TheinstallationofthedatabaseinOracle
RealClusterconfigurationissupported.
Additionalserversoftware
Cshellpackage(cshortcsh),aspartofthe
operatingsystem
LinuxplatformGCC,aspartofthe
operatingsystem
OracleRDBMSaddonsoftware**
*ConsultwiththeExLibrisSizingManager
**InstalledbyExLibristoensurefullcompatibilitywithRosetta
NOTE:
Ifyouareconfiguringtwoormoreservers,contactyourExLibris
representativetodiscusstheexactproductionserverspecifications
required,includingtherequirednumberofCPUsandRAM.The
productionserverspecificationsaredependentonthedatabasesizeand
thenumberofconcurrentusers.
Fordetailedoperatingsystemrequirements,refertothefollowingdocuments:
OperatingSystemRequirementsforRedHatEnterpriseLinux
OperatingSystemRequirementsfortheSunPlatform
NOTE:
Foreachoftheoperatingsystemversions,ExLibrisrecommendsthatyou
installthelatestoperatingsystemupdatelevel.
July 2012
Software and
Data
Minimum Size *
File System
Server
RosettaandOracle
software
50GB
/exlibris
Allservers
OracleDBsize*
Atleast200GB
/exlibris
Oracleserver
or
/exlibris1,
/exlibris2,
/exlibris3
RAM*
Atleast16GB
Allservers
Swapspace*
Atleast16GB
Allservers
/tmp*
Atleast2GB
Allservers
*ConsultwiththeExLibrisSizingManager
July 2012
WhenRosettaisinstalledonmorethanoneserver,NFSshareddisksare
required.Table 3liststhepartitionsthatmustbemountedoneachserver,as
wellasthemountpointnamesthatmustbeused.
Table 3. Partitions
Use
Minimum Size *
Accessed By
Mount Point
Depositstorage*
Atleast50GB
Depositand
Stagingservers
/deposit_storage
Stagingstorage*
Atleast50GB
Stagingand
Permanent
servers
/operational_storage
Permanentstorage*
Atleast50GB
Permanentand
Stagingservers
/permanent_storage
OperationalShared*
Atleast50GB
AllStaging
servers
/operational_shared
*ConsultwiththeExLibrisSizingManager
NOTE:
Theaboveinformationismeanttoprovidegeneralguidelinesfor
determiningtheminimaldiskspacerequirements.Theexactdiskspace
requiredshouldbedeterminedinconjunctionwithyourExLibris
representative.
Theabovediskspacerequirementsenablesupportofthefollowing:
Reorganizationofthedatabase(aspartoftheperiodicmaintenanceofthe
database)withminimaldowntime
Theabovediskspacerequirementsdonotinclude:
Systemdiskrequirementsforoperatingsystemoverhead
DiskspaceneededforrunningOracleinarchivelogmode(seeBackupand
RecoveryMediaandProceduresonpage 11)
Diskspacerequirementsforbackupatlargesites(seeBackupandRecovery
MediaandProceduresonpage 11)
Anytypeofdataredundancy,suchasRAID1,RAID5orRAID0/1solutions
Rosettaupgraderequirements
NOTE:
ToupgradeduringthepostSTPstage,allocatetwicetheamountofdisk
spacefortheupgradeasyouhaveavailableforthecurrentversionand
database.
10
July 2012
July 2012
11
12
July 2012
3
Workstation Hardware and Software
Requirements
Thissectionincludes:
StaffPCConfigurationonpage 13
UnicodeFontonpage 15
Staff PC Configuration
AllstaffWebbasedworkstationsshouldbeabletoruntheminimumsupported
versionofanapprovedbrowseronaWindowsoperatingsystem.Hardware
July 2012
13
requirementsareminimalandarebasedonlyontheneedtorunthebrowsers
belowinagivenoperatingsystem.
Table 4. Minimum System Requirements
Operating System/
Browser
Requirement
WindowsXP/7/Vista
CPU:PentiumIII,1GHz
Memory:256MB(recommended:512MB)
Disk:10GB
Browserforenduserinterface
InternetExplorer7,8,and9forWindows
Firefox12andlaterforWindows
Safari5forMac
Chrome19
NOTE:
SinceRosettaisbuiltinaccordancewith
industrystandards,itislikelyRosetta
willfunctionwellinbrowsersthatare
absentfromthislist.Qualityassurance
andbugfixesareperformedonlyonthe
listedbrowsers.
Browserforadministrator
interface
InternetExplorer6.xforWindows XP,
IE7andlaterforWindowsVista
Firefox12andlater
NOTE:
SinceRosettaisbuiltinaccordancewithindustrystandards,itislikely
thatitwillfunctionwellinbrowsersthatareabsentfromthislist.
However,qualityassuranceanddefectfixesareperformedonlyonthe
browserslistedabove.
Display
Thephysicaldimensionofthemonitorisnotrelevantfortheactualoperationof
thestaffworkstations.Thecriticalparameterisresolution.
MinimumRecommendedConfiguration:1024x768
Miscellaneous
14
NetworkInterfaceCardwithInternet/LANconnection
TCP/IPinstalledandconnectiontoservertested
July 2012
Telnetorterminalemulatorclient(administratorsmachineonly)
FTP(administratorsmachineonly)
Mouseorrollerball,oranotherpointingdevice
Unicode Font
RosettaworksinUnicode.Werecommendtheinstallationofanappropriate
UnicodefontonboththePCandbrowser.ThechosenUnicodefontshould
includeallcharactersthatyouuse.
NOTE:
IfyouuseaCJKcharacterset,thefontsarequiteheavyandtheloadtime
ofpagesmaybeslow.Therefore,ifyouuseonlyLatincharacters,choosea
LatinUnicodefontforbetterperformance.
July 2012
15
16
July 2012
4
Communication Requirements
Thissectionincludes:
NetworkConfigurationonpage 17
ServerAccessonpage 18
LDAPConfigurationonpage 18
PortsandActivityTypesonpage 19
Network Configuration
Theservermusthaveafullyqualifiedhostname(includeshorthostnameand
domainname)thatisregisteredintheDNS.
Whenperformingadistributedinstallation,allapplicationserversmusthave
DNSentries.
Theservernamemustbedefinedin/etc/hostsasfollows:
Boththefullyqualifiednameandtheshorthostnamemustbelinkedtoa
physicalIPaddress(internal).Inordertomakesurethecorrectnameis
defined,usethefollowingcommands:
grep `eval hostname` /etc/hosts
ThiscommandmustreturnavalidentrywithaphysicalIPaddress.
ForSunOS,enterthefollowingcommandstofindtheinternalIPaddress:
/usr/sbin/ifconfig -a | grep inet | grep -v 127.0.0.1 | awk
'{print $2}'
ForLinux,enterthefollowingcommandstofindtheinternalIPaddress:
/sbin/ifconfig -a | grep addr: | grep -v 127.0.0.1 | awk
'{print $2}'
July 2012
17
Seethefollowingexampleof/etc/hosts configuration:
# Do not remove the following line, or various programs
# that require network functionality will fail.
127.0.0.1
localhost.localdomain
localhost
10.1.222.22
ml-inst.corp.metalib.com
ml-inst
Thefirstactivelineshouldbeconfiguredexactlyasshownintheabove
example.
ThesecondlineshouldcontaintheinternalIPaddress,followedbythefully
qualifiedname(hostname+domainname),theshortname,andanypossible
aliases.
Server Access
ExLibrisaccesstothesystemviatheInternetisrequired,withaminimum
bandwidthof64KBp.
ExLibrisstaffwillrequireaccesstothefollowing:
theRosettaserverfortheinstallationoftheRosettasoftware,setup,
support,andtroubleshootingduringtheimplementationandmaintenance
phases
Ifafirewallisinstalled,accessmustbeenabledforExLibrisSupportand
ImplementationstaffviatheExLibrisgatewayIPaddress,212.179.71.70.
Inaddition,whererelevant,accessmustbeenabledforIPaddressesofthe
localExLibrisofficeordistributor(fordetails,refertoyourlocalExLibris
representativeordistributor).
Atthepostinstallationstage,itisrecommendedthatyoupermitaccessto
http://exlibrispublic.exlibrisgroup.com/inordertobeabletoaccessthe
servicepackreleaseviatheHelpmenuintheRosettaapplication.
LDAP Configuration
ForinformationonLDAPconfiguration,refertotheRosettaLoadBalancer
Requirementsdocument.
18
July 2012
Port
Server
Access
1521(TCP/IP)
Oracle
Deposit,Staging,andPermanentservers;
ExLibrisSupport(jdbc)
1801(HTTP)
Deposit
Internet
1801(HTTP)
Staging
Internet(fordeliveryofobjectstothe
enduser);ExLibrisSupport
8991(HTTP)
Deposit(PDS
Port)
Internet;DepositandStagingservers
x801withxin[2..9]
Deposit
Stagingserver;ExLibrisSupport,for
JavaRMIcommunications
x801withxin[2..9]
Staging
DepositandPermanentservers;Ex
LibrisSupport,forJavaRMI
communications
x801withxin[2..9]
Permanent
Stagingserver;ExLibrisSupport,for
JavaRMIcommunications
5001(HTTP)
Deposit,Staging,
Permanent
ExLibrisSupport,forremoteJava
debugging
80(outgoingHTTP)
Staging
Tohttp://www.exlibris
public.exlibrisgroup.com,foraccessto
releasenotesandupdates
21
Deposit,Staging,
Permanent,
Oracle
FTPconnectionfromExLibrisSupport
OutgoingaccesstoFTPserver:
ftp.exlibris.co.il
22
Deposit,Staging,
Permanent,
Oracle
SSHconnectionfromExLibrisSupport
25(outgoing)
Deposit,Staging
SMTPoutgoingmail(themaildaemon
mustbeinstalledandtested)
NOTE:
UseofotherportsmustbecoordinatedwithExLibris.
July 2012
19
IfyouhaveanadditionalversionofRosetta(fortestingortrainingpurposes)on
yourserver,openadditionalHTTPportsusingthe<copynumber>inplaceof
thelastdigit(number1).Forexample,ifyouhaveoneadditionalversion(copy
2),useportnumbers1802,8992,5002,and2802,3802,4802,5802,6802,7802,
8802,9802.
20
July 2012
5
Requirements for Ex Libris Installation
Thissectionincludes:
ServerAccessonpage 21
RootAccessonpage 21
ListofOperationsthatShouldBeAvailableforsudoonpage 22
AdditionalRequirementsonpage 22
Server Access
Inordertologontotheserver,aninitialexlibrisuserwithpermissiontosu
orsudoisrequired.Thisusercanbedeletedaftertheinstallationiscomplete.
Root Access
ExLibrisstaffrequirearootpasswordto:
July 2012
createthefollowingusers:
dpswithagroupIDofexlibris
oraclewithagroupIDofdba.
enabletheuserslistedabovetocreatedirectoriesandfilesunderthefile
systems/exlibris, /exlibris1, /exlibris2,andsoforth
installRosettaandtheadditionalsoftwaredetailedinServerRequirements
onpage 7
addtheautomaticactivationofRosettaserversandOracletothemachines
bootprocess
reboottheservertoactivatenewvaluesofsystemparametersthatwere
modifiedduringtheinstallationprocess,andtotesttheautomaticactivation
ofRosettaandOracle.Therebootwillbecoordinatedwithyou.
21
Createthefollowingusersandgroups:
useradd
groupadd
vipw
Changethefollowingsystemparameters:
forSunSolarisservers/etc/systemfile
forLinux/etc/rc.d/rc.localand/etc/security/limits.conf
files
Createdirectoriesandchangepermissionsusingthefollowing:
mkdir
chown
Inthe/etcdirectory,createfilesnecessaryfortheautostartupmechanism.
Additional Requirements
22
cshmustbeavailable.ExLibrisproductsandtheuserslistedinthe
previoussectionsworkundercsh.
Thesystemmanagermustbeavailablethroughouttheinstallation.IfOracle
isalreadyinstalled,theDBAmustalsobepresentduringinstallation.
Thesystemmanagermustdefineanaliasforthehostnamein/etc/hosts.
July 2012
6
Responsibilities Checklist
Thefollowingtablesummarizestherequirementsdescribedinthisdocument.
Table 6. Responsibilities Checklist
Details
Purchase and
Installation
Responsibility
ServerHardwareandSoftware
page 7
ServerandOS
Customer
page 7
Diskspace
Customer
page 9
Mediafordataexchange
Customer
page 8
Additionalsoftware
Customer
ExLibris
page 8
Backupandrecoverymedia
Customer
page 11
Oracle
ExLibris
WorkstationHardwareandSoftware
page 13
StaffPCandOS
Customer
page 13
Browsers
Customer
page 14
Unicodefonts
Customer
page 15
CommunicationRequirements
Openports
July 2012
Page
page 17
Customer
page 19
23
24
July 2012