Getting Started Guide
Welcome to PureMessage for UNIX
How PureMessage Combats Spam
PureMessage Components
Using the PureMessage Documentation
Deployment Strategies
Deploying PureMessage
Post-Installation Testing
Testing with a Sub-Group of Users
Testing with a Full Domain
Deployment
Server Deployment Options
Single-Server Deployment
Multi-Server Deployment: Two Servers
Multi-Server Deployment: Three Servers
Configuring Optional Components
Quarantine Digests
Centralized or Consolidated Quarantine
Server Groups
Perimeter Protection
End User Web Interface
Groups Web Interface
Gathering User Feedback
Configuration and Tuning
Tuning Spam Detection
Configuring the Policy Script
Optimizing Performance
Configuring a Local Caching DNS Server
Installing PureMessage for UNIX
Prerequisites
Supported Platforms
Supported Mail Transfer Agents
Other Prerequisites
Utilities
Port Usage
Memory and CPU Requirements
Obtaining the PureMessage Distribution
PureMessage Download Server
CD-ROM Distribution
Tarball Distribution
Upgrading PureMessage from a Tarball Distribution
PureMessage Installation
Full Installation
Custom Installation
Custom Installation Example: Two Servers
Validating the Installation Script
Post-Installation Procedures
Setting Preferences for Unscannable Attachments
Configuring End User Web Interface Authentication
Configuring Http/Https Access to the End User Web Interface
Configuring Log Searching
Rotating PureMessage Log Files
Connecting PureMessage to PostgreSQL
Configuring Server Groups
Testing PureMessage Operations
Configuring Trusted Relays
Installing Additional Components
Upgrading from a Trial License to a Full License
Upgrading PureMessage Components
Working with Snapshots
Creating Snapshots
Restoring Snapshots
Deleting Snapshots
Uninstalling PureMessage
Configuring External Mail Transfer Agents
Configuring an External Sendmail Installation
Configuring Sendmail
Configuring Sendmail Switch
Configuring Sendmail Aliases for Quarantine Digests
Configuring IP Blocking (External Sendmail Version)
Configuring an External Postfix Installation
Obtaining Postfix
Configuring Postfix
Configuring Postfix to Enable Digest Release by Email
Configuring Postfix Aliases for Quarantine Digests
Configuring IP Blocking (External Postfix Version)
MTA Level IP Blocking
Upgrading to PureMessage for UNIX
Upgrading PureMessage
Single-Server Upgrade
Multi-Server Upgrade
Validating the Upgrade Program
Updating to PostgreSQL 8
Quick Reference Guide
Starting and Stopping PureMessage
PureMessage and Mail Servers
PureMessage Services
PureMessage Manager
Command-Line Interface
Policy Engine
About PureMessage Mail Filtering
Lists and Maps
Message-Handling Options
Spam-Handling Options
Virus-Handling Options
Policy-Handling Options
Quarantine
End User Web Interface
Groups Web Interface
Central Server Management
Reports
Application Program Interface
Manager Reference
Dashboard Tab
Using the Manager Interface
Changing Your Password
Policy Tab
Creating and Restoring Policy Backups
Adding Policy Resources to Publications
Editing the Policy
Policy Rules Order
About Tests
Message Characteristics
Test Expressions
Operators
About Actions
Actions Defined
Template Variables
Adding a New Rule
Editing an Existing Rule
Managing the Repository
About Default Policy Snippets
Adding a Disclaimer
Adding a Header
Catching Viruses
Default Internal Hosts Treatment
Detecting Spam
Quarantining Spam Messages
Reject Messages Above 100K
Adding a Snippet to the Policy
Adding a Snippet to the Repository
Changing the Name/Description of a Snippet
Editing a Snippet with the Manager
Editing a Snippet in the Source File
Deleting a Snippet from the Repository
Testing the Current Policy
Using Lists and Maps
Creating Lists or Maps
Match Types
Wildcard Usage
About PureMessage Default Lists
Editing Lists
Editing Maps
Testing Lists or Maps
Managing Lists and Maps
Using Anti-Virus and Anti-Spam Settings
Setting Anti-Virus Options
Managing Anti-Spam Rules
Viewing Anti-Spam Rules
Modifying Anti-Spam Rules
Creating New Anti-Spam Rules
Configuring Anti-Spam Options
Quarantine Tab
Managing the Quarantine
Performing a Simple Quarantine Query
Performing a Advanced Quarantine Query
Viewing Quarantined Message Details
Managing Quarantined Messages
Setting End User Options
Configuring End User Features
Configuring/Testing End User Authentication
About End User Authorization Methods
Managing End User Lists
Adding an End User Whitelist
Editing an End User Whitelist
Deleting an End User Whitelist
Adding an End User Blacklist
Editing an End User Blacklist
Deleting an End User Blacklist
Managing Quarantine Digest Rules
Adding Quarantine Digest Rules
Editing Quarantine Digest Rules
Deleting Quarantine Digest Rules
Consolidating the Default Digest Types
Setting Quarantine Digest Options
Managing the Quarantine Digest Users List
Adding Users to a Digest List
Editing a Digest List Entry
Deleting an Entry from a Digest List
Creating Customized Digest Lists
Managing the Notifications Address Map
Adding Redirects to the Address Map
Editing Redirects in the Address Map
Deleting Redirects from the Address Map
Reports Tab
Report Descriptions
Viewing Reports
Modifying Reports
Exporting Reports
Scheduling Reports
Local Services Tab
Managing Background Services
Using the Background Services Table
Managing the Anti-Virus Service
Changing Anti-Virus Settings
Managing the HTTPD (Manager) Service
Configuring SSL
Generating a Self-Signed Certificate
Configuring Server IP Access Control
Configuring Logging
Browsing the Activity Logs
Creating Administrator Accounts
Editing Administrator Accounts
Creating Administrator Groups
Editing Administrator Group Accounts
Managing the HTTPD (RPC/UI) Service
Configuring Access to the HTTPD (RPC/UI) Service
Configuring the RPC Server Location
Setting the End User Web Interface Server
Generating a Self-Signed Certificate for the End User Web Interface
Managing the Log Search Index Service
Managing the IP Blocker Service
Managing the Milter (Policy) Service
Editing Basic Milter Settings
Changing Milter Configuration Options
Viewing Milter Activity Logs
Managing the PostgreSQL Service
Managing the Queue Runner Service
Managing the Scheduler Service
Managing the SMTP (Postfix) Service
Configuring Postfix Content Filtering
Reconfiguring the Postfix Service
Configuring Postfix for TLS Encryption
Managing the SMTP (Sendmail) Service
Reconfiguring the Sendmail Service
Running the Configuration Wizard
Managing Scheduled Jobs
Scheduled Job Descriptions
Scheduling a Job
Scheduling Jobs in the Manager
Using the Local Services Tab Sidebar
Viewing Central Server Logs
Setting Global Options
Setting Log Watch Options
Enabling or Disabling MTA IP Blocking
Setting Auto Refresh
Server Groups Tab
Managing Hosts
Adding a Host
Editing a Host
Managing Services on Remote Hosts
Logging in to a Remote Host
Deleting a Host
Managing Groups
Creating a Group
Adding Hosts to a Group
Generating a Group Report
Deleting a Group
Managing Publications
Creating Publications
Modifying Publications
Synchronizing Publications
Configuring and Distributing Policy Settings
Configuring and Distributing Anti-Spam Settings
Deleting Publications
Support Tab
Managing Package Repositories
Relocating Repositories
Adding a Repository
Deleting a Repository
Managing Snapshots
Creating a Snapshot
Restoring a Snapshot
Deleting a Snapshot
Sending a Support Request
Sharing Data with Sophos
Enabling Data Sharing
Administrator's Reference
PureMessage Utilities
Install, Startup, Shutdown
Configuration Utilities
Update, Uninstall and Relocate
PureMessage Services
PureMessage Manager
Mail Filter Service
IP Blocker Service
PureMessage Database
End User Web Interface
PureMessage Scheduler
Scheduled Jobs Syntax
Server Groups Management
Default Publications
Administrative Groups
How Groups Work
Managing Groups
Creating a Group
Deleting a Group
Adding Members to a Group
Deleting Members from a Group
Managing Administrator Accounts
Creating an Administrator Account
Creating a Full-Access Administrator Account
Deleting an Administrator Account
Adding an Administrator Account to a Group
Removing an Administrator Account from a Group
Setting Group Access Rights
Viewing Group Access Rights
Viewing All Access Rights
Viewing a Specific Access Right
Customizing the Groups GUI
Creating a Policy Setting
Creating a Group List
Deleting a Group List
Adding and Deleting Custom Quarantine Search Reasons
Adding and Deleting Custom Log Search Reasons
Creating a Group-Specific Template
Deleting a Group-Specific Template
Viewing and Managing Search Results
Quarantine Search
Searching the Quarantine
Viewing Quarantine Search Results
Viewing Message Details
Downloading Attachments
Viewing Status Details
Managing Quarantine Search Results
Approving a Message
Forwarding a Message
Saving a Message
Deleting Messages
Log Search
Searching the Logs
Viewing Log Search Results
Viewing Message Details
Viewing and Managing Reports
Viewing a Report
Generating a Report
Exporting a Report
Creating a Custom Policy Report
Example: Creating a Custom Report
Example: Creating a Custom Report (With Overwrite)
Generating a Self-Signed Certificate for the Groups Web Interface
Tutorial: Groups Setup
Creating Groups
Adding Members to Groups
Creating Administrator Accounts
Adding Administrator Accounts to Groups
Creating a Custom Group Policy List and Rule
Adding and Defining a Policy Setting
Adding a Group Document
Adding a Group Banner
Granting Access Rights
Policy Configuration
Policy Overview
The Default PureMessage Policy
Part One: Internal Hosts
Part Two: External Hosts
Part Three: External Hosts, Lists
Part Four: External Hosts, Spam Probabilities
Default PureMessage Policy Script
Policy Rules
Tests
Actions
Lists
Address Maps
CDB Lists and Maps
Policy Repository
Populating Lists and Maps via LDAP
Customizing Policies
Example: Check Messages for Offensive Words
Example: Add Corporate Information to Outbound Messages
Example: Archive Messages from a Group of Users
Example: Quarantine Messages from Fake Senders
Example: Run Per-Recipient Tests
Testing Policies
Backing Up and Reverting Policies
Applying Policies to the Contents of the Quarantine
Spam Detection
About Anti-Spam Rules
Test Types
Test Scores
Configuring Spam Detection
Viruses
Unscannable Attachments
Uncleanable Attachments
Updating Virus Heuristics
Quarantine Administration
Quarantine Management
Quarantine Directories and Files
Quarantine Indexing
Changing the Quarantine indexing database
PureMessage PostgreSQL Command-Line Programs
Consolidated vs. Centralized Quarantines
Consolidating Quarantined Messages from Multiple Servers
Centralized Quarantine Management
Managing Quarantined Messages
Expiring Quarantined Messages
Digests Management
Digest Configuration
Consolidating Digests Generated for a Single User
Centralizing Quarantine Digests
Configuring Quarantine Digests for Java System Messaging Server (JSMS)
Generating Quarantine Digests
Scheduling Automatic Quarantine Tasks
Scheduling Digest Tasks
Message Store Management
End User Management
Configuring Http/Https Access
Adjusting the GMT Offset for the End User Web Interface
Statically Linking to the End User Web Interface in a Digest
Disabling the End User Web Interface
Adding Custom Graphics to the End User Web Interface
User Documentation
Logs and Reports
PureMessage Reports
PureMessage Logs
Message Log Syntax
Other Log File Syntax
Preventing Reporting on Unscannable Data
Adding Attachment Information
Log Watch Options
PureMessage Monitor
PureMessage Monitor Overview
PureMessage Monitor Scheduled Jobs
Troubleshooting
Why aren't messages being scanned for spam?
Why didn't PureMessage quarantine a message that is spam?
Why has the spam catch rate suddenly declined?
What happens to messages sent to is-spam?
Troubleshooting Quarantine Digests
Digests Are Not Generated
Some Users Are Not Receiving Digests
Users Can't Release Quarantined Messages
Error Message: Can't call method min_digest_id on an undefined value
Troubleshooting the End User Web Interface
Appendices
Glossary
Release Notes / Known Issues
Documentation for Related Applications
Policy Script Tutorial
Policy Script Syntax Overview
Actions
Blocks
Controls
if
else
stop
Tests
Match-Types
Lists
Strings
Numeric Comparison
Regular Expressions
Compound Tests, allof and anyof
Comments
PureMessage Default Policy Overview
PureMessage Sieve Extensions
policy.siv
Policy Script 1: Scan and Deliver Internal Messages
Policy Script 2: Scan External Mail for Viruses
Policy Script 3: Deliver External Whitelisted Messages
Policy Script 4: Deliver External Messages to Anti-Spam Opt-Outs
Policy Script 5: Quarantine External Blacklisted Messages
Policy Script 6: Calculate Spam Probability, Modify and Deliver
Customizing the PureMessage Default Policy
Adding a Recipient
Adding a Header
Detecting Spam
Quarantining Spam Messages
Catching Viruses
Discarding Messages Based on Specific Characteristics
Adding a Disclaimer
Regular Expression Primer
About Regular Expressions
Building Simple Patterns
Matching Simple Strings
Searching with Wildcards
Searching for Special Characters
Ranges and Repetition
Ranges, {min, max}
Repetition, ? * +
Quantifier Summary
Using Conditional Expressions
Grouping Similar Items in Parentheses
Matching Sequences
Building Simple Character Classes
Preventing Matches with Character Classes
Compound Character Classes
Character Class Summary
Matching Locations within a String
More Regex Resources
Copyrights and Trademarks
OpenLDAP License
SEE License
Sendmail License
Contacting Sophos