Show TOC

Procedure documentationCreating Administration Users Locate this document in the navigation structure

 

To administrate and monitor the ICM from a browser, you need an administration user. You can create this user with the program icmon. To do so, proceed as follows.

Note Note

You can do the same in the Web Dispatcher with the program wdispmon. This is however usually not necessary, since when the Dispatcher is started with Bootstrap-Option an administration user is automatically created.

End of the note.

Procedure

  1. As user <sid>adm go to the directory where the executables are kept and call up icmon -a pf=<instance profile>.

    The following appears:

    Maintain authentication file

    ============================

    File name (icmauth.txt):

  2. If you are happy with the default file name, press the enter key, otherwise enter a different file name or path.

  3. In the next menu choose a (add user to set).

  4. Enter the user name, then the password twice, the group name, the subject of the X.509 certificate (wildcards allowed, and it can be left empty).

    Example Example

    User Name: icmadm

    Enter Password: *****

    Re-Enter Password: *****

    Group Name admin

    Subject value of client cert: CN=Muster,*

    new entry locally created

    The user created is in group admin, the user is therefore an administration user without administration authorization. In particular this user can create further users in the Web admin interface.

    End of the example.

    Note Note

    If you select another group name other than admin, create a monitoring user that can monitor, but not administrate, the ICM/Web Dispatcher.

    If you want a user to be able to log on only with the X.509 client certificate, you can enter an x as the password (with queries), which makes the following entry (in the example) in file:

    icmadm:x:admin:CN=muster,*

    End of the note.
  5. Choose s (save changes of set to file), to copy your changes from the local buffer to the authorization file.

  6. Choose q, to quit the program.

    Note Note

    You can display the users in the menu by choosing l (list users of set), though you will only see the users in the local buffer. To view the users copied to the file, look in the file or call up icmon ‑a again.

    End of the note.

Result

You have created a user with which you can use the Web administration interface.