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