Documentation/English (British)/user-chapter1-obtaining.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">\r
   2 <html>\r
   3         <head>\r
   4                 <link href="style.css" REL="stylesheet" TYPE="text/css" MEDIA="screen">\r
   5                 <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">\r
   6                 <title>Xestia Scanner Server Documentation - User Documentation - 1.1 Obtaining Xestia Scanner Server</title>\r
   7         </head>\r
   8         <body>\r
   9                 <div class="menubarback">\r
  10                         <div class="menubar">\r
  11                                 <span class="apptitle">Xestia Scanner Server</span>\r
  12                                 <a href="index.html">Index</a> | <a href="user.html">User \r
  13 Documentation</a> | <a href="tutorial.html">Tutorial Documentation</a> | \r
  14 <a href="developer.html">Developer Documentation</a>\r
  15                         </div>\r
  16                 </div>\r
  17                 <div class="pageinformation">\r
  18                         <span class="pagetitle">1.1: Obtaining Xestia Scanner Server</span>\r
  19 <br><br>\r
  20 Xestia Scanner Server can be obtained either through the Subversion repository or extracted from a source archive that is available on Xestia Scanner Server homepage.\r
  21 <br><br>\r
  22 <b>1.1.1: Archive Extraction</b>\r
  23 <br><br>\r
  24 The contents of the Xestia Scanner Server archive can be extracted using gzip if it's a Gzip archive, bzip2 if it's a Bzip2'ed archive, 7za if it's a 7-Zip archive and unzip if it's a ZIP archive.\r
  25 <br><br>\r
  26 Bear in mind the following is done from a command console. GUI interfaces can also do the same as preformed here and mainly involves opening the archive and clicking on the Extract/Extract All button or simply dragging the folder containing from out of the archive (usually making a copy of the contents in the archive).\r
  27 <br><br>\r
  28 <div class="messagebox"><div class="message note"><b>Note</b>\r
  29 <br><br>\r
  30 The naming convention of the Xestia Scanner Server archives go as the following:\r
  31 <br><br>\r
  32 xestiascannerserver-x.y.z(-e).arc\r
  33 <br><br>\r
  34 Where x is the major version, y is the minor version and z is the revision with (-e) meaning a very tiny modification that had to be done that did not merit an increment to the revision number.\r
  35     </div>\r
  36 </div>\r
  37 <br><br>\r
  38 When downloading an archive, the archive can be checked (by downloading the file with the same name but with .sha256 added to the end of it) using shasum(1) by doing the following to ensure it is downloaded correctly:\r
  39 <br><br>\r
  40 <div class="code">\r
  41 shasum -a 256 xestiascannerserver-x.y.z(-e).arc\r
  42 </div>\r
  43 <br><br>\r
  44 shasum should then generate the SHA-256 or MD5 checksum that should match the one that appears in the file with .sha256 or .md5 appended to it. If it does not match (and the file containing the sha256 or md5sum hash is the correct version) then the archive should be downloaded again and repeat the same process.\r
  45 <br><br>\r
  46 To extract the gzip archive, the following command should be preformed when switched to the correct directory to extract from.\r
  47 <br><br>\r
  48 <div class="code">\r
  49 gzip -d -c (path)/xestiascannerserver-0.1.0.tar.gz | tar -xv\r
  50 </div>\r
  51 <br><br>\r
  52 A list of files that have been extracted will then appear with the contents of the archive appearing in the directory that the archive was extracted to.\r
  53 <br><br>\r
  54 To extract the bzip2 archive, the following command should be preformed when switched to the correct directory to extract from.\r
  55 <br><br>\r
  56 <div class="code">\r
  57 bzip2 -d -c (path)/xestiascannerserver-0.1.0.tar.bz2 | tar -xv\r
  58 </div>\r
  59 <br><br>\r
  60 A list of files that have been extracted will then appear with the contents of the archive appearing in the directory that the archive was extracted to.\r
  61 <br><br>\r
  62 To extract the ZIP archive, the following command should be preformed when switched to the correct directory to extract from.\r
  63 <br><br>\r
  64 <div class="code">\r
  65 unzip (path)/xestiascannerserver-0.1.0.zip\r
  66 </div>\r
  67 <br><br>\r
  68 A list of files that have been extracted will then appear with the contents of the archive appearing in the directory that the archive was extracted to.\r
  69 <br><br>\r
  70 To extract the 7Zip archive, the following command should be preformed when switched to the correct directory to extract from.\r
  71 <br><br>\r
  72 <div class="code">\r
  73 7za e (path)/xestiascannerserver-0.1.0.7z\r
  74 </div>\r
  75 <br><br>\r
  76 A list of files that have been extracted will then appear with the contents of the archive appearing in the directory that the archive was extracted to.\r
  77 <br><br>\r
  78 <b>1.1.2: Subversion Access</b>\r
  79 <br><br>\r
  80 Xestia Scanner Server can also be obtained through checking out the code from the Subversion repository.\r
  81 <br><br>\r
  82 <div class="messagebox"><div class="message note"><b>Note</b><br><br>\r
  83 Bear in mind that the code that is in the Xestia Scanner Server Subversion repository is normally unstable and could very well cause unexpected problems (such as warnings that appear in the web server error log that can be easily fixed and alterations to the database structure which requires an upgrade script which hasn't been written yet for that particular version yet).\r
  84 </div></div>\r
  85 <br><br>\r
  86 Xestia Scanner Server can be obtained from the Subversion repository by doing the following in a command console after selecting the correct directory to put it in:\r
  87 <br><br>\r
  88 <div class="code">\r
  89 svn checkout svn://svn.berlios.de/xestiascansrv/trunk\r
  90 </div>\r
  91 <br><br>\r
  92 A list of files then appear as they are received from the Subversion repository and placed in the directory the command console is currently in. To update the code stored locally with code that is in the Xestia Scanner Server Subversion repository this command should be done after changing to the directory where the local copy of the Xestia Scanner Server Subversion code is:\r
  93 <br><br>\r
  94 <div class="code">\r
  95 svn update\r
  96 </div>\r
  97 <br><br>\r
  98 A list of files will then appear showing which files has been updated.1 The version of shasum talked about here is the shasum script that is used by the Digest::SHA::PurePerl Perl module which can produce checksums in SHA-1, SHA-224, SHA-256, SHA-384 and SHA-512 which can be installed via CPAN.\r
  99                 </div>\r
 100         </body>\r
 101 </html>\r