Chapter 7. DMF Maintenance Utility
Prev |  | Next

## Chapter 7. DMF Maintenance Utility

| Note: The information in this chapter is for DMF server installation only.

You can use the `dmmaint` utility to view DMF release-specific news and to view information related to dependencies of which you should be aware before you start the current version of DMF.

You can use the `dmmaint` utility to install your temporary or permanent licenses.

| Caution: Ensure that you have installed your FLEXlm license file for this release. The FLEXlm license included with your DMF release is temporary; when you obtain your permanent DMF license, you must restart DMF. For information about FLEXlm licensing requirements, see Chapter 8, “FLEXlm License Requirements”.

To use the `dmmaint` utility, ensure that your `DISPLAY` environment variable is set up, and then enter the following command:

    /usr/sbin/dmmaint &

If `DISPLAY` is not defined, `dmmaint` reverts to line mode, which has menu selections that are equivalent to the fields and buttons on the graphic user interface. Line mode is provided for remote log in, and is not recommended for general use.

The screen shown in Figure 7-1 is then displayed:

Figure 7-1. DMF Version Maintenance Display

The fields and buttons of the `DMF Version Maintenance` display are described as follows:

Field/Button | Description
Active Version | Displays the current, installed version of DMF.
Configure | Lets you customize the DMF configuration file for the selected version of DMF. If this is the first time you have configured DMF, a window appears telling you that there is no configuration file. You are asked which file you would like to use as a basis for the new configuration. You may choose an existing configuration file or one of several sample files that are pre-configured for different types of media-specific processes (MSP)/library servers (LS). If you are modifying an existing configuration, a window appears that asks if you would like to modify the existing configuration file or use an alternate file. If you choose an alternate file, you see the same window that you would see if this were a new configuration. After you choose a file to use as a basis, an editing session is started (in a new window) that displays a copy of that configuration file. You can make changes as desired. After exiting from the editor, you are prompted for confirmation before the original configuration file is replaced with the edited copy. For more information on the parameters you can use in your DMF configuration file, see the `dmf.conf(5)` man page (available from the Help button). The DMF Administrator's Guide also provides information on DMF configuration.
Inspect | Runs the `dmcheck(8)` program to report errors. After you have created a configuration file for DMF, you can click the Inspect button, which runs `dmcheck` to report any errors in the configuration. If there are errors, you can click the Configure button, make changes, and continue to alternate between Configure and Inspect until you are satisfied that the configuration is correct.
Dependencies | Lets you view the dependencies file (`/usr/relnotes/dmf/ch1.z` on IRIX; `/usr/share/doc/dmf-version_number/readme` on Linux). This file contains information on any dependencies that exist for this version of DMF, such as operating system levels supported, patch requirements, and so on.
News | Lets you view the news file (`/usr/relnotes/dmf/ch2.z` on IRIX; `/usr/share/doc/dmf-version_number/news` on Linux). This file contains information such as new DMF features, changes in the products, descriptions of fixed bugs, and future product plans.
License Info | Lets you view all FLEXlm license information for the selected version of DMF. The display shows the host name and FLEXlm host ID, which you need when you apply for a DMF permanent license. The name of the license file is also displayed, as is a short description of the state of any DMF license within the file.
Update License | Lets you make changes to the FLEXlm license file. An editing session is started in a new window displaying a copy of the contents of the license file. You can add or delete licenses as desired. After you exit the editor, positive confirmation is requested before the original license file is replaced by the modified copy.
Help | Lets you view the `dmmaint(8)` or `dmf.conf(5)` man page.

## Completing Initial Configuration

The following procedure uses `dmmaint` to complete the initial configuration of DMF:

Procedure 7-1. Running `dmmaint`

1. Select Dependencies to read about all the hardware and software requirements that must be fulfilled before running DMF.

2. Select News to read about what is new with this revision of DMF.

3. If you have not yet installed a FLEXlm license for DMF, select the Update License button and use your mouse to copy and paste your license into the file. Close the window. Select License Info and examine the output to verify that the license is installed correctly.

4. Select Configure to begin configuration of the current revision of DMF. The first time that you select this button, `dmmaint` will prompt you for the file you want to use as a basis for the configuration. Choose to use your existing configuration file or one of the sample files provided. If you choose to use your existing configuration, you will need to add new parameters to implement new features. `dmmaint` then opens an editing window containing the configuration file, allowing you to modify the configuration to suit your needs. When you exit the window, `dmmaint` will ask if you want to make your changes permanent. If so, click `OK`.

5. You may make additional editing changes to your configuration by reselecting Configure. If you are modifying an existing configuration, a window appears that asks if you would like to modify the existing configuration file or use an alternate file. If you choose an alternate file, you see the same window that you would see if this were a new configuration.

6. Click the Inspect button, which runs `dmcheck` to report any errors in that configuration. If there are errors, you can click the Configure button, make changes, and continue to alternate between Configure and Inspect until you are satisfied that the configuration is correct.

7. If you do not want DMF to be automatically started and stopped, enter the following command (you must be running as `root`):

       chkconfig dmf off

For information about how to start and stop DMF, see the `dmfdaemon(8)` and `dmdstop(8)` man pages.

Prev | Table of Contents | Next
Chapter 6. Installing DMF on Linux Systems |  | Chapter 8. FLEXlm License Requirements