7.3 eDirectory Service Manager

The eDirectory Service Manager provides information about available eDirectory services and their states. You can also use the Service Manager to start and stop these services.

Service Manager manages only eDirectory services. This is done with the help of the dsservcfg.xml configuration file, which lists the services to be managed on various platform. It also lets you add or remove services from the list.

You can access the eDirectory Service Manager through the following methods:

7.3.1 Using the Client Service Manager eMTool

The eDirectory Management Toolbox (eMBox) Client is a command line Java client that gives you remote access to the eDirectory Service Manager eMTool. The emboxclient.jar file is installed on your server as part of eDirectory. You can run it on any machine with a JVM. For more information on the Client, see Section 22.1, Using the Command Line Client.

To use the Client Service Manager eMTool:

  1. Run the Client in interactive mode by entering the following at the command line:

    java -cp path_to_the_file/emboxclient.jar  -i
    

    (If you have already put the emboxclient.jar file in your class path, you only need to enter java -i.)

    The Client prompt appears:

     Client>
    
  2. Log in to the server that will run Service Manager by entering the following:

    login -s server_name_or_IP_address -p port_number 
    -u username.context -w password -n
    

    The port number is usually 80 or 8028, unless you have a Web server that is already using the port. The -n option opens a nonsecure connection.

    The Client indicates whether the login is successful.

  3. Enter one of the following Service Manager commands:

    Command

    Description

    service.serviceList

    Lists the available eDirectory services.

    service.serviceStart -n Module_name

    Starts the specified eDirectory service.

    service.serviceStop -n Module_name

    Stops the specified eDirectory service.

    service.serviceInfo -n Module_name

    Displays information for the specified service.

    You can also use the list -t service command in the Client to list the Service Manager options with details. See Listing eMTools and Their Services for more information.

  4. Log out from the Client by entering the following command:

    logout
    
  5. Exit the Client by entering the following command:

    exit
    

7.3.2 Using the Service Manager Plug-In to NetIQ iManager

  1. In NetIQ iManager, click the Roles and Tasks button Roles and Tasks button.

  2. Click eDirectory Maintenance > Service Manager.

  3. Specify the server you want to manage, then click OK.

  4. Authenticate to the selected server, then click OK.

  5. Use the following icons to check the status of any eDirectory service, or to start or stop a service:

    Icon

    Description

    A service is running.

    A service is stopped.

    Starts a service.

    Stops a service.

    A service is running but you can't stop it.