Chapter 6. DMF Version Maintenance Utility
Prev   Next

Chapter 6. DMF Version Maintenance Utility

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

After you have installed a DMF server release, set the current 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 the current 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 release is temporary; when you obtain your permanent DMF license, you must restart DMF.

For information about FLEXlm licensing requirements, see Chapter 7, “FLEXlm License Requirements”.

In the /usr/dmf/dmbase/version/etc directory, 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:

/usr/dmf/dmbase/version/etc/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:

Figure 6-1. DMF Version Maintenance Display


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 (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_config(5) man page (available from the Help button). The DMF Administrator's Guide for IRIX Systemsalso provides information on DMF configuration.

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. It creates the following symbolic links:

  • /etc/dmf/dmbase - Points to the selected version's base directory

  • /etc/init.d/dmf, /etc/rc0.d/K79dmf, and /etc/rc2.d/S25dmf - Point to the selected version's DMF startup script

  • /usr/include/bapi - Points to the BAPI include files of the selected version

  • /usr/lib[32,64]/libbapi.so and /usr/lib[32,64]/bapi - Point to the BAPI libraries of the selected version

  • /usr/include/dmf - Points to the distributed command API include files of the selected version

  • /usr/lib[32,64]/libdmfusr.so - Points to the libdmfusr.so user command library of the selected version

  • /usr/bin/dmattr, /usr/bin/dmcopy, /usr/bin/dmfind, /usr/bin/dmget, /usr/bin/dmls, /usr/bin/dmput, /usr/etc/dmversion, /usr/etc/dmdate - Point to the commands of the selected version

  • In the /usr/share/catman/u_man/cat1 directory: dmattr.z, dmcopy.z, dmfind.z, dmget.z, dmls.z, and dmput.z

    In the /usr/share/catman/u_man/cat8 directory: dmversion.z and dmdate.z - Point to man pages of the selected versions

  • /usr/lib/locale/C/LC_MESSAGES/sgr_dmf.catand /usr/lib/locale/C/LC_MESSAGES/sgr_dmf.cat.m - Point to the message catalogs of the selected version

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.

dmmaint ensures that the TCPMUX/SGI-DMUSRCMD definition exists in the inetd configuration file, /etc/inetd.conf and copies dmusrcmd to /usr/etc.

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.

Completing Initial Configuration

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

Procedure 6-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 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.

  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. 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.

Prev Table of Contents Next
Chapter 5. Using the inst Utility  Chapter 7. FLEXlm License Requirements