doc/webserver/user-manual/upgradersnote.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <HTML
   3 ><HEAD
   4 ><TITLE
   5 >Note to Upgraders</TITLE
   6 ><META
   7 NAME="GENERATOR"
   8 CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
   9 REL="HOME"
  10 TITLE="Privoxy 3.0.3 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.0.3 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"
  77 >3. Note to Upgraders</A
  78 ></H1
  79 ><P
  80 > There are very significant changes from earlier
  81  <SPAN
  82 CLASS="APPLICATION"
  83 >Junkbuster</SPAN
  84 > versions to the current
  85  <SPAN
  86 CLASS="APPLICATION"
  87 >Privoxy</SPAN
  88 >. The number, names, syntax, and
  89  purposes of configuration files have substantially  changed.
  90  <SPAN
  91 CLASS="APPLICATION"
  92 >Junkbuster 2.0.x</SPAN
  93 > configuration
  94  files will not migrate, <SPAN
  95 CLASS="APPLICATION"
  96 >Junkbuster 2.9.x</SPAN
  97 >
  98  and <SPAN
  99 CLASS="APPLICATION"
 100 >Privoxy</SPAN
 101 > configurations will need to be
 102  ported. The functionalities of the old <TT
 103 CLASS="FILENAME"
 104 >blockfile</TT
 105 >,
 106  <TT
 107 CLASS="FILENAME"
 108 >cookiefile</TT
 109 > and <TT
 110 CLASS="FILENAME"
 111 >imagelist</TT
 112 >
 113  are now combined into the <A
 114 HREF="actions-file.html"
 115 ><SPAN
 116 CLASS="QUOTE"
 117 >"actions
 118  files"</SPAN
 119 ></A
 120 >.
 121  <TT
 122 CLASS="FILENAME"
 123 >default.action</TT
 124 >, is the main actions file. Local
 125  exceptions should best be put into <TT
 126 CLASS="FILENAME"
 127 >user.action</TT
 128 >.</P
 129 ><P
 130 > A <A
 131 HREF="filter-file.html"
 132 ><SPAN
 133 CLASS="QUOTE"
 134 >"filter file"</SPAN
 135 ></A
 136 > (typically
 137  <TT
 138 CLASS="FILENAME"
 139 >default.filter</TT
 140 >) is new as of <SPAN
 141 CLASS="APPLICATION"
 142 >Privoxy
 143  2.9.x</SPAN
 144 >, and provides some of the new sophistication (explained
 145  below). <TT
 146 CLASS="FILENAME"
 147 >config</TT
 148 > is much the same as before.</P
 149 ><P
 150 > If upgrading from a 2.0.x version, you will have to use the new config
 151  files, and possibly adapt any personal rules from your older files.
 152  When porting personal rules over from the old <TT
 153 CLASS="FILENAME"
 154 >blockfile</TT
 155 >
 156  to the new actions files, please note that even the pattern syntax has
 157  changed. If upgrading from 2.9.x development versions, it is still
 158  recommended to use the new configuration files.</P
 159 ><P
 160 > A quick list of things to be aware of before upgrading: </P
 161 ><P
 162 > <P
 163 ></P
 164 ><UL
 165 ><LI
 166 ><P
 167 >   The default listening port is now 8118 due to a conflict with another
 168    service (NAS).
 169   </P
 170 ></LI
 171 ><LI
 172 ><P
 173 >
 174     Some installers may remove earlier versions completely. Save any
 175     important configuration files!
 176   </P
 177 ></LI
 178 ><LI
 179 ><P
 180 >   <SPAN
 181 CLASS="APPLICATION"
 182 >Privoxy</SPAN
 183 > is controllable with a web browser
 184    at the special URL: <A
 185 HREF="http://config.privoxy.org/"
 186 TARGET="_top"
 187 >http://config.privoxy.org/</A
 188 >
 189    (Shortcut: <A
 190 HREF="http://p.p/"
 191 TARGET="_top"
 192 >http://p.p/</A
 193 >). Many
 194    aspects of configuration can be done here, including temporarily disabling
 195    <SPAN
 196 CLASS="APPLICATION"
 197 >Privoxy</SPAN
 198 >.
 199   </P
 200 ></LI
 201 ><LI
 202 ><P
 203 >   The primary configuration files for cookie management, ad and banner
 204    blocking, and many other aspects of <SPAN
 205 CLASS="APPLICATION"
 206 >Privoxy</SPAN
 207 >
 208    configuration are the <A
 209 HREF="actions-file.html"
 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 SUMMARY="Footer navigation table"
 239 WIDTH="100%"
 240 BORDER="0"
 241 CELLPADDING="0"
 242 CELLSPACING="0"
 243 ><TR
 244 ><TD
 245 WIDTH="33%"
 246 ALIGN="left"
 247 VALIGN="top"
 248 ><A
 249 HREF="installation.html"
 250 ACCESSKEY="P"
 251 >Prev</A
 252 ></TD
 253 ><TD
 254 WIDTH="34%"
 255 ALIGN="center"
 256 VALIGN="top"
 257 ><A
 258 HREF="index.html"
 259 ACCESSKEY="H"
 260 >Home</A
 261 ></TD
 262 ><TD
 263 WIDTH="33%"
 264 ALIGN="right"
 265 VALIGN="top"
 266 ><A
 267 HREF="quickstart.html"
 268 ACCESSKEY="N"
 269 >Next</A
 270 ></TD
 271 ></TR
 272 ><TR
 273 ><TD
 274 WIDTH="33%"
 275 ALIGN="left"
 276 VALIGN="top"
 277 >Installation</TD
 278 ><TD
 279 WIDTH="34%"
 280 ALIGN="center"
 281 VALIGN="top"
 282 >&nbsp;</TD
 283 ><TD
 284 WIDTH="33%"
 285 ALIGN="right"
 286 VALIGN="top"
 287 >Quickstart to Using <SPAN
 288 CLASS="APPLICATION"
 289 >Privoxy</SPAN
 290 ></TD
 291 ></TR
 292 ></TABLE
 293 ></DIV
 294 ></BODY
 295 ></HTML
 296 >