After you have installed the DMF 2.6.3 release, set this DMF release to be the active version of DMF by using the DMF version maintenance utility (dmmaint(8)). This utility handles the setup of all symbolic links that DMF requires to operate normally.
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 this version of DMF.
You can use the dmmaint utility to switch between versions of DMF and 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 2.6.3 release is
temporary; when you obtain your permanent DMF license, you must restart DMF
2.6.3.
For information about FLEXlm licensing requirements, see Chapter 7, “FLEXlm License Requirements”. |
In the directory /usr/dmf/dmbase/version/etc, use the dmmaint utility to select the active version. (version is the version you selected when you downloaded the software). In order to use the dmmaint utility, ensure that your DISPLAY environment variable is set up, and then enter the following command:
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 6-1 is then displayed:
The fields and buttons of the DMF Version Maintenance display are described as follows:
| Field/Button | Description | |
| Root Directory | Lets you set the root directory to be scanned for installed versions of DMF. The default value is /usr. Do not change this directory on IRIX systems. | |
| Active Version | Displays the current active installed version of DMF. If there is no active DMF configured, None is displayed. | |
| Selected Version | Lets you select a specifically installed version of DMF with which to work. You must select a version of DMF to work with before using the Configure, Inspect, Activate, Remove, Dependencies, News, License Info, or Update License buttons. Simply release your mouse button over the version you want to make active. | |
| Configure | Lets you customize the DMF configuration file for the selected version of DMF. If this is the first time you have configured this version of 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 (MSPs). 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 possible parameters you can use in your DMF configuration file, see the dmf_config(5) man page (available from the Help button). | |
| Inspect | Runs the dmcheck(8) program to report errors. After you have created a configuration file for the selected version of DMF, you can 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. | |
| Activate | Lets you make the selected version of DMF the active version. When you click this button, dmmaint runs dmcheck. If the selected version's DMF configuration file contains errors, click Examine errors to determine what is wrong with the configuration. If another version of DMF is already running, you are prompted for confirmation to continue. When it makes the selected version active, dmmaint first stops DMF if it is already running. A symbolic link is created in /etc/dmf/dmbase that points to the selected version's base directory. Also created are the symbolic links /etc/init.d/dmf, /etc/rc0.d/K79dmf, and /etc/rc2.d/S25dmf, which point to the selected version's DMF startup script. chkconfig is used to create a DMF configuration variable and set its value to on. Finally, you are asked if the newly activated version of DMF should be started. | |
| Remove | Lets you remove the selected version of DMF. Positive confirmation is requested. If you click OK, all DMF files and directories for the selected version are removed. If the selected version was also the active version, DMF is stopped, the symbolic links are removed, and the active version becomes None. | |
| Dependencies | Lets you view the dependencies file (/usr/dmf/dmbase/version/Readme) for the selected version. This file contains information on any dependencies that exist for a specific version of DMF, such as operating system levels supported, patch requirements, and so on. | |
| News | Lets you view the news file (/usr/dmf/dmbase/version/News) for the selected version. 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_config(5) man page. |
Procedure 6-1. Running dmmaint
The following procedure uses dmmaint to complete the initial configuration of DMF:
Select Dependencies to read about all the hardware and software requirements that must be fulfilled before running DMF.
Select News to read about what is new with this revision of DMF.
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.
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 dmf_config 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.
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.
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.
When you are satisfied that your configuration is correct, select Activate to make this version of DMF the active one. dmmaint will run dmcheck to check for configuration errors. If any are found, you will be notified and will be allowed to examine those errors. You will then be asked whether you wish to continue to make DMF active in spite of any errors. If so, dmmaint will establish all the necessary symbolic links to make DMF active. It also establishes links to the DMF startup script in /etc/init.d, /etc/rc2.d, and /etc/rc0.d. These links ensure that that DMF will be automatically started whenever your machine is booted and will be automatically stopped during a machine shutdown. If you do not want DMF to be automatically started and stopped, enter the following command after activating DMF (you must be running as root):
chkconfig dmf off
For information about how to start and stop DMF, see the dmdaemon(8) and dmdstop(8) man pages.