2.1 Installing a Login Method

You have three ways of installing a login method for use in NetIQ eDirectory:

  • nmasinst utility (UNIX and Windows), which allows you to install login methods into eDirectory.

  • NetIQ iManager (UNIX and Windows), which allows you to install login and post-login methods into eDirectory.

2.1.1 Using the nmasinst Utility to Install a Login Method

From the server console command line, enter:

nmasinst -addmethod admin.context treename config.txt_path [-h hostname[:port]] [-w password|file:<filename>|env:<environment_variable>] [-checkversion]

  • admin.context: The admin name and context.

  • treename: The name of the eDirectory tree where you are installing the login method.

  • config.txt_ path - The complete or relative path to the config.txt file of the login method. A config.txt file is provided with each login method.

  • [-h hostname[:port]]: (Optional) The hostname and port of the server. Use this if eDirectory is not running on the default port. You can also specify the IP address. eDirectory 9.0 supports both IPv4 and IPv6 addresses. For example:

    • IPv4: -h 127.0.0.1:8443

    • IPv6: -h [2001:db8::6]:8443

  • [-w password|file:<filename>|env:<environment_variable>]: This option allows you to specify the password using one of the following methods:

    • On the command line. For example: -w n

    • Through a file. For example: -w file:/tmp/passwd

    • Through an environment variable. For example: -w env:PASSWD

  • [-checkversion]: This option reports an error if the installed method version is the same or newer than the method version being installed.

If the login method already exists, nmasinst updates it.

2.1.2 Using NetIQ iManager to Install a Login or Post-Login Method

  1. Launch NetIQ iManager.

  2. Authenticate to the eDirectory tree as an administrator or a user with administrative rights.

  3. On the Roles and Tasks menu, click NMAS > NMAS Login Methods.

  4. Click New.

  5. Browse for and select the login method (.zip) file you want to install, then click Next.

  6. Follow the installation wizard to completion.