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