Table of Contents
1. Handle System Overview
1.1 Handle Syntax
1.2 Handle Resolution
1.3 Authentication
1.4 Distributed Administration
1.5 Handle Data Types
1.6 Handle System Scalability
1.6.1 Storage
1.6.2 Performance
2. Installation
2.1 Installing Java
2.2 Unpacking the Distribution
2.3 Choosing an Installation Directory
2.4 Running the Setup Program
2.5 Running the Server For the First Time
2.6 How Your Naming Authority is Set Up
3. Using the Handle Administration Tool
3.1 Resolving Handles
3.2 Creating a Handle
3.3 Modifying a Handle
3.4 Removing a Handle
3.5 Running Batch Files
3.5.1 Load Batch file
3.5.2 Authenticate
3.5.3 Submit Batch
3.5.4 Batch Submission Log
3.6 Backing Up a Server
3.7 Listing Handles on a Server
3.8 Homing a Naming Authority
3.9 Unhoming a Naming Authority
3.10 Using Sessions
4. Using the HTTP Proxy
5. Other Tools and Features
5.1 DBTool
5.2 DBList/DBRemove
5.3 Resolver
5.4 Test Tool
6. Batch Operation
6.1 Create Handle Batch Format
6.2 Delete Handle Batch Format
6.3 (Un)Home Naming Authority Batch Format
6.4 Add Handle Batch Format
6.5 Remove Handle Batch Format
6.6 Modify Handle Batch Format
6.7 Authentication Information Format
6.8 Session Setup Information Format
6.9 Handle Value Line Format
7. Advanced Server Configuration
7.1 hdl_http_config
7.2 hdl_tcp_config
7.3 hdl_udp_config
7.4 server_config
7.5 Top Level Settings
8. Understanding the Server Directory
8.1 access.log
8.2 error.log
8.3 config.dct
8.4 $HOME/root_info
8.5 cache.jdb
8.6 handles.jdb
8.7 nas.jdb
8.8 dbtxns.log
8.9 siteinfo.bin
8.10 admpub.bin, admpriv.bin
8.11 pubkey.bin, privkey.bin
8.12 txns
9. Replication
9.1 Setting up a Single Mirror Handle Server
9.2 Setting up a Second Mirror Handle Server
9.3 Additional notes
10. Splitting a Handle Server
11. Using a SQL Database for Storage
12. Frequently Asked Questions
12.1 What do I do if I get a JavaTM out-of-memory error?
12.2 How do I start/restart and stop my Handle server?
12.3 How do I back up my handle database?
12.4 What version of JavaTM should I use?
12.5 How do I administer (create/delete/edit) handles on a machine other than the machine my handle server is running on?
12.6 We're moving our handle service to a new server. Can you tell me what I need to do?
12.7 I'd like to use a relational database to store my handles instead of the one provided in the distribution. Can I do that?