xymon

Hex Artifact Content
Login

Artifact 51e56dab9475ded43b3fd2f17f371e7897349f1526061a7aa907400a0e334115:


0000: 2e 54 48 20 43 4c 49 45 4e 54 55 50 44 41 54 45  .TH CLIENTUPDATE
0010: 20 31 20 22 56 65 72 73 69 6f 6e 20 34 2e 33 2e   1 "Version 4.3.
0020: 31 39 3a 20 33 30 20 4d 61 72 20 32 30 31 35 22  19: 30 Mar 2015"
0030: 20 22 58 79 6d 6f 6e 22 0a 2e 53 48 20 4e 41 4d   "Xymon"..SH NAM
0040: 45 0a 63 6c 69 65 6e 74 75 70 64 61 74 65 20 5c  E.clientupdate \
0050: 2d 20 58 79 6d 6f 6e 20 63 6c 69 65 6e 74 20 75  - Xymon client u
0060: 70 64 61 74 65 20 75 74 69 6c 69 74 79 0a 2e 53  pdate utility..S
0070: 48 20 53 59 4e 4f 50 53 49 53 0a 2e 42 20 22 63  H SYNOPSIS..B "c
0080: 6c 69 65 6e 74 75 70 64 61 74 65 20 5b 6f 70 74  lientupdate [opt
0090: 69 6f 6e 73 5d 22 0a 0a 2e 53 48 20 44 45 53 43  ions]"...SH DESC
00a0: 52 49 50 54 49 4f 4e 0a 5c 66 42 63 6c 69 65 6e  RIPTION.\fBclien
00b0: 74 75 70 64 61 74 65 5c 66 52 20 69 73 20 70 61  tupdate\fR is pa
00c0: 72 74 20 6f 66 20 74 68 65 20 58 79 6d 6f 6e 20  rt of the Xymon 
00d0: 63 6c 69 65 6e 74 2e 20 49 74 20 69 73 20 72 65  client. It is re
00e0: 73 70 6f 6e 73 69 62 6c 65 0a 66 6f 72 20 75 70  sponsible.for up
00f0: 64 61 74 69 6e 67 20 61 6e 20 65 78 69 73 74 69  dating an existi
0100: 6e 67 20 63 6c 69 65 6e 74 20 69 6e 73 74 61 6c  ng client instal
0110: 6c 61 74 69 6f 6e 20 66 72 6f 6d 20 61 20 63 65  lation from a ce
0120: 6e 74 72 61 6c 0a 72 65 70 6f 73 69 74 6f 72 79  ntral.repository
0130: 20 6f 66 20 63 6c 69 65 6e 74 20 70 61 63 6b 61   of client packa
0140: 67 65 73 20 73 74 6f 72 65 64 20 6f 6e 20 74 68  ges stored on th
0150: 65 20 58 79 6d 6f 6e 20 73 65 72 76 65 72 2e 0a  e Xymon server..
0160: 0a 57 68 65 6e 20 74 68 65 20 58 79 6d 6f 6e 20  .When the Xymon 
0170: 63 6c 69 65 6e 74 20 73 65 6e 64 73 20 61 20 6e  client sends a n
0180: 6f 72 6d 61 6c 20 63 6c 69 65 6e 74 20 72 65 70  ormal client rep
0190: 6f 72 74 20 74 6f 20 74 68 65 20 58 79 6d 6f 6e  ort to the Xymon
01a0: 0a 73 65 72 76 65 72 2c 20 74 68 65 20 73 65 72  .server, the ser
01b0: 76 65 72 20 72 65 73 70 6f 6e 64 73 20 77 69 74  ver responds wit
01c0: 68 20 74 68 65 20 73 65 63 74 69 6f 6e 20 6f 66  h the section of
01d0: 20 74 68 65 0a 2e 49 20 63 6c 69 65 6e 74 2d 6c   the..I client-l
01e0: 6f 63 61 6c 2e 63 66 67 28 35 29 0a 66 69 6c 65  ocal.cfg(5).file
01f0: 20 74 68 61 74 20 69 73 20 72 65 6c 65 76 61 6e   that is relevan
0200: 74 20 74 6f 20 74 68 69 73 20 63 6c 69 65 6e 74  t to this client
0210: 2e 20 49 6e 63 6c 75 64 65 64 20 69 6e 20 74 68  . Included in th
0220: 69 73 20 6d 61 79 20 62 65 0a 61 20 22 63 6c 69  is may be.a "cli
0230: 65 6e 74 76 65 72 73 69 6f 6e 22 20 76 61 6c 75  entversion" valu
0240: 65 2e 20 54 68 65 20 63 6c 69 65 6e 74 76 65 72  e. The clientver
0250: 73 69 6f 6e 20 72 65 63 65 69 76 65 64 20 66 72  sion received fr
0260: 6f 6d 20 74 68 65 20 73 65 72 76 65 72 0a 69 73  om the server.is
0270: 20 63 6f 6d 70 61 72 65 64 20 61 67 61 69 6e 73   compared agains
0280: 74 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 6c  t the current cl
0290: 69 65 6e 74 76 65 72 73 69 6f 6e 20 69 6e 73 74  ientversion inst
02a0: 61 6c 6c 65 64 20 6f 6e 20 74 68 65 20 63 6c 69  alled on the cli
02b0: 65 6e 74 2c 20 0a 61 73 20 64 65 74 65 72 6d 69  ent, .as determi
02c0: 6e 65 64 20 62 79 20 74 68 65 20 63 6f 6e 74 65  ned by the conte
02d0: 6e 74 73 20 6f 66 20 74 68 65 20 24 58 59 4d 4f  nts of the $XYMO
02e0: 4e 48 4f 4d 45 2f 65 74 63 2f 63 6c 69 65 6e 74  NHOME/etc/client
02f0: 76 65 72 73 69 6f 6e 2e 63 66 67 0a 66 69 6c 65  version.cfg.file
0300: 2e 20 49 66 20 74 68 65 20 74 77 6f 20 76 65 72  . If the two ver
0310: 73 69 6f 6e 73 20 61 72 65 20 6e 6f 74 20 69 64  sions are not id
0320: 65 6e 74 69 63 61 6c 2c 20 63 6c 69 65 6e 74 75  entical, clientu
0330: 70 64 61 74 65 20 69 73 0a 6c 61 75 6e 63 68 65  pdate is.launche
0340: 64 20 74 6f 20 75 70 64 61 74 65 20 74 68 65 20  d to update the 
0350: 63 6c 69 65 6e 74 20 69 6e 73 74 61 6c 6c 61 74  client installat
0360: 69 6f 6e 2e 0a 0a 2e 53 48 20 4f 50 54 49 4f 4e  ion....SH OPTION
0370: 53 0a 2e 49 50 20 22 2d 2d 6c 65 76 65 6c 22 0a  S..IP "--level".
0380: 52 65 70 6f 72 74 20 74 68 65 20 63 75 72 72 65  Report the curre
0390: 6e 74 20 63 6c 69 65 6e 74 76 65 72 73 69 6f 6e  nt clientversion
03a0: 2e 0a 0a 2e 49 50 20 22 2d 2d 75 70 64 61 74 65  ....IP "--update
03b0: 3d 4e 45 57 56 45 52 53 49 4f 4e 22 0a 41 74 74  =NEWVERSION".Att
03c0: 65 6d 70 74 20 74 6f 20 75 70 64 61 74 65 20 74  empt to update t
03d0: 68 65 20 63 6c 69 65 6e 74 20 74 6f 20 4e 45 57  he client to NEW
03e0: 56 45 52 53 49 4f 4e 20 62 79 20 66 65 74 63 68  VERSION by fetch
03f0: 69 6e 67 20 74 68 69 73 20 76 65 72 73 69 6f 6e  ing this version
0400: 0a 6f 66 20 74 68 65 20 63 6c 69 65 6e 74 20 73  .of the client s
0410: 6f 66 74 77 61 72 65 20 66 72 6f 6d 20 74 68 65  oftware from the
0420: 20 58 79 6d 6f 6e 20 73 65 72 76 65 72 2e 0a 0a   Xymon server...
0430: 2e 49 50 20 22 2d 2d 72 65 65 78 65 63 22 0a 55  .IP "--reexec".U
0440: 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79 20 64  sed internally d
0450: 75 72 69 6e 67 20 74 68 65 20 75 70 64 61 74 65  uring the update
0460: 20 70 72 6f 63 65 73 73 2c 20 73 65 65 20 5c 66   process, see \f
0470: 42 4f 50 45 52 41 54 49 4f 4e 5c 66 52 20 62 65  BOPERATION\fR be
0480: 6c 6f 77 2e 0a 0a 2e 49 50 20 22 2d 2d 72 65 6d  low....IP "--rem
0490: 6f 76 65 2d 73 65 6c 66 22 0a 55 73 65 64 20 69  ove-self".Used i
04a0: 6e 74 65 72 6e 61 6c 6c 79 20 64 75 72 69 6e 67  nternally during
04b0: 20 74 68 65 20 75 70 64 61 74 65 20 70 72 6f 63   the update proc
04c0: 65 73 73 2e 20 54 68 69 73 20 6f 70 74 69 6f 6e  ess. This option
04d0: 20 63 61 75 73 65 73 0a 74 68 65 20 72 75 6e 6e   causes.the runn
04e0: 69 6e 67 20 63 6c 69 65 6e 74 75 70 64 61 74 65  ing clientupdate
04f0: 20 75 74 69 6c 69 74 79 20 74 6f 20 64 65 6c 65   utility to dele
0500: 74 65 20 69 74 73 65 6c 66 20 2d 20 69 74 20 69  te itself - it i
0510: 73 20 75 73 65 64 0a 64 75 72 69 6e 67 20 74 68  s used.during th
0520: 65 20 75 70 64 61 74 65 20 74 6f 20 70 75 72 67  e update to purg
0530: 65 20 61 20 74 65 6d 70 6f 72 61 72 79 20 63 6f  e a temporary co
0540: 70 79 20 6f 66 20 74 68 65 20 63 6c 69 65 6e 74  py of the client
0550: 75 70 64 61 74 65 0a 75 74 69 6c 69 74 79 20 74  update.utility t
0560: 68 61 74 20 69 73 20 69 6e 73 74 61 6c 6c 65 64  hat is installed
0570: 20 69 6e 20 24 58 59 4d 4f 4e 54 4d 50 2e 0a 0a   in $XYMONTMP...
0580: 2e 53 48 20 55 53 49 4e 47 20 43 4c 49 45 4e 54  .SH USING CLIENT
0590: 55 50 44 41 54 45 20 49 4e 20 58 59 4d 4f 4e 0a  UPDATE IN XYMON.
05a0: 54 6f 20 6d 61 6e 61 67 65 20 75 70 64 61 74 69  To manage updati
05b0: 6e 67 20 63 6c 69 65 6e 74 73 20 77 69 74 68 6f  ng clients witho
05c0: 75 74 20 68 61 76 69 6e 67 20 74 6f 20 6c 6f 67  ut having to log
05d0: 6f 6e 20 74 6f 20 65 61 63 68 20 73 65 72 76 65  on to each serve
05e0: 72 2c 0a 79 6f 75 20 63 61 6e 20 75 73 65 20 74  r,.you can use t
05f0: 68 65 20 63 6c 69 65 6e 74 75 70 64 61 74 65 20  he clientupdate 
0600: 75 74 69 6c 69 74 79 2e 20 54 68 69 73 20 69 73  utility. This is
0610: 20 68 6f 77 20 79 6f 75 20 73 65 74 75 70 20 74   how you setup t
0620: 68 65 0a 72 65 6c 65 61 73 65 20 6f 66 20 61 20  he.release of a 
0630: 6e 65 77 20 63 6c 69 65 6e 74 20 76 65 72 73 69  new client versi
0640: 6f 6e 2e 0a 0a 2e 49 50 20 22 43 72 65 61 74 65  on....IP "Create
0650: 20 74 68 65 20 6e 65 77 20 63 6c 69 65 6e 74 22   the new client"
0660: 0a 53 65 74 75 70 20 74 68 65 20 6e 65 77 20 63  .Setup the new c
0670: 6c 69 65 6e 74 20 24 58 59 4d 4f 4e 48 4f 4d 45  lient $XYMONHOME
0680: 20 64 69 72 65 63 74 6f 72 79 2c 20 65 2e 67 2e   directory, e.g.
0690: 20 62 79 20 63 6f 70 79 69 6e 67 20 61 6e 20 65   by copying an e
06a0: 78 69 73 74 69 6e 67 0a 63 6c 69 65 6e 74 20 69  xisting.client i
06b0: 6e 73 74 61 6c 6c 61 74 69 6f 6e 20 74 6f 20 61  nstallation to a
06c0: 6e 20 65 6d 70 74 79 20 64 69 72 65 63 74 6f 72  n empty director
06d0: 79 20 61 6e 64 20 6d 6f 64 69 66 79 69 6e 67 20  y and modifying 
06e0: 69 74 20 66 6f 72 20 79 6f 75 72 0a 6e 65 65 64  it for your.need
06f0: 73 2e 20 49 74 20 69 73 20 61 20 67 6f 6f 64 20  s. It is a good 
0700: 69 64 65 61 20 74 6f 20 64 65 6c 65 74 65 20 61  idea to delete a
0710: 6c 6c 20 66 69 6c 65 73 20 69 6e 20 74 68 65 20  ll files in the 
0720: 74 6d 70 2f 20 61 6e 64 20 6c 6f 67 73 2f 0a 64  tmp/ and logs/.d
0730: 69 72 65 63 74 6f 72 69 65 73 2c 20 73 69 6e 63  irectories, sinc
0740: 65 20 74 68 65 72 65 20 69 73 20 6e 6f 20 6e 65  e there is no ne
0750: 65 64 20 74 6f 20 63 6f 70 79 20 74 68 65 73 65  ed to copy these
0760: 20 6f 76 65 72 20 74 6f 20 61 6c 6c 20 6f 66 0a   over to all of.
0770: 74 68 65 20 63 6c 69 65 6e 74 73 2e 20 50 61 79  the clients. Pay
0780: 20 61 74 74 65 6e 74 69 6f 6e 20 74 6f 20 74 68   attention to th
0790: 65 20 65 74 63 2f 20 66 69 6c 65 73 2c 20 61 6e  e etc/ files, an
07a0: 64 20 6d 61 6b 65 20 73 75 72 65 20 74 68 61 74  d make sure that
07b0: 20 74 68 65 79 0a 61 72 65 20 73 75 69 74 61 62   they.are suitab
07c0: 6c 65 20 66 6f 72 20 74 68 65 20 73 79 73 74 65  le for the syste
07d0: 6d 73 20 77 68 65 72 65 20 79 6f 75 20 77 61 6e  ms where you wan
07e0: 74 20 74 6f 20 64 65 70 6c 6f 79 20 74 68 69 73  t to deploy this
07f0: 20 6e 65 77 20 63 6c 69 65 6e 74 2e 0a 59 6f 75   new client..You
0800: 20 63 61 6e 20 61 64 64 20 66 69 6c 65 73 20 2d   can add files -
0810: 20 65 2e 67 2e 20 65 78 74 65 6e 73 69 6f 6e 20   e.g. extension 
0820: 73 63 72 69 70 74 73 20 69 6e 20 74 68 65 20 65  scripts in the e
0830: 78 74 2f 20 64 69 72 65 63 74 6f 72 79 20 2d 0a  xt/ directory -.
0840: 62 75 74 20 74 68 65 20 63 6c 69 65 6e 74 75 70  but the clientup
0850: 64 61 74 65 20 75 74 69 6c 69 74 79 20 63 61 6e  date utility can
0860: 6e 6f 74 20 64 65 6c 65 74 65 20 6f 72 20 72 65  not delete or re
0870: 6e 61 6d 65 20 66 69 6c 65 73 2e 0a 0a 2e 49 50  name files....IP
0880: 20 22 50 61 63 6b 61 67 65 20 74 68 65 20 63 6c   "Package the cl
0890: 69 65 6e 74 22 0a 57 68 65 6e 20 79 6f 75 72 20  ient".When your 
08a0: 6e 65 77 20 63 6c 69 65 6e 74 20 73 6f 66 74 77  new client softw
08b0: 61 72 65 20 69 73 20 72 65 61 64 79 2c 20 63 72  are is ready, cr
08c0: 65 61 74 65 20 61 20 74 61 72 2d 66 69 6c 65 20  eate a tar-file 
08d0: 6f 66 20 74 68 65 20 0a 6e 65 77 20 63 6c 69 65  of the .new clie
08e0: 6e 74 2e 20 41 6c 6c 20 66 69 6c 65 73 20 69 6e  nt. All files in
08f0: 20 74 68 65 20 74 61 72 20 61 72 63 68 69 76 65   the tar archive
0900: 20 6d 75 73 74 20 68 61 76 65 20 66 69 6c 65 20   must have file 
0910: 6e 61 6d 65 73 20 0a 72 65 6c 61 74 69 76 65 20  names .relative 
0920: 74 6f 20 74 68 65 20 63 6c 69 65 6e 74 73 27 20  to the clients' 
0930: 24 58 59 4d 4f 4e 48 4f 4d 45 20 28 75 73 75 61  $XYMONHOME (usua
0940: 6c 6c 79 2c 20 7e 78 79 6d 6f 6e 2f 63 6c 69 65  lly, ~xymon/clie
0950: 6e 74 2f 29 2e 0a 53 61 76 65 20 74 68 65 20 74  nt/)..Save the t
0960: 61 72 20 66 69 6c 65 20 6f 6e 20 74 68 65 20 58  ar file on the X
0970: 79 6d 6f 6e 20 73 65 72 76 65 72 20 69 6e 20 0a  ymon server in .
0980: 7e 78 79 6d 6f 6e 2f 73 65 72 76 65 72 2f 64 6f  ~xymon/server/do
0990: 77 6e 6c 6f 61 64 2f 73 6f 6d 65 66 69 6c 65 2e  wnload/somefile.
09a0: 74 61 72 2e 20 20 44 6f 6e 27 74 20 63 6f 6d 70  tar.  Don't comp
09b0: 72 65 73 73 20 69 74 2e 0a 49 74 20 69 73 20 72  ress it..It is r
09c0: 65 63 6f 6d 6d 65 6e 64 65 64 20 74 68 61 74 20  ecommended that 
09d0: 79 6f 75 20 75 73 65 20 73 6f 6d 65 20 73 6f 72  you use some sor
09e0: 74 20 6f 66 20 6f 70 65 72 61 74 69 6e 67 2d 73  t of operating-s
09f0: 79 73 74 65 6d 20 0a 61 6e 64 20 76 65 72 73 69  ystem .and versi
0a00: 6f 6e 2d 6e 75 6d 62 65 72 69 6e 67 20 73 63 68  on-numbering sch
0a10: 65 6d 65 20 66 6f 72 20 74 68 65 20 66 69 6c 65  eme for the file
0a20: 6e 61 6d 65 2c 20 62 75 74 20 79 6f 75 20 63 61  name, but you ca
0a30: 6e 20 63 68 6f 6f 73 65 20 0a 77 68 61 74 65 76  n choose .whatev
0a40: 65 72 20 66 69 6c 65 6e 61 6d 65 20 73 75 69 74  er filename suit
0a50: 73 20 79 6f 75 20 2d 20 74 68 65 20 6f 6e 6c 79  s you - the only
0a60: 20 72 65 71 75 69 72 65 6d 65 6e 74 20 69 73 20   requirement is 
0a70: 74 68 61 74 20 69 74 20 6d 75 73 74 0a 65 6e 64  that it must.end
0a80: 20 77 69 74 68 20 22 2e 74 61 72 22 2e 20 54 68   with ".tar". Th
0a90: 65 20 70 61 72 74 20 6f 66 20 74 68 65 20 66 69  e part of the fi
0aa0: 6c 65 6e 61 6d 65 20 70 72 65 63 65 64 69 6e 67  lename preceding
0ab0: 20 22 2e 74 61 72 22 20 69 73 0a 77 68 61 74 20   ".tar" is.what 
0ac0: 58 79 6d 6f 6e 20 77 69 6c 6c 20 75 73 65 20 61  Xymon will use a
0ad0: 73 20 74 68 65 20 22 63 6c 69 65 6e 74 76 65 72  s the "clientver
0ae0: 73 69 6f 6e 22 20 49 44 2e 0a 0a 2e 49 50 20 22  sion" ID....IP "
0af0: 43 6f 6e 66 69 67 75 72 65 20 77 68 69 63 68 20  Configure which 
0b00: 68 6f 73 74 73 20 72 65 63 65 69 76 65 20 74 68  hosts receive th
0b10: 65 20 6e 65 77 20 63 6c 69 65 6e 74 22 0a 49 6e  e new client".In
0b20: 20 74 68 65 20 0a 2e 49 20 63 6c 69 65 6e 74 2d   the ..I client-
0b30: 6c 6f 63 61 6c 2e 63 66 67 28 35 29 0a 66 69 6c  local.cfg(5).fil
0b40: 65 2c 20 79 6f 75 20 6d 75 73 74 20 6e 6f 77 20  e, you must now 
0b50: 73 65 74 75 70 20 61 20 5c 66 42 63 6c 69 65 6e  setup a \fBclien
0b60: 74 76 65 72 73 69 6f 6e 3a 49 44 5c 66 52 20 6c  tversion:ID\fR l
0b70: 69 6e 65 0a 77 68 65 72 65 20 74 68 65 20 5c 66  ine.where the \f
0b80: 42 49 44 5c 66 52 20 6d 61 74 63 68 65 73 20 74  BID\fR matches t
0b90: 68 65 20 66 69 6c 65 6e 61 6d 65 20 79 6f 75 20  he filename you 
0ba0: 75 73 65 64 20 66 6f 72 20 74 68 65 0a 74 61 72  used for the.tar
0bb0: 2d 66 69 6c 65 2e 20 53 6f 20 69 66 20 79 6f 75  -file. So if you
0bc0: 20 68 61 76 65 20 70 61 63 6b 61 67 65 64 20 74   have packaged t
0bd0: 68 65 20 6e 65 77 20 63 6c 69 65 6e 74 20 69 6e  he new client in
0be0: 74 6f 20 74 68 65 0a 66 69 6c 65 20 5c 66 42 6c  to the.file \fBl
0bf0: 69 6e 75 78 2e 76 32 2e 74 61 72 5c 66 52 2c 20  inux.v2.tar\fR, 
0c00: 74 68 65 6e 20 74 68 65 20 63 6f 72 72 65 73 70  then the corresp
0c10: 6f 6e 64 69 6e 67 20 0a 65 6e 74 72 79 20 69 6e  onding .entry in
0c20: 20 63 6c 69 65 6e 74 2d 6c 6f 63 61 6c 2e 63 66   client-local.cf
0c30: 67 20 77 6f 75 6c 64 20 62 65 20 5c 66 42 63 6c  g would be \fBcl
0c40: 69 65 6e 74 76 65 72 73 69 6f 6e 3a 6c 69 6e 75  ientversion:linu
0c50: 78 2e 76 32 5c 66 52 2e 0a 0a 2e 49 50 20 22 57  x.v2\fR....IP "W
0c60: 61 69 74 20 66 6f 72 20 78 79 6d 6f 6e 64 20 74  ait for xymond t
0c70: 6f 20 72 65 6c 6f 61 64 20 63 6c 69 65 6e 74 2d  o reload client-
0c80: 6c 6f 63 61 6c 2e 63 66 67 22 0a 78 79 6d 6f 6e  local.cfg".xymon
0c90: 64 20 77 69 6c 6c 20 61 75 74 6f 6d 61 74 69 63  d will automatic
0ca0: 61 6c 6c 79 20 72 65 6c 6f 61 64 20 74 68 65 20  ally reload the 
0cb0: 63 6c 69 65 6e 74 2d 6c 6f 63 61 6c 2e 63 66 67  client-local.cfg
0cc0: 20 66 69 6c 65 0a 61 66 74 65 72 20 61 74 20 6d   file.after at m
0cd0: 6f 73 74 20 31 30 20 6d 69 6e 75 74 65 73 2e 20  ost 10 minutes. 
0ce0: 49 66 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 66  If you want to f
0cf0: 6f 72 63 65 20 61 6e 20 69 6d 6d 65 64 69 61 74  orce an immediat
0d00: 65 0a 72 65 6c 6f 61 64 2c 20 73 65 6e 64 20 61  e.reload, send a
0d10: 20 53 49 47 48 55 50 20 73 69 67 6e 61 6c 20 74   SIGHUP signal t
0d20: 6f 20 74 68 65 20 78 79 6d 6f 6e 64 20 70 72 6f  o the xymond pro
0d30: 63 65 73 73 2e 0a 0a 2e 49 50 20 22 57 61 69 74  cess....IP "Wait
0d40: 20 66 6f 72 20 74 68 65 20 63 6c 69 65 6e 74 20   for the client 
0d50: 74 6f 20 75 70 64 61 74 65 22 0a 54 68 65 20 6e  to update".The n
0d60: 65 78 74 20 74 69 6d 65 20 74 68 65 20 63 6c 69  ext time the cli
0d70: 65 6e 74 20 63 6f 6e 74 61 63 74 73 20 74 68 65  ent contacts the
0d80: 20 58 79 6d 6f 6e 20 73 65 72 76 65 72 20 74 6f   Xymon server to
0d90: 0a 73 65 6e 64 20 74 68 65 20 63 6c 69 65 6e 74  .send the client
0da0: 20 64 61 74 61 2c 20 69 74 20 77 69 6c 6c 20 6e   data, it will n
0db0: 6f 74 69 63 65 20 74 68 65 20 6e 65 77 20 63 6c  otice the new cl
0dc0: 69 65 6e 74 76 65 72 73 69 6f 6e 0a 73 65 74 74  ientversion.sett
0dd0: 69 6e 67 20 69 6e 20 63 6c 69 65 6e 74 2d 6c 6f  ing in client-lo
0de0: 63 61 6c 2e 63 66 67 2c 20 61 6e 64 20 77 69 6c  cal.cfg, and wil
0df0: 6c 20 72 75 6e 20 5c 66 42 63 6c 69 65 6e 74 75  l run \fBclientu
0e00: 70 64 61 74 65 5c 66 52 0a 74 6f 20 69 6e 73 74  pdate\fR.to inst
0e10: 61 6c 6c 20 74 68 65 20 6e 65 77 20 63 6c 69 65  all the new clie
0e20: 6e 74 20 73 6f 66 74 77 61 72 65 2e 20 53 6f 20  nt software. So 
0e30: 77 68 65 6e 20 74 68 65 20 63 6c 69 65 6e 74 20  when the client 
0e40: 72 75 6e 73 0a 74 68 65 20 6e 65 78 74 20 74 69  runs.the next ti
0e50: 6d 65 2c 20 69 74 20 77 69 6c 6c 20 75 73 65 20  me, it will use 
0e60: 74 68 65 20 6e 65 77 20 63 6c 69 65 6e 74 20 73  the new client s
0e70: 6f 66 74 77 61 72 65 2e 0a 0a 2e 53 48 20 4f 50  oftware....SH OP
0e80: 45 52 41 54 49 4f 4e 0a 5c 66 42 63 6c 69 65 6e  ERATION.\fBclien
0e90: 74 75 70 64 61 74 65 5c 66 52 20 72 75 6e 73 20  tupdate\fR runs 
0ea0: 69 6e 20 74 77 6f 20 73 74 65 70 73 3a 0a 0a 2e  in two steps:...
0eb0: 49 50 20 22 52 65 2d 65 78 65 63 20 73 74 65 70  IP "Re-exec step
0ec0: 22 0a 54 68 65 20 66 69 72 73 74 20 73 74 65 70  ".The first step
0ed0: 20 69 73 20 77 68 65 6e 20 63 6c 69 65 6e 74 75   is when clientu
0ee0: 70 64 61 74 65 20 69 73 20 66 69 72 73 74 20 69  pdate is first i
0ef0: 6e 76 6f 6b 65 64 20 66 72 6f 6d 20 74 68 65 20  nvoked from the 
0f00: 78 79 6d 6f 6e 63 6c 69 65 6e 74 2e 73 68 20 0a  xymonclient.sh .
0f10: 73 63 72 69 70 74 20 77 69 74 68 20 74 68 65 20  script with the 
0f20: 22 2d 2d 72 65 2d 65 78 65 63 22 20 6f 70 74 69  "--re-exec" opti
0f30: 6f 6e 2e 20 54 68 69 73 20 73 74 65 70 20 63 6f  on. This step co
0f40: 70 69 65 73 20 74 68 65 20 63 6c 69 65 6e 74 75  pies the clientu
0f50: 70 64 61 74 65 0a 70 72 6f 67 72 61 6d 20 66 72  pdate.program fr
0f60: 6f 6d 20 24 58 59 4d 4f 4e 48 4f 4d 45 2f 62 69  om $XYMONHOME/bi
0f70: 6e 2f 20 74 6f 20 61 20 74 65 6d 70 6f 72 61 72  n/ to a temporar
0f80: 79 20 66 69 6c 65 20 69 6e 20 74 68 65 20 24 58  y file in the $X
0f90: 59 4d 4f 4e 54 4d 50 20 64 69 72 65 63 74 6f 72  YMONTMP director
0fa0: 79 2e 0a 54 68 69 73 20 69 73 20 74 6f 20 61 76  y..This is to av
0fb0: 6f 69 64 20 63 6f 6e 66 6c 69 63 74 73 20 77 68  oid conflicts wh
0fc0: 65 6e 20 74 68 65 20 75 70 64 61 74 65 20 70 72  en the update pr
0fd0: 6f 63 65 64 75 72 65 20 69 6e 73 74 61 6c 6c 73  ocedure installs
0fe0: 20 61 20 6e 65 77 0a 76 65 72 73 69 6f 6e 20 6f   a new.version o
0ff0: 66 20 74 68 65 20 63 6c 69 65 6e 74 75 70 64 61  f the clientupda
1000: 74 65 20 75 74 69 6c 69 74 79 20 69 74 73 65 6c  te utility itsel
1010: 66 2e 20 55 70 6f 6e 20 63 6f 6d 70 6c 65 74 69  f. Upon completi
1020: 6f 6e 20 6f 66 20 74 68 69 73 0a 73 74 65 70 2c  on of this.step,
1030: 20 74 68 65 20 63 6c 69 65 6e 74 75 70 64 61 74   the clientupdat
1040: 65 20 75 74 69 6c 69 74 79 20 61 75 74 6f 6d 61  e utility automa
1050: 74 69 63 61 6c 6c 79 20 6c 61 75 6e 63 68 65 73  tically launches
1060: 20 74 68 65 20 6e 65 78 74 20 73 74 65 70 0a 62   the next step.b
1070: 79 20 72 75 6e 6e 69 6e 67 20 74 68 65 20 70 72  y running the pr
1080: 6f 67 72 61 6d 20 66 72 6f 6d 20 74 68 65 20 66  ogram from the f
1090: 69 6c 65 20 69 6e 20 24 58 59 4d 4f 4e 54 4d 50  ile in $XYMONTMP
10a0: 2e 0a 0a 2e 49 50 20 22 55 70 64 61 74 65 20 73  ....IP "Update s
10b0: 74 65 70 22 0a 54 68 65 20 73 65 63 6f 6e 64 20  tep".The second 
10c0: 73 74 65 70 20 64 6f 77 6e 6c 6f 61 64 73 20 74  step downloads t
10d0: 68 65 20 6e 65 77 20 63 6c 69 65 6e 74 20 73 6f  he new client so
10e0: 66 74 77 61 72 65 20 66 72 6f 6d 20 74 68 65 20  ftware from the 
10f0: 58 79 6d 6f 6e 20 73 65 72 76 65 72 2e 0a 54 68  Xymon server..Th
1100: 65 20 6e 65 77 20 73 6f 66 74 77 61 72 65 20 6d  e new software m
1110: 75 73 74 20 62 65 20 70 61 63 6b 65 64 20 69 6e  ust be packed in
1120: 74 6f 20 61 20 74 61 72 20 66 69 6c 65 2c 20 77  to a tar file, w
1130: 68 69 63 68 20 63 6c 69 65 6e 74 75 70 64 61 74  hich clientupdat
1140: 65 20 74 68 65 6e 0a 75 6e 70 61 63 6b 73 20 69  e then.unpacks i
1150: 6e 74 6f 20 74 68 65 20 24 58 59 4d 4f 4e 48 4f  nto the $XYMONHO
1160: 4d 45 20 64 69 72 65 63 74 6f 72 79 2e 0a 0a 2e  ME directory....
1170: 53 48 20 22 45 4e 56 49 52 4f 4e 4d 45 4e 54 20  SH "ENVIRONMENT 
1180: 56 41 52 49 41 42 4c 45 53 22 0a 63 6c 69 65 6e  VARIABLES".clien
1190: 74 75 70 64 61 74 65 20 75 73 65 73 20 73 65 76  tupdate uses sev
11a0: 65 72 61 6c 20 6f 66 20 74 68 65 20 73 74 61 6e  eral of the stan
11b0: 64 61 72 64 20 58 79 6d 6f 6e 20 65 6e 76 69 72  dard Xymon envir
11c0: 6f 6e 6d 65 6e 74 0a 76 61 72 69 61 62 6c 65 73  onment.variables
11d0: 2c 20 69 6e 63 6c 75 64 69 6e 67 20 5c 66 42 58  , including \fBX
11e0: 59 4d 4f 4e 48 4f 4d 45 5c 66 52 20 61 6e 64 20  YMONHOME\fR and 
11f0: 5c 66 42 58 59 4d 4f 4e 54 4d 50 5c 66 52 2e 0a  \fBXYMONTMP\fR..
1200: 0a 2e 53 48 20 22 53 45 45 20 41 4c 53 4f 22 0a  ..SH "SEE ALSO".
1210: 78 79 6d 6f 6e 28 37 29 2c 20 78 79 6d 6f 6e 28  xymon(7), xymon(
1220: 31 29 2c 20 63 6c 69 65 6e 74 2d 6c 6f 63 61 6c  1), client-local
1230: 2e 63 66 67 28 35 29 0a 0a                       .cfg(5)..