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 TARGET="_top"
 113 ><SPAN
 114 CLASS="QUOTE"
 115 >"actions
 116  files"</SPAN
 117 ></A
 118 >.
 119  <TT
 120 CLASS="FILENAME"
 121 >default.action</TT
 122 >, is the main actions file. Local
 123  exceptions should best be put into <TT
 124 CLASS="FILENAME"
 125 >user.action</TT
 126 >.</P
 127 ><P
 128 > A <A
 129 HREF="filter-file.html"
 130 TARGET="_top"
 131 ><SPAN
 132 CLASS="QUOTE"
 133 >"filter file"</SPAN
 134 ></A
 135 > (typically
 136  <TT
 137 CLASS="FILENAME"
 138 >default.filter</TT
 139 >) is new as of <SPAN
 140 CLASS="APPLICATION"
 141 >Privoxy
 142  2.9.x</SPAN
 143 >, and provides some of the new sophistication (explained
 144  below). <TT
 145 CLASS="FILENAME"
 146 >config</TT
 147 > is much the same as before.</P
 148 ><P
 149 > If upgrading from a 2.0.x version, you will have to use the new config
 150  files, and possibly adapt any personal rules from your older files.
 151  When porting personal rules over from the old <TT
 152 CLASS="FILENAME"
 153 >blockfile</TT
 154 >
 155  to the new actions files, please note that even the pattern syntax has
 156  changed. If upgrading from 2.9.x development versions, it is still
 157  recommended to use the new configuration files.</P
 158 ><P
 159 > A quick list of things to be aware of before upgrading: </P
 160 ><P
 161 > <P
 162 ></P
 163 ><UL
 164 ><LI
 165 ><P
 166 >   The default listening port is now 8118 due to a conflict with another
 167    service (NAS).
 168   </P
 169 ></LI
 170 ><LI
 171 ><P
 172 >
 173     Some installers may remove earlier versions completely. Save any
 174     important configuration files!
 175   </P
 176 ></LI
 177 ><LI
 178 ><P
 179 >   <SPAN
 180 CLASS="APPLICATION"
 181 >Privoxy</SPAN
 182 > is controllable with a web browser
 183    at the special URL: <A
 184 HREF="http://config.privoxy.org/"
 185 TARGET="_top"
 186 >http://config.privoxy.org/</A
 187 >
 188    (Shortcut: <A
 189 HREF="http://p.p/"
 190 TARGET="_top"
 191 >http://p.p/</A
 192 >). Many
 193    aspects of configuration can be done here, including temporarily disabling
 194    <SPAN
 195 CLASS="APPLICATION"
 196 >Privoxy</SPAN
 197 >.
 198   </P
 199 ></LI
 200 ><LI
 201 ><P
 202 >   The primary configuration file for cookie management, ad and banner
 203    blocking, and many other aspects of <SPAN
 204 CLASS="APPLICATION"
 205 >Privoxy</SPAN
 206 >
 207    configuration is in the <A
 208 HREF="actions-file.html"
 209 TARGET="_top"
 210 >actions
 211    files</A
 212 >. It is strongly recommended to become familiar with the new
 213    actions concept below, before modifying these files. Locally defined rules
 214    should go into <TT
 215 CLASS="FILENAME"
 216 >user.action</TT
 217 >.
 218   </P
 219 ></LI
 220 ><LI
 221 ><P
 222 >
 223    Some installers may not automatically start
 224    <SPAN
 225 CLASS="APPLICATION"
 226 >Privoxy</SPAN
 227 > after installation.
 228   </P
 229 ></LI
 230 ></UL
 231 ></P
 232 ></DIV
 233 ><DIV
 234 CLASS="NAVFOOTER"
 235 ><HR
 236 ALIGN="LEFT"
 237 WIDTH="100%"><TABLE
 238 WIDTH="100%"
 239 BORDER="0"
 240 CELLPADDING="0"
 241 CELLSPACING="0"
 242 ><TR
 243 ><TD
 244 WIDTH="33%"
 245 ALIGN="left"
 246 VALIGN="top"
 247 ><A
 248 HREF="installation.html"
 249 >Prev</A
 250 ></TD
 251 ><TD
 252 WIDTH="34%"
 253 ALIGN="center"
 254 VALIGN="top"
 255 ><A
 256 HREF="index.html"
 257 >Home</A
 258 ></TD
 259 ><TD
 260 WIDTH="33%"
 261 ALIGN="right"
 262 VALIGN="top"
 263 ><A
 264 HREF="quickstart.html"
 265 >Next</A
 266 ></TD
 267 ></TR
 268 ><TR
 269 ><TD
 270 WIDTH="33%"
 271 ALIGN="left"
 272 VALIGN="top"
 273 >Installation</TD
 274 ><TD
 275 WIDTH="34%"
 276 ALIGN="center"
 277 VALIGN="top"
 278 >&nbsp;</TD
 279 ><TD
 280 WIDTH="33%"
 281 ALIGN="right"
 282 VALIGN="top"
 283 >Quickstart to Using <SPAN
 284 CLASS="APPLICATION"
 285 >Privoxy</SPAN
 286 ></TD
 287 ></TR
 288 ></TABLE
 289 ></DIV
 290 ></BODY
 291 ></HTML
 292 >