Installatin and User Guide - English FUJITSU Sftware ServerView Suite ServerView Update Repsitry Editin Nvember 2015
Cmments Suggestins Crrectins The User Dcumentatin Department wuld like t knw yur pinin f this manual. Yur feedback helps us ptimize ur dcumentatin t suit yur individual needs. Feel free t send us yur cmments by e-mail t manuals@ts.fujitsu.cm. Certified dcumentatin accrding t DIN EN ISO 9001:2008 T ensure a cnsistently high quality standard and user-friendliness, this dcumentatin was created t meet the regulatins f a quality management system which cmplies with the requirements f the standard DIN EN ISO 9001:2008. cgnitas. Gesellschaft für Technik-Dkumentatin mbh www.cgnitas.de Cpyright and trademarks Cpyright 1998-2015 Fujitsu Technlgy Slutins. All rights reserved. Delivery subject t availability; right f technical mdificatins reserved. All hardware and sftware names used are trademarks f their respective manufacturers.
Cntents 1 Intrductin 5 1.1 Changes since the previus versin 6 1.2 ServerView Suite link cllectin 7 1.3 Dcumentatin fr the ServerView Suite 8 1.4 Typgraphic cnventins 9 2 Installing / uninstalling the Repsitry Server 11 2.1 Requirements fr installatin (Linux) 11 2.2 Installing the Repsitry Server 12 2.3 Uninstalling the Repsitry Server 13 3 Cnfiguring the Repsitry Server and updating its functinality 15 3.1 Cnfiguring the Repsitry Server 15 3.2 Updating the Repsitry Server 19 4 Wrking with the Repsitry Server 21 4.1 Running the Repsitry Server 21 4.2 Files needed fr analyzing 22 4.3 Implementatin issues 23 5 Using the Repsitry Server - scenaris 25 5.1 elcm nline/ffline update via the irmc S4 web interface 25 5.2 ServerView System Mnitr (n lcal nde) 26 5.3 ServerView Operatins Manager - Update Management 27 ServerView Update Repsitry 3
4 ServerView Update Repsitry
1 Intrductin The ServerView Repsitry Server package, in the fllwing referred t as Repsitry Server fr shrt, prvides a web server which cntains the firmware repsitry fr PRIMERGY servers and runs in yur cmpany's intranet. The repsitry server perfrms the fllwing tasks: The Repsitry Server keeps the firmware repsitry up-t-date by regularly dwnlading the mst recent updates frm the Fujitsu Webserver (https://supprt.ts.fujitsu.cm). Administratrs may receive email messages infrming n the dwnlad prgress and errr situatins. The Repsitry Server enables the managed servers in yur intranet t access this regularly updated firmware repsitry withut leaving the intranet.the (virtual) machine installed by the Repsitry Server sftware serves as a prxy server fr thse mnitred managed ndes which d nt have a cnnectin t the internet. The dwnlad prcess which uses the Repsitry Server fr keeping up the update repsitry is cmpletely independent frm updating the managed ndes. The managed ndes cnnect t the Repsitry Server t receive the necessary updates fr their firmware cmpnents. As an alternative t dwnlading the updates directly frm the Fujitsu Web Server, the Repsitry Server therefre allws yu t maintain a repsitry f firmware cmpnents in a decentralized way. ServerView Update Repsitry 5
1 Intrductin Figure 1: Repsitry Server The Repsitry Server can als be used t prvide the repsitry fr the update management tls f the Fujitsu Sftware ServerView Suite, e.g. ServerView embedded Lifecycle Management (elcm), ServerView System Mnitr, and ServerView Update Manager. In case f the ServerView Update Manager, the Management Statin plays the rle f a Managed Nde (see the figure abve). 1.1 Changes since the previus versin This editin f the manual "ServerView Update Repsitry" replaces the nline manual "ServerView Update Repsitry", editin May 2015. The manual features the fllwing changes and enhancements: Supprt f new Linux perating systems RHEL 6.5 (32-bit/64-bit system) RHEL 6.6 (32-bit/64-bit system) RHEL 7.0 (64-bit system) 6 ServerView Update Repsitry
1.2 ServerView Suite link cllectin 1.2 ServerView Suite link cllectin Via the ServerView Suite link cllectin, Fujitsu Technlgy Slutins prvides yu with numerus dwnlads and further infrmatin n the ServerView Suite and PRIMERGY servers. Fr ServerView Suite, links are ffered n the fllwing tpics: Frum Service Desk Manuals Prduct infrmatin Security infrmatin Sftware dwnlads Training The dwnlads include the fllwing: Current sftware statuses fr the ServerView Suite as well as additinal Readme files. Infrmatin files and update sets fr system sftware cmpnents (BIOS, firmware, drivers, ServerView agents and ServerView update agents) fr updating the PRIMERGY servers via ServerView Update Manager r fr lcally updating individual servers via ServerView Update Manager Express. The current versins f all dcumentatin n the ServerView Suite. Yu can retrieve the dwnlads free f charge frm the Fujitsu Technlgy Slutins Web server. Fr PRIMERGY servers, links are ffered n the fllwing tpics: Service Desk Manuals Prduct infrmatin Spare parts catalgue ServerView Update Repsitry 7
1 Intrductin Access t the ServerView Suite link cllectin Yu can reach the link cllectin f the ServerView Suite in varius ways: 1. Via ServerView Operatins Manager. Select Help Links n the start page r n the menu bar. This pens the start page f the ServerView Suite link cllectin. 2. Via the start page f the nline dcumentatin fr the ServerView Suite n the Fujitsu Technlgy Slutins manual server. Yu access the start page f the nline dcumentatin via the fllwing link: http://manuals.ts.fujitsu.cm In the selectin list n the left, select x86 Servers. On the right, click PRIMERGY ServerView Links under Selected dcuments. This pens the start page f the ServerView Suite link cllectin. 3. Via the ServerView Suite DVD 2. In the start windw f the ServerView Suite DVD 2, select the ptin ServerView Sftware Prducts. On the menu bar select Links. This pens the start page f the ServerView Suite link cllectin. 1.3 Dcumentatin fr the ServerView Suite The dcumentatin can be dwnladed free f charge frm the Internet. Yu will find the nline dcumentatin at http://manuals.ts.fujitsu.cm under the link x86 Servers. Fr an verview f the dcumentatin t be fund under ServerView Suite as well as the filing structure, see the ServerView Suite sitemap (ServerView Suite Site Overview). 8 ServerView Update Repsitry
1.4 Typgraphic cnventins 1.4 Typgraphic cnventins The fllwing typgraphic cnventins are used in this manual: Cnventin Explanatin Indicates varius types f risk, namely health risks, risk f data lss and risk f damage t devices. Indicates additinal relevant infrmatin and tips. bld mnspace mnspace semibld blue cntinuus text pink cntinuus text <abc> [abc] [key] Indicates references t names f interface elements. Indicates system utput and system elements fr example, file names and paths. Indicates statements that are t be entered using the keybard. Indicates a link t a related tpic. Indicates a link t a lcatin yu have already visited. Indicates variables which must be replaced with real values. Indicates ptins that can be specified (syntax). Indicates a key n yur keybard. If yu need t enter text in uppercase, the Shift key is specified, fr example,[shift] + [A] fr A. If yu need t press tw keys at the same time, this is indicated by a plus sign between the tw key symbls. Screenshts Sme f the screenshts are system-dependent, s sme f the details shwn may differ frm yur system. There may als be system-specific differences in menu ptins and cmmands. ServerView Update Repsitry 9
10 ServerView Update Repsitry
2.1 Requirements fr installatin (Linux) 2 Installing / uninstalling the Repsitry Server The Repsitry Server is nt available n Windws systems. 2.1 Requirements fr installatin (Linux) This sftware is tested and released fr fllwing Linux perating systems. RHEL 6.3 (32-bit/64-bit system) RHEL 6.5 (32-bit/64-bit system) RHEL 6.6 (32-bit/64-bit system) RHEL 7.0 (64-bit system) It is recmmended t use a separate virtual machine fr the installatin. Make sure the /bin/bash directry can be fund. User must be rt. The fllwing libraries are necessary fr the dwnlad: libssl libcrypt libcurl Apprpriate links t the necessary versins f these libraries are set in the /usr/lib directry (fr 32-bit system) r /usr/lib64 directry (fr 64-bit system) f user rt. libstdc++.s.5 (package cmpat-libstdc++-33-3.2.3-69.el6.i686 must be installed) The RPM packages t be installed are: sendmail-8.14.4-8.el6.i686 (n 32-bit system) r sendmail-8.14.4-8.el6.x86_64 (n 64-bit system) httpd-2.2.15-15.el6_2.1.i686 (n 32-bit system) r httpd-2.2.15-29.el6_4.x86_64 (n 64-bit system) ServerView Update Repsitry 11
2 Installing / uninstalling the Repsitry Server Please install current versins f Sendmail and Apache Web Server if nt yet present. Several GB f disk space is required t stre the updates. All requirements are checked by the preinstall script. 2.2 Installing the Repsitry Server Start the installatin f the Repsitry Server with the fllwing cmmand: rpm -i RepServer-<versin>.i686.rpm (n 32-bit system) rpm -i RepServer-<versin>.x86_64.rpm (n 64-bit system) By installing the RPM package, the current Linux system becmes a Repsitry Server. A new directry /pt/fujitsu/serverviewsuite/repserver directry is created during the installatin prcess. It cntains all the executable files and the cnfiguratin files needed fr the Repsitry Server. After the installatin prcess, the fllwing cnfiguratin changes are made by the pstinstall script: The rsyslg system lgging interface is extended by a new subdirectry fr lgfiles: /var/lg/fujitsu/serverviewsuite/repserver An entry is made t the /etc/rsyslg.cnf file in rder t redirect the lg entries f the facility lcal0 t the repserver.lg file. The rsyslg system lgging is restarted t make changes effective. Cnfiguratin changes fr Apache Web Server in the /etc/httpd/cnf/httpd.cnf file. The first crn jb is created and makes the fllwing entry in crntab f user rt: 00 <installatin hur + 2> * * 0-6 /pt/fujitsu/ ServerViewSuite/RepServer/bin/dwnladApplicatin.sh -t # $TAG. 12 ServerView Update Repsitry
2.3 Uninstalling the Repsitry Server The first dwnlad is scheduled t start at the earliest ne hur after installatin and is repeated every day at the same time. The first dwnlad may take mre than 2 hurs as the cmplete repsitry is laded. Subsequent dwnlads nly take an average f 5 minutes as nly new and changed versins are laded. The required disk space fr the lcal repsitry in the $RtRepPath directry is 20 GB. ($RtRepPath is defined in the cnfiguratin file, see belw.) 2.3 Uninstalling the Repsitry Server The Repsitry Server functinality is uninstalled by remving the RPM package. The current firmware repsitry remains unchanged during remve f the package. Please remve the repsitry manually if its bslete. A reinstall f the Repsitry Server will restre the link frm the Apache web page t the frmer repsitry when it is left untuched! Thus an update installatin will renew the tls but it will update and prvide the repsitry already present. ServerView Update Repsitry 13
14 ServerView Update Repsitry
3.1 Cnfiguring the Repsitry Server 3 Cnfiguring the Repsitry Server and updating its functinality After the installatin prcess is cmpleted, yu need t check the installatin and t mdify the cnfiguratin values in the /pt/fujitsu/serverviewsuite/repserver/cfg/repserver.cnf cnfiguratin file t yur needs. If a newer Repsitry Server versin is available, yu can update yur update repsitry's functinality withut any impact n the current firmware repsitry and the current Repsitry Server cnfiguratin. 3.1 Cnfiguring the Repsitry Server After the installatin prcess is cmpleted, yu need t check the installatin and t mdify the cnfiguratin values in the /pt/fujitsu/serverviewsuite/repserver/cfg/repserver.cnf cnfiguratin file t yur needs. The cnfiguratin file /pt/fujitsu/serverviewsuite/repserver/cfg/repserver.cnf cnsists f tw parts: The first sectin cntains thse parameters whse values yu can change by yur wn. The secnd sectin cntains internal parameters whse values shuld nly be mdified by an expert user. Yu can adjust the fllwing parameters t yur needs (see als the explanatry ntes in the cnfiguratin file): The Prxy settings fr the dwnlad frm the Fujitsu Dwnlad Server. The RtRepPath destinatin lcatin fr dwnlading. The LinkMde parameter fr the dwnlad prcess, which allws yu t set up the repsitry in a wrk directry. If LinkMde=0, a wrking directry is used fr setting up the repsitry. This requires an additinal strage space f mre than 20 GB. At the end f the dwnlad prcess, the repsitry is switched t its ServerView Update Repsitry 15
3 Cnfiguring the Repsitry Server and updating its functinality destinatin lcatin. Advantage: Required disk space is lwer than in case f LinkMde=1. If LinkMde=1, n wrking directry is used. Disadvantage: Repsitry lck is set fr a lng time. Advantage: Disk space needed is lwer than in case LinkMde=0. LcalRepPath pints t the directry where the inf files frm the rt f the Fujitsu repsitry (e.g. versintree.txt) are stred after dwnlading. ExchangeRepPath is the lcatin where the parameter tree (Gf_par_ tree.exe) dwnladed frm Fujitsu server is extracted. PrvisiningRepPath If LinkMde=0, PrvisiningRepPath pints t the lcal repsitry that can be accessed frm ServerView Operatins Manager r frm anther client. If LinkMde=1, PrvisiningRepPath tggles between pinting t the publicly accessible repsitry and pinting t the repsitry the next dwnlad wrks n PrvisiningAlternateRepPath (nt used if LinkMde=0.) PrvisiningAlternateRepPath tggles between pinting t the publicly accessible repsitry and pinting t the wrking directry. The CrnJb entry in crntab. The Email and SMTP parameter settings. It is recmmended t add the SMTP server address and Email recipients in rder t get email messages abut the dwnlad prgress. Values in the expert sectin f the cnfiguratin file shuld be left unchanged t avid damage (e.g. the mdificatin f RtFujitsuRepServer may cause that the firmware dwnlad will be initialized!). Yu may als mdify the crn jb in the crntab f rt. But this takes nly effect fr the next start f the dwnlad applicatin. T make permanent changes fr the crn jb, the CrnJb parameter in the cnfiguratin file must be mdified accrdingly. The reasn is, the dwnlad applicatin will always restre the crntab entry frm the cnfiguratin file upn its next activatin. 16 ServerView Update Repsitry
3.1 Cnfiguring the Repsitry Server The cnfiguratin file is interpreted every time the dwnlad applicatin is activated manually r by the crnjb scheduler. Example: RepServer.cnf cnfiguratin file An example f a RepServer.cnf cnfiguratin file is shwn belw. ######################################################################## ## # (c) Cpyright 2013 Fujitsu Technlgy Slutins. All Rights Reserved. # # # # Cnfiguratin file fr Repsitry Server # # # # It will be read every time the Repsitry Server applicatin # # 'dwnladapplicatin' is started. # # # ######################################################################## ## # Prxy settings fr dwnlading frm FTS server... PrxyServerMde=1 # flag indicating use f prxy server (0=n; 1=as defined here; 2=as predefined fr Linux) PrxyServer="prxy.pdb.fsc.net" # IP address r name f prxy server t be used fr update f repsitry PrxyServerPrt=81 PrxyServerUserid="" # userid fr prxy server PrxyServerPasswd="" # Destinatin lcatin fr dwnlading... RtRepPath="/Disk2/Repsitry" # Parameter hw t prvide repsitry... LinkMde=0 # Entry in crntab... # prt f prxy server t be used fr update f repsitry # encrypted passwrd fr accessing prxy server # abslute path t base directry f lcal repsitry # replace/switch accessible repsitry by link: 0=n; 1=yes CrnJb="45 15 * * 0-6 /pt/fujitsu/serverviewsuite/repserver/bin/dwnladapplicatin.sh -t # $TAG" # Crn Jb: min hur day mnth day_f_week cmmand # Syntax -> <minutes> <hurs> <days> <mnth> <week day>... ServerView Update Repsitry 17
3 Cnfiguring the Repsitry Server and updating its functinality # Emailing ptins... EmailMde=2 # 0=n emails; 1=restricted t errrs nly; 2=all messages EmailSender="Repserver@172.17.167.63" # email address f sender (if empty, use f default: "repsitry.server@$hostname") # Nte: EmailSender must cmply with the fllwing frmat: "xxx@yyy.zzz" # Take care that $HOSTNAME returns the full qualified name. EmailRecipient[0]="jack.miller@firm.cm" # email address f recipient, e.g. "Je.Baker@Lndn.cm" #EmailRecipient[1]="" # email address f anther recipient (the first empty EmailRecipient terminates the list) SMTPHst="172.25.138.142" # IP address r name f SMTP server SMTPPrt= # SMTP prt (if empty, use f default: 25) SMTPAuthUser="" SMTPAuthPasswrd="" ######################################################################### # ATTENTION: Fllwing parameters shuld nly be changed by expert... # PKG=RepServer RtFujitsuRepServer="/pt/fujitsu/ServerViewSuite/$PKG" ApacheCnf="/etc/httpd/cnf/httpd.cnf" # cnfig file f web server # FTS dwnlad server access... DwnladServer="supprt.ts.fujitsu.cm" # address r name f Dwnlad Server DwnladRepPath="DwnladManager/Glbalflash" # relative path f dwnlad repsitry n FTS Dwnlad Server # Lcatins... LcalRepPath="$RtRepPath/Dwnlad" # abslute path t rt f currently dwnladed repsitry catalg ExchangeRepPath="$RtRepPath/Exchange" # abslute path t rt f exchange repsitry PrvisiningRepPath="$RtRepPath/Prvisining" # abslute path t rt f prvisining repsitry PrvisiningAlternateRepPath="$RtRepPath/PrvisiningAlternate" 18 ServerView Update Repsitry
3.2 Updating the Repsitry Server # abslute path t rt f alternate prvisining repsitry Lgfile="$RtRepPath/dwnladApplicatin.lg" # path t lgging f dwnlad prgress # Parameters used internally fr dwnlad tasks... StpTxt="$RtFujitsuRepServer/cfg/Stp.txt" # lck file within repsitry StpDwnladRetry=100 # number f retries fr dwnlad f Stp.txt StpDwnladWaitTime=180 # number f secnds t wait fr Stp.txt t vanish DwnladRetry=3 # number f retries fr dwnlading a file frm FTS repsitry DwnladWaitTime=10 # number f secnds t wait fr next retry f a file dwnlad DwngradeMde=1 # hw t handle dwngrades (0=n dwngrade; 1=dwngrade) 3.2 Updating the Repsitry Server The Repsitry Server functinality is updated with the fllwing cmmand. rpm -U RepServer-<versin>.i686.rpm (n 32-bit system) rpm -U RepServer-<versin>.x86_64.rpm (n 64-bit system) The current firmware repsitry and the frmer Repsitry Server cnfiguratin remain unchanged during the update. It is nt pssible t update frm 32-bit versin t 64-bit versin. Please uninstall 32-bit versin and install 64-bit versin f Repsitry Server. ServerView Update Repsitry 19
20 ServerView Update Repsitry
4.1 Running the Repsitry Server 4 Wrking with the Repsitry Server 4.1 Running the Repsitry Server The Repsitry Server des nt have a graphical user interface. It is started peridically as a crn jb by the Crntab Scheduler. It can als be started manually frm the cnsle windw using the cmmand line interface: dwnladapplicatin [-t] [-i] -t -i Trace flag n Interactive flag n dwnladapplicatin -h displays the usage message. The crn jb can be called fr example as fllws: /usr/bin/dwnladapplicatin.sh -t After crrect installatin, the Repsitry Server des nt need any mnitring r maintenance. Any administrative actins shall be dne via the RepServer.cnf cnfiguratin file and the Linux perating system. ServerView Update Repsitry 21
4 Wrking with the Repsitry Server 4.2 Files needed fr analyzing The fllwing files are needed fr analysis purpses: /pt/fujitsu/serverviewsuite/repserver/cfg/repserver.cnf (Repsitry Server cnfiguratin file) /var/lg/fujitsu/serverviewsuite/repserver/repserver.lg (if cnfigured in rsyslg cnfiguratin file /etc/rsyslg.cnf). Trace files dwnladapplicatin.lg<id> and FileDwnlad.lg<id> in the directry specified by $RtRepPath.The $RtRepPath variable set in the /pt/fujitsu/serverviewsuite/repserver/cfg/repserver.cnf cnfiguratin file. T accmplish that the trace files dwnladapplicatin.lg<id> and FileDwnlad.lg<id> are created, prceed as fllws: 1. Start the crntab editr frm a terminal windw: crntab -e 2. Edit the crntab entry f dwnladapplicatiby adding the trace ptin -t: /pt/fujitsu/serverviewsuite/repserver/bin/dwnlad Applicatin.sh -t Trace files will be created as described abve the next time this crn jb is started. 22 ServerView Update Repsitry
4.3 Implementatin issues 4.3 Implementatin issues The shell script dwnladapplicatin.sh uses the (internal) FileDwnlad prgram fr dwnlading a single file frm the Fujitsu web server: https://supprt.ts.fujitsu.cm/dwnladmanager/glbalflash/ The shell script dwnladapplicatin.sh evaluates its cnfiguratin file t determine which update cmpnents are t be dwnladed (variable DwnladVariant) t the lcal repsitry (variable RtRepPath). Currently, "cmplete" is the nly value allwed fr the variable DwnladVariant. The shell script dwnladapplicatin.sh thereby prceeds as fllws: 1. The script evaluates the versintree.txt file, whether a dwnlad is necessary. If this applies, the versinall.exe and gf_par_tree.exe files are dwnladed and extracted int the lcatin specified by $ExchangeRepPath. The gf_par_tree.exe file cntains the parameter tree. 2. The script traverses the extracted parameter tree file by cmparing each f its leaves with the crrespnding leave f the lcal repsitry. Accrding t the cmparisn result, a leaf is deleted, dwnladed, r remains unchanged in the lcal repsitry. A dwnladed file is stred temprarily int $ExchangeRepPath and then cpied t the wrking repsitry which is $PrvisiningRepPath in case f LinkMde=0 and a nn-public repsitry in case f LinkMde=1. 3. The script traverses the extracted parameter tree file by cmparing each f its leaves with the crrepnding leave f the lcal repsitry. Accrding t the cmparisn result, a leaf is deleted, dwnladed, r remains unchanged in the lcal repsitry. A dwnladed file is stred temprarily int $ExchangeRepPath and then cpied t the wrking repsitry which is $PrvisiningRepPath in case f LinkMde=0 and a nn-public repsitry in case f LinkMde=1. This ensures that the newest repsitry changes n the Fujitsu web server are synchrnized with the lcal repsitry. ServerView Update Repsitry 23
24 ServerView Update Repsitry
5.1 elcm nline/ffline update via the irmc S4 web interface 5 Using the Repsitry Server - scenaris A repsitry server can be used in several update management tls f the Fujitsu Sftware ServerView Suite. In the scenaris described belw, it is assumed that Repsitry URL is 172.17.167.63. 5.1 elcm nline/ffline update via the irmc S4 web interface The irmc S4 can be cnfigured t access an external repsitry server. elcm update management functinality is based n the ability f the irmc S4 t autmatically dwnlad files frm a repsitry server via the dedicated irmc S4 management LAN prt and stre them packed as ISO image n the irmc S4 SD card. Figure 2: Repsitry Server used by the elcm Update Management See the manuals "irmc S4 - integrated Remte Management Cntrller" and "embedded Lifecycle Management (elcm)" fr details. ServerView Update Repsitry 25
5 Using the Repsitry Server - scenaris 5.2 ServerView System Mnitr (n lcal nde) In the Update Cnfiguratin tab f the ServerView System Mnitr, yu can define the repsitry path and the settings fr the dwnlad and the update check. Figure 3: ServerView System Mnitr: Defining repsitry path and the dwnlad settings See the "ServerView System Mnitr" manual fr details. 26 ServerView Update Repsitry
5.3 ServerView Operatins Manager - Update Management 5.3 ServerView Operatins Manager - Update Management In Dwnlad Settings step f the Cnfiguratin Wizard, yu can define the prxy settings fr the Dwnlad Service. Figure 4: ServerView Operatins Manager - Update Management: Prxy settings fr the dwnlad service See the "ServerView Update Management" manual fr details. ServerView Update Repsitry 27
28 ServerView Update Repsitry