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