Contents

About this Book

Before You Begin

Downloading Updated Documentation
Suggested Supplementary Reading

The ECXpert Documentation Set

Release Note
Getting Started Guide
Administrator's Handbook
Developer's Handbook
Operations Reference Manual

Audience and Roles
Organization
Conventions Used in This Guide

Generic Names
Typographic Conventions

Part 1 The Partner Agent Server

Chapter 1 Introducing the iPlanet Partner Agent for ECXpert Server

The Partner Agent for ECXpert Client/Server System

Partner Agent Server
Partner Agent Client

Partner Agent Server Features
Partner Agent Server Distribution

Partner Agent Server Programs and Scripts

ECXpert Wrapper
ECXpert ActiveAgents

Partner Agent Server Libraries
Partner Agent Server Section of the ecx.ini File
New MSGFORMATS Messages in Database
ECXpert Member Directories

Pre-configured Settings for Interaction with ECXpert

Default Administrator Username and Password
Default Signing Certificate Password
Default ActiveAgents
Default Security Settings

Starting Partner Agent Server
Stopping Partner Agent Server

Chapter 2 Command Line Utilities

gencerts—Generating Self-issued Certificates
mkpasswd—Changing the Default Administrator Password

mkpasswd

addpasswd—Adding an Administrator Password
importcert—Importing User Certificates
fdx—Command Line FTP Client

Part 2 (Optional) Using the Server Administration System

Chapter 3 (Optional) Using the Administration System

The Administration System

Issuer Certificate
Starting the Administration System
Accessing the Administration System

Navigating the Administration System
Changing System Configurations

Chapter 4 (Optional) Using the Master Server Controls

Server Status

Server Shutdown Options

Shutting Down the Server Now
Scheduling a Shutdown
Stopping a Standalone Server

Server Control

Server Bounce Options

Setting Bounce Options
Manually Bouncing the Server

FTP Server Modes of Operation

Changing the FTP Server Mode

HTTP Server

Server License
User Classes

User Types

Real Users
Anonymous Users
Virtual Users

Default User Classes
Adding a New Class Definition
Enabling or Disabling a Class Definition
Editing a Class Definition
Deleting a Class Definition
Examples of User Classes

Server Messages

Server Startup Messages
Run-time Messages

Cookies
Adding a Server Run-Time Message
Enabling or Disabling a Run-Time Message Entry
Editing a Run-Time Message Entry
Deleting a Run-Time Message Entry

Command Logging

Adding a Command Logging Entry
Disabling or Enabling a Command Logging Entry
Editing a Command Logging Entry
Deleting a Command Logging Entry

Transfer Logging

Adding a Transfer Logging Entry
Enabling or Disabling a Transfer Logging Entry
Editing a Transfer Logging Entry
Delete a Transfer Logging Entry

Passive Mode

Specifying a Base Port and Range for Passive Mode

Mirror Servers

Adding a Mirror Server Entry
Enabling or Disabling a Mirror Server Entry
Editing a Mirror Server Entry
Deleting a Mirror Entry
Example Mirror Entry

Miscellaneous Options

Setting the Administrator Email Address
Setting Usage Monitor Options
Enabling or Disabling Reverse DNS Lookups
Enabling or Disabling Valid User Shell Checks
Setting the Session Timeout

Version Control

Enabling or Disabling Version Control
Taking a Snapshot of the Current Version
Creating a New Baseline

Incremental Version Display

Deleting a Version Entry
Reverting to a Previous Version
Recommended Usage

Chapter 5 (Optional) Using the Server Access Controls

Admin System Host Access

Reordering Rules
Adding a New Admin System Access Rule Entry
Enabling or Disabling an Admin System Access Rule Entry
Editing an Admin System Access Rule Entry
Deleting an Admin System Access Rule Entry
Example of Admin System Access Rule Entry

Partner Agent Server Host Access

Reordering Partner Agent Server Host Access Rule Entries
Adding a New Partner Agent Server Host Access Rule Entry
Enabling or Disabling a Partner Agent Server Host Access Rule
Editing a Partner Agent Server Host Access Rule
Deleting a Partner Agent Server Host Access Rule
Example of Partner Agent Server Host Access Rules

Password Files

Virtual Users
Adding a New Password File Entry
Enabling or Disabling a Password File Entry
Editing a Password File Entry
Deleting a Password File Entry
Editing a Password File

Adding a New Password File Entry
Enabling or Disabling a Password File Entry
Editing a Password File Entry
Deleting a Password File Entry

Editing Permissions for Virtual Users

Rules
Rule Order and Conflict Policy
Virtual Shared Directories
Adding a Virtual Permission Entry
Enabling or Disabling a Virtual Permission Entry
Moving Virtual Permission Entries
Editing a Virtual Permission Entry
Deleting a Virtual Permission Entry
Changing the Conflict Policy
Example of Virtual Permission Entries

Master Virtual User

Virtual Groups

Adding a New Virtual Group Entry
Disabling or Enabling a Virtual Group Entry
Deleting a Virtual Group Entry

Limiting User Access

Adding a New User Limit Entry
Enabling or Disabling a User Limit Entry
Editing a User Limit Entry
Deleting a User Limit Entry

Denying User Access

Denying Access to Users
Allowing Access to Users

Denying Group Access

Denying Access to Groups
Allowing Access to Groups

Anonymous Logins

Enabling or Disabling Anonymous Users
Setting Criteria for Anonymous Passwords

Filesystem Restrictions

Adding a New Filesystem Restriction Entry
Enabling or Disabling a Filesystem Restriction Entry
Editing a Filesystem Restriction Entry
Deleting a Filesystem Restriction Entry

Upload Restrictions

Adding a New Upload Restriction Entry
Enabling or Disabling an Upload Restriction Entry
Editing an Upload Restriction Entry
Deleting an Upload Restriction Entry

Download Restrictions

Adding a New Download Restriction Entry
Enabling or Disabling a Download Restriction Entry
Editing a Download Restriction Entry
Deleting a Download Restriction Entry

Chapter 6 (Optional) Using the Server Security Controls

Secure Sockets Layer

Enabling or Disabling SSL
Modifying the Requirement for Client Certificates
Enabling or Disabling Client Certificate Verification
Adding a New SSL Users Encryption Entry
Enabling or Disabling an Encryption Entry
Editing an Encryption Entry
Deleting an Encryption Entry

User Authentication

Setting User Authentication Options
A Few Things to Know about User Authentication

Login Failures

Changing the Failed Login Threshold

FTP Commands

Setting FTP Command Options
Editing an FTP Command Entry
Deleting an FTP Command Entry

Entrust Configuration
Security Audit

EnGuard Features
Running EnGuard as a Cron Job
Security Audit Control Panel
Browsing Previously Generated Security Audit Reports
Configuring Archival and Distribution of Reports

Archival and Distribution of Security Reports Options

Customizing Reports

Enabling or Disabling Security Checks
Enabling or Disabling Report Settings

Configuring Security Checking Of Anonymous FTP Hierarchy

Excluding a Directory
Removing a Directory from the Excluded List
Excluding a File
Removing a File from the Excluded List

Performing a Security Audit

Chapter 7 (Optional) Using the Server Statistics Controls

Server Usage Monitor

Server Usage Snapshot by User Class
Server Usage Snapshot by Connection

Server Usage Statistics Control Panel

Server Usage Statistics Viewer
Server Usage Statistics Configuration Manager
Server Usage Statistics Generator

Chapter 8 (Optional) Using the Server ActiveAgents

Introducing ActiveAgents

ActiveAgent Server
Environment Variables
Notes on Agent Supplied Cookies
Bundled ActiveAgents

Agent Access

Reordering the Rules
Adding a New Agent Server Host Access Rule Entry
Enabling or Disabling an Agent Server Host Access Rule Entry
Editing an Agent Server Host Access Rule
Deleting an Agent Server Host Access Rule

Agent Server Port
ActiveAgents

Chaining ActiveAgents
Adding a New ActiveAgent Entry
Enabling or Disabling an ActiveAgent entry
Editing an ActiveAgent entry
Deleting an ActiveAgent entry

ActiveAgent Descriptions

Certificate Agent (cert)
User Configuration Agent (config)
Password Authentication Agent (auth)
Login and Logout Agents

Login Agent
Logout Agent

Incoming and Outgoing Agents

Incoming Agents
Outgoing Agents

FTP and HTTP Command Agents

Part 3 Appendices

Appendix A (Optional) Installing a Stand-alone FileDrive Server

FileDrive Server
Hardware Requirements for a Stand-alone Instance of FileDrive Server
Server Distribution

Obtaining a License File

Installing a Stand-alone FileDrive Server

Installing a License File After Installation

Uninstalling a Stand-alone Instance of FileDrive Server
FileDrive Server FAQs

Appendix B (Optional) Using the Partner Agent Server Command Line Client

The Partner Agent Server Command Line Client
Installing the Command Line Client from CD
Starting Partner Agent Server Command Line Client Interactively

Starting the Command Interpreter
Establishing a Connection Automatically
Changing Transfer Protocol Schemes
Operating in Tunnel Mode
Environment Variables
Aborting a File Transfer

Transferring Files

Uploading or Downloading Files Using Shell Scripts
Uploading Files from the Command Line
Uploading Files Interactively
Uploading Files to ECXpert from the Command Line
Uploading Files to ECXpert Interactively
Downloading Files from the Command Line
Downloading Files Interactively
Downloading Files to ECXpert from the Command Line
Downloading Files to ECXpert Interactively
Deleting Files Interactively
Listing Files Interactively

Command Line Options

FTP Command Line Options
HTTP(S) Command Line Options

Interactive Commands

File Naming Conventions
File Transfer Parameters
FTP Interactive Commands
HTTP or HTTPS Interactive Commands

Tracking File Transfers in ECXpert
For more information on using the ECXpert Tracking feature, see the ECXpert Site Administrator's Handbook.Browser Client

Navigate
Download or Delete File
Upload a File

Index