Squid Web Proxy Server for SCO OpenServer 5.0 Release and Installation Notes

System requirements
Installing and removing Squid
    Installing Squid
    Previous Installations
    Starting Squid
    Removing Squid
Additional Configuration
Obtaining Product Updates
Obtaining Product Support
Licensing Information
Documentation

Squid Web Proxy Server is a free, high-speed Internet proxy-caching program that works with a web server to allow users fast access to cached Internet and Intranet pages. Most firewall proxies do not store copies of Internet data returned to a user, but refetch the information each time it is requested. By caching previously requested pages, Squid can reduce the time to serve Internet and Intranet information to users and save valuable networking bandwidth. Squid also offers features such as Transparent Caching and Acceleration. See the Squid User's Guide at http://www.squid-cache.org/Doc/Users-Guide for more information.

The following notes apply only to the supported Squid web proxy server Release 2.3STABLE2 installed from the Skunkware 2000 CD on OpenServer 5.0 systems.

System requirements

Squid software
Squid documentation

Installing and removing Squid

Installing Squid

To install Squid, use custom(ADM).

See your OpenServer 5.0 documentation for details.

Previous installations

The Open Server Release 5 Squid installed from Skunkware 2000 is not upgradeable from any previously installed Skunkware Squid package. Installation will overwrite any existing, previously installed Open Server 5 Squid software. If you have a previous version of the Open Server 5 Squid package installed it is recommended that you make a backup of it before installing this newer version.

The Skunkware Squid conflicts directly with any previously installed versions of Squid from Open Server Release 5 Optional Services 'squid' packages, or from the Open Source Squid organization web site. If the Open Server Release 5 Optional Services of Open Source Squid is installed, it must be removed before installing the Skunkware 2000 Squid package. Before removing the Skunkware or Open Source Squid package, it is recommended that you make a backup of it before installing this version of the software.

Starting Squid

To enable and start Squid, use the /etc/squid script:

/etc/squid enable

Options accepted by /etc/squid include start, stop, enable, disable, query, restart, and rotate. See Squid(1M) man page for details.

Removing Squid

To remove a layered product or patch, use custom(ADM).

See your OpenServer 5.0 documentation for details.

Additional Configuration

Squid installed from Skunkware 2000 by default configures itself for immediate use. Following are some additional configuration options which you may choose to employ.
Configuration changes should be make in

/usr/local/squid/etc/squid.conf

IMPORTANT NOTE:

If the server is running, it will need to be restarted before any changes can take effect. By default, Squid uses 100M of disk space for storing cached documents. On a dedicated proxy server, this value is likely to be too small. The appropriate value to change is "cache_dir". See the configuration file for details. After changing this value, it is necessary to recreate the cache directories using the -z switch before starting Squid:

/usr/local/squid/bin/squid -z
/etc/squid start

By default, Squid uses 8M of RAM for storing "hot" (very popular) replies. One a dedicated proxy server, this value is likely to be too small. the appropriate value to change is "cache_mem".
By default, acls (access control lists) prevent users from connecting to the proxy server, with the exception of localhost. In order to allow access to others, it will be necessary to add an acl for the appropriate users. Information on creating acls as well as examples of acls may be found in the acl section of the User's Guide.
By default, Squid error messages are in the same language as the installed machine's locale. In order to change the language of the Squid error messages, simply change the symbolic link

/usr/local/squid/etc/errors

to point to the appropriate directory in

/usr/local/squid/etc/locale.

Obtaining Product Updates

For product updates, patches, and other product assistance, visit the SCO Downloads page:

http://www.sco.com/downloads

Obtaining Product Support

Support for Squid on Open Server Release 5.0.6 installed from the Skunkware 2000 CD is provided by SCO.
Visit the SCO Support web site for the latest information, patches, and support options:

http://www.sco.com/support/

Licensing Information

Squid 2.3STABLE2 is licensed under the GNU General Public License (version 2).

Documentation

Squid 2.3STABLE2 for SCO Open Server 5 includes the User's Guide in /usr/local/squid/docs/Users-Guide. There is also a man page installed as /usr/man/html.ADM/squid.ADM.html, available through the man command or through SCOhelp. At this time, the included User's Guide is the most current release. Check http://www.squid-cache.org/ for future releases of the User's Guide and for additional available documentation, such as the FAQ.

One other source of information is Squid's configuration file,

/usr/local/squid/etc/squid.conf,

which is heavily commented.

Software:	SCO OpenServer 5.0.4, 5.0.5, or greater
RAM:	>8MB
Disk Space:	4MB free disk space