doc/www/installdebian.php

   1 <? include ("barry.inc"); ?>
   2
   3 <? createHeader("Installing Barry on Debian or Ubuntu or Mint"); ?>
   4
   5 <? createSubHeader("Warning"); ?>
   6
   7 <p>There are two recent non-Barry bugs popping up that are making this
   8 install process just a little bit more tricky for Debian/Ubuntu/Mint users.
   9
  10 <p>One is a bug in apt-get, which causes downloads to stop with an error
  11 if one of the HTTP header lines is longer than 360 characters.  Normally,
  12 this bug is not encountered, but it is encountered on sourceforge.net.
  13
  14 <p>The Barry repositories on netdirect are setup to redirect all large binary
  15 file downloads to the appropriate file on sourceforge.  The apt repo metadata,
  16 such as signatures and checksums are downloaded from netdirect's server
  17 itself, and the binary files are checked against them.
  18
  19 <p>Sourceforge.net includes a cookie in one HTTP header line that is
  20 about 550 characters long.  This has been causing trouble for a number
  21 of users.
  22
  23 <p>Fortunately, the 360 character limit should be removed eventually,
  24 as this has been fixed upstream, according to this
  25 <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=658346">Debian bug report</a>.
  26
  27 <? createSubHeader("Workaround"); ?>
  28
  29 <p>If, after following the usual steps below, you encounter the
  30 "360 char limit" error, there is a workaround.  Go to
  31 <a href="http://sourceforge.net/projects/barry/files/barry/barry-0.18.3/">the Barry file download page</a>
  32 and navigate to your distro and platform.  For example, if you are using
  33 squeeze on 64bit, navigate through: bmbuild/dists/squeeze/main/binary-amd64.
  34 Then download all the .deb files into your /var/cache/apt/archives/ directory,
  35 and install again. Apt will notice the existing files, check them, and
  36 resolve dependencies for you.
  37
  38 <p>Sorry for the inconvenience.  We now return to the usual documentation...
  39
  40
  41 <? createSubHeader("The Setup"); ?>
  42
  43 <p>Starting with the 0.18.x version series, Barry and OpenSync binary
  44 packages are available via apt-get.
  45
  46 <p>To install the latest version of Barry onto Debian Squeeze, add
  47 the following line to your /etc/apt/sources.list file:
  48
  49 <pre>
  50 deb http://download.barry.netdirect.ca/barry-latest/ squeeze main
  51 </pre>
  52
  53 <p>If you only want to use a specific version of Barry, you can change
  54 the URL from "barry-latest" to, for example, "barry-0.18.3".
  55 Check out the latest available versions at the
  56 <a href="http://sourceforge.net/projects/barry/files/barry/">Sourceforge
  57 file list page</a>.
  58
  59 <p>There are multiple versions of Ubuntu available.  Replace the word
  60 "squeeze" above with one of the following:
  61
  62 <ul>
  63         <li>ubuntu1004</li>
  64         <li>ubuntu1104</li>
  65         <li>ubuntu1110</li>
  66         <li>ubuntu1204</li>
  67 </ul>
  68
  69 <p>For Mint, pick the version of Debian or Ubuntu that your version of
  70 Mint is based on.
  71
  72 <p>Finally, you will need to update your apt keyring with the following
  73 key:
  74
  75 <pre>
  76         82DE DE11 74C1 0EA7 C55D  5679 3B52 35AE B6C2 250E
  77 </pre>
  78
  79 <p>One way to fetch this key is by using gpg:
  80
  81 <pre>
  82         gpg --keyserver pgp.mit.edu --recv-key B6C2250E
  83         gpg --armor --export B6C2250E &gt; barry.key
  84         apt-key add barry.key
  85 </pre>
  86
  87
  88 <? createSubHeader("The Packages"); ?>
  89
  90 <p>Barry is split up into multiple binary packages.  For example,
  91 if you want the GUI backup program, you will also need the Barry library.
  92
  93 <p>For most non-development systems, you will need:
  94 <ul>
  95         <li>libbarry18</li>
  96         <li>barry-util</li>
  97         <li>barrybackup-gui</li>
  98         <li>barrydesktop</li>
  99 </ul>
 100 </p>
 101
 102 <p>For syncing, you will also need one of the available versions of
 103 OpenSync (either 0.2x, or 0.39).  Note that OpenSync 0.39 is sometimes
 104 called 0.4x.
 105
 106 <p>The 0.2x series includes the following packages:
 107
 108 <ul>
 109         <li>libopensync0</li>
 110         <li>msynctool</li>
 111         <li>opensync0-plugin-barry</li>
 112         <li>opensync0-plugin-evolution</li>
 113         <li>opensync0-plugin-file</li>
 114         <li>opensync0-plugin-kdepim</li>
 115 </ul>
 116
 117 <p>The 0.4x series includes the following packages:
 118
 119 <ul>
 120         <li>libopensync1</li>
 121         <li>osynctool</li>
 122         <li>opensync1-plugin-barry</li>
 123         <li>opensync1-plugin-evolution</li>
 124         <li>opensync1-plugin-evolution3</li>
 125         <li>opensync1-plugin-file</li>
 126         <li>opensync1-plugin-vformat</li>
 127         <li>opensync1-plugin-xmlformat</li>
 128 </ul>
 129
 130 <p>There are 3 convenience packages: binarymeta2x, binarymeta4x, and
 131 binarymeta-everything.  Install these if you want to install everything.
 132
 133 <p>For development systems, you will need the following additional
 134 packages:
 135 <ul>
 136         <li>libbarry-dev</li>
 137 </ul>
 138
 139
 140 <? createSubHeader("Removal"); ?>
 141
 142 <p>Everything exists in or depends on the following 4 packages: libbarry18,
 143 libopensync0, libopensync1, and barry-doc.  Remove them, and the rest will
 144 follow.
 145