Editing the aceagent.cfg File
The aceagent.cfg file in the /netscape_home_directory/plugins/aceagent
directory is used to configure the ACE/Agent when the
Web service is started. Because most of the parameters in this
file are set by the ACE/Agent
Administration applet, you should only
open the file to edit the following settings:
- [AdminList]
- the usernames of those users who
have permission to administer the ACE/Agent using the
ACE/Agent Administration applet.
- DomainData - the "Domain Secret" that is unique
to your domain. The ACE/Agent embeds this 64-character
string into the cookies that it distributes to
tokenholders.
- ShowFiles -
controls the behavior of the file tree display in the
Select Files to Secure dialog box of the ACE/Agent
Administration applet.
If the
ShowFiles parameter is set to 1,
you will be able to designate individual
files on the server for ACE/Agent protection.
If the ShowFiles
parameter is set to 0, only the directory icons will appear in
the file tree.
- maxconcurrentlogins
- controls the number of users who can hit the WebID
authentication pages (passcode.htm, newpin.htm,
etc.) at any given time. The default value for this
parameter is 128.
Note: This
parameter does not
restrict the number of users who can access your
Web server. It is only used by the ACE/Agent to allocate
sufficient shared memory space to the WebID
authentication process. If you expect that a large number
of users will hit the WebID authentication pages or if
the users experience frequent "Web
Server busy, please try again later" errors,
increase the value of the maxconcurrentlogins
parameter accordingly.
The value of this parameter can be any positive number,
so long as it does not exhaust the server's memory
resources (each authentication uses 900 bytes of memory).
For example, setting the maxconcurrentlogins
parameter to 100 would result in a
shared memory allocation of 90K for the WebID
authentication process.
To edit the aceagent.cfg file:
- cd to the netscape_home_directory/plugins/aceagent
directory.
- Using a text editor, such as vi,
open the aceagent.cfg file.
- Edit the parameters:
- the DomainData parameter
should contain the 64-character domain secret
- if you will enable ACE/Agent protection on
individual files, set ShowFiles
to 1
- set the maxconcurrentlogins
value according to the number of users who will hit the
WebID authentication pages at any given time
- [AdminList] should
contain the login ids of all the users who will
administer the ACE/Agent. Each name must be defined as a
separate parameter.
For example, if jsmith and pmarlowe will all administer
the ACE/Agent settings, your [AdminList] would
look like this:
[AdminList]
0=root
1=admin
2=jsmith
3=pmarlowe
- Close and save the file.