doc/webserver/user-manual/upgradersnote.html

   1 <HTML
   2 ><HEAD
   3 ><TITLE
   4 >Note to Upgraders</TITLE
   5 ><META
   6 NAME="GENERATOR"
   7 CONTENT="Modular DocBook HTML Stylesheet Version 1.64
   8 "><LINK
   9 REL="HOME"
  10 TITLE="Privoxy User Manual"
  11 HREF="index.html"><LINK
  12 REL="PREVIOUS"
  13 TITLE="Installation"
  14 HREF="installation.html"><LINK
  15 REL="NEXT"
  16 TITLE="Quickstart to Using Privoxy"
  17 HREF="quickstart.html"><LINK
  18 REL="STYLESHEET"
  19 TYPE="text/css"
  20 HREF="../p_doc.css"></HEAD
  21 ><BODY
  22 CLASS="SECT1"
  23 BGCOLOR="#EEEEEE"
  24 TEXT="#000000"
  25 LINK="#0000FF"
  26 VLINK="#840084"
  27 ALINK="#0000FF"
  28 ><DIV
  29 CLASS="NAVHEADER"
  30 ><TABLE
  31 WIDTH="100%"
  32 BORDER="0"
  33 CELLPADDING="0"
  34 CELLSPACING="0"
  35 ><TR
  36 ><TH
  37 COLSPAN="3"
  38 ALIGN="center"
  39 >Privoxy User Manual</TH
  40 ></TR
  41 ><TR
  42 ><TD
  43 WIDTH="10%"
  44 ALIGN="left"
  45 VALIGN="bottom"
  46 ><A
  47 HREF="installation.html"
  48 >Prev</A
  49 ></TD
  50 ><TD
  51 WIDTH="80%"
  52 ALIGN="center"
  53 VALIGN="bottom"
  54 ></TD
  55 ><TD
  56 WIDTH="10%"
  57 ALIGN="right"
  58 VALIGN="bottom"
  59 ><A
  60 HREF="quickstart.html"
  61 >Next</A
  62 ></TD
  63 ></TR
  64 ></TABLE
  65 ><HR
  66 ALIGN="LEFT"
  67 WIDTH="100%"></DIV
  68 ><DIV
  69 CLASS="SECT1"
  70 ><H1
  71 CLASS="SECT1"
  72 ><A
  73 NAME="UPGRADERSNOTE"
  74 >3. Note to Upgraders</A
  75 ></H1
  76 ><P
  77 > There are very significant changes from earlier
  78  <SPAN
  79 CLASS="APPLICATION"
  80 >Junkbuster</SPAN
  81 > versions to the current
  82  <SPAN
  83 CLASS="APPLICATION"
  84 >Privoxy</SPAN
  85 >. The number, names, syntax, and
  86  purposes of configuration files have substantially  changed.
  87  <SPAN
  88 CLASS="APPLICATION"
  89 >Junkbuster 2.0.x</SPAN
  90 > configuration
  91  files will not migrate, <SPAN
  92 CLASS="APPLICATION"
  93 >Junkbuster 2.9.x</SPAN
  94 >
  95  and <SPAN
  96 CLASS="APPLICATION"
  97 >Privoxy</SPAN
  98 > configurations will need to be
  99  ported. The functionalities of the old <TT
 100 CLASS="FILENAME"
 101 >blockfile</TT
 102 >,
 103  <TT
 104 CLASS="FILENAME"
 105 >cookiefile</TT
 106 > and <TT
 107 CLASS="FILENAME"
 108 >imagelist</TT
 109 >
 110  are now combined into the <A
 111 HREF="actions-file.html"
 112 ><SPAN
 113 CLASS="QUOTE"
 114 >"actions
 115  files"</SPAN
 116 ></A
 117 >.
 118  <TT
 119 CLASS="FILENAME"
 120 >default.action</TT
 121 >, is the main actions file. Local
 122  exceptions should best be put into <TT
 123 CLASS="FILENAME"
 124 >user.action</TT
 125 >.</P
 126 ><P
 127 > A <A
 128 HREF="filter-file.html"
 129 ><SPAN
 130 CLASS="QUOTE"
 131 >"filter file"</SPAN
 132 ></A
 133 > (typically
 134  <TT
 135 CLASS="FILENAME"
 136 >default.filter</TT
 137 >) is new as of <SPAN
 138 CLASS="APPLICATION"
 139 >Privoxy
 140  2.9.x</SPAN
 141 >, and provides some of the new sophistication (explained
 142  below). <TT
 143 CLASS="FILENAME"
 144 >config</TT
 145 > is much the same as before.</P
 146 ><P
 147 > If upgrading from a 2.0.x version, you will have to use the new config
 148  files, and possibly adapt any personal rules from your older files.
 149  When porting personal rules over from the old <TT
 150 CLASS="FILENAME"
 151 >blockfile</TT
 152 >
 153  to the new actions files, please note that even the pattern syntax has
 154  changed. If upgrading from 2.9.x development versions, it is still
 155  recommended to use the new configuration files.</P
 156 ><P
 157 > A quick list of things to be aware of before upgrading: </P
 158 ><P
 159 > <P
 160 ></P
 161 ><UL
 162 ><LI
 163 ><P
 164 >   The default listening port is now 8118 due to a conflict with another
 165    service (NAS).
 166   </P
 167 ></LI
 168 ><LI
 169 ><P
 170 >
 171     Some installers may remove earlier versions completely. Save any
 172     important configuration files!
 173   </P
 174 ></LI
 175 ><LI
 176 ><P
 177 >   <SPAN
 178 CLASS="APPLICATION"
 179 >Privoxy</SPAN
 180 > is controllable with a web browser
 181    at the special URL: <A
 182 HREF="http://config.privoxy.org/"
 183 TARGET="_top"
 184 >http://config.privoxy.org/</A
 185 >
 186    (Shortcut: <A
 187 HREF="http://p.p/"
 188 TARGET="_top"
 189 >http://p.p/</A
 190 >). Many
 191    aspects of configuration can be done here, including temporarily disabling
 192    <SPAN
 193 CLASS="APPLICATION"
 194 >Privoxy</SPAN
 195 >.
 196   </P
 197 ></LI
 198 ><LI
 199 ><P
 200 >   The primary configuration files for cookie management, ad and banner
 201    blocking, and many other aspects of <SPAN
 202 CLASS="APPLICATION"
 203 >Privoxy</SPAN
 204 >
 205    configuration are the <A
 206 HREF="actions-file.html"
 207 >actions
 208    files</A
 209 >. It is strongly recommended to become familiar with the new
 210    actions concept below, before modifying these files. Locally defined rules
 211    should go into <TT
 212 CLASS="FILENAME"
 213 >user.action</TT
 214 >.
 215   </P
 216 ></LI
 217 ><LI
 218 ><P
 219 >
 220    Some installers may not automatically start
 221    <SPAN
 222 CLASS="APPLICATION"
 223 >Privoxy</SPAN
 224 > after installation.
 225   </P
 226 ></LI
 227 ></UL
 228 ></P
 229 ></DIV
 230 ><DIV
 231 CLASS="NAVFOOTER"
 232 ><HR
 233 ALIGN="LEFT"
 234 WIDTH="100%"><TABLE
 235 WIDTH="100%"
 236 BORDER="0"
 237 CELLPADDING="0"
 238 CELLSPACING="0"
 239 ><TR
 240 ><TD
 241 WIDTH="33%"
 242 ALIGN="left"
 243 VALIGN="top"
 244 ><A
 245 HREF="installation.html"
 246 >Prev</A
 247 ></TD
 248 ><TD
 249 WIDTH="34%"
 250 ALIGN="center"
 251 VALIGN="top"
 252 ><A
 253 HREF="index.html"
 254 >Home</A
 255 ></TD
 256 ><TD
 257 WIDTH="33%"
 258 ALIGN="right"
 259 VALIGN="top"
 260 ><A
 261 HREF="quickstart.html"
 262 >Next</A
 263 ></TD
 264 ></TR
 265 ><TR
 266 ><TD
 267 WIDTH="33%"
 268 ALIGN="left"
 269 VALIGN="top"
 270 >Installation</TD
 271 ><TD
 272 WIDTH="34%"
 273 ALIGN="center"
 274 VALIGN="top"
 275 >&nbsp;</TD
 276 ><TD
 277 WIDTH="33%"
 278 ALIGN="right"
 279 VALIGN="top"
 280 >Quickstart to Using <SPAN
 281 CLASS="APPLICATION"
 282 >Privoxy</SPAN
 283 ></TD
 284 ></TR
 285 ></TABLE
 286 ></DIV
 287 ></BODY
 288 ></HTML
 289 >