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