Novell ACCESS MANAGER 3.1 SP1 - GATEWAY GUIDE Manual page 6

3 Server Configuration Settings
3.1 Viewing and Updating the Configuration Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
3.2 Saving, Applying, or Canceling Configuration Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
3.3 Starting and Stopping the Access Gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
3.3.1
3.3.2
3.3.3
3.3.4
3.3.5
3.3.6
3.4 Changing the Name of an Access Gateway and Modifying Other Server Details . . . . . . . . . . 82
3.5 Setting Up a Tunnel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
3.6 Setting the Date and Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
3.7 Customizing Error Pages on the Gateway Appliance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
3.7.1
3.7.2
3.8 Configuring Network Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
3.8.1
3.8.2
3.8.3
3.8.4
3.8.5
3.9 Customizing Logout Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
3.9.1
3.9.2
3.10 Configuring X-Forwarded-For Headers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
3.11 Upgrading the Access Gateway Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
3.12 Exporting and Importing an Access Gateway Configuration . . . . . . . . . . . . . . . . . . . . . . . . . 100
3.12.1
3.12.2
3.12.3
4 Access Gateway Maintenance
4.1 Gateway Appliance Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
4.1.1
4.1.2
4.1.3
4.2 Configuring Proxy Service Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
4.2.1
4.2.2
4.2.3
4.2.4
4.2.5
4.2.6
4.3 Monitoring Access Gateway Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
4.3.1
4.3.2
4.4 Monitoring Access Gateway Alerts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
4.4.1
4.4.2
4.5 Enabling Access Gateway Audit Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
4.6 Managing Server Health . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
4.6.1
4.6.2
6 Novell Access Manager 3.1 SP1 Access Gateway Guide
Updating the Access Gateway. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Restarting the Access Gateway Service Provider . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Starting the Access Gateway Service Provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Stopping the Access Gateway Service Provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Restarting the Access Gateway Appliance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Stopping the Access Gateway Appliance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Customizing the Error Pages by Using the Default Template . . . . . . . . . . . . . . . . . . 86
Customizing and Localizing Error Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Viewing and Modifying Adapter Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Viewing and Modifying Gateway Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Viewing and Modifying DNS Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Configuring Hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Adding New Network Interfaces to the Gateway Appliance . . . . . . . . . . . . . . . . . . . 97
Customizing Applications to Use the Access Gateway Logout Page . . . . . . . . . . . . 98
Customizing the Access Gateway Logout Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Exporting the Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Importing the Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Cleaning Up and Verifying the Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Configuring Log Levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Interpreting Log Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Configuring Logging of SOAP Messages and HTTP Headers . . . . . . . . . . . . . . . . 109
Determining Logging Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Calculating Rollover Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Enabling Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Configuring Common Log Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Configuring Extended Log Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Configuring the Size of the Log Partition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Viewing Access Gateway Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Viewing Cluster Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Reviewing Java Alerts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Configuring Access Gateway Alerts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Health States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Monitoring the Health of an Access Gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
75
107