This section shows how to launch the mmigrate utility manually. BMC recommends that you always use the GUI wizard to migrate older KBs to the latest.
Warning
The manual procedures and the manual execution of the scripts are aimed at experienced and knowledgeable users.
The mmigrate utility is a BMC component that automatically migrates older KBs to the latest, standard KB formats in the current release. It is launched from a computer that has the latest version of the Integration Service.
The mmigrate utility performs the following operations:
You can execute the mmigrate utility to migrate configuration and KB data from BMC ProactiveNet to Infrastructure Management.
There are at least four KBs involved in running the mmigrate utility:
The mmigrate utility supports KB migration for BMC ProactiveNet version 8.0 or later.
When running the mmigrate
command, determine the type of cell you are creating, the old cell directory, and the new cell directory that contains the result of the migration.
The syntax of the mmigrate
command is as follows:
mmigrate [-option] [type] customer_directory output_directory
where,
output_directory is the directory to which the KB is migrated. You must provide this parameter.
Note
Ensure that the parent directory for the output_directory already exists on the computer if it contains multiple folders.
-ap embedded PNET (PPM)
The optional arguments for the mmigrate
command are listed as follows:
-h
displays the online help for the command.-v sets the verbosity level of the mmigrate messages. In the order of severity, the options are VERBOSE, INFORM, WARNING, ERROR, and FATAL.
-v option without a following descriptor sets the trace level to VERBOSE
INFORM is the default level, which does not require the -v option.
-v WARNING
-v ERROR
-v FATAL
The specified level and the next higher severity levels are printed. For example, if you specify -v WARNING, then WARNING, ERROR, and FATAL messages are printed. FATAL messages are never filtered.
Example
mmigrate -aa "C:\tmp\\\PROGRA~1\BMCSOF~1\Impact\\server\etc\simcell2" "C:\Progra~1\BMCSof~1\TrueSight\pw\\server\etc\CLONE_simcell2"
Note
After running the mmigrate
command, if there are any conflicts, you must resolve them manually and recompile the cell.
The table below lists the values that your mmigrate cell type selection assigns to the ServiceModelEnabled
and POMEnabled
variables in the mcell.conf file.
Cell type impact on mcell.conf variables
Type switch | Cell type | POMEnabled | ServiceModelEnabled |
---|---|---|---|
-aa | Admin | No | Yes |
-ae | EM | No | No |
-as | SIM | No | Yes |
-ap | PPM | Yes | Yes |
When executed, the mmigrate utility modifies the following parameter values to ensure that they meet the specified minimum constraints in the indicated configuration files under the installationDirectory\pw\server\etc folder.
ConnectionSetupTimeOut >= 20 seconds
TraceFileSize >= 5 MB
Note
For the TraceFileSize
parameter, the value 0 (zero) indicates no limit to the size of the trace file. For example, if the value of the TraceFileSize
parameter is 0, it is considered an infinite file size and thus meets the constraint of >= 5 MB
.
EventDBCleanupDurationLimit <= 10 seconds
EventDBKeepClosed >= 3d
EventDBSize >= 330k
ServerHostName >= Name of host system
StateBuildSize >= 10 MB
TraceFileSize >= 5MB
TraceFileSize >= 5MB
TraceFileSize >= 5MB
For example, if the mmigrate utility discovers that the ConnectionSetupTimeOut
parameter value is less than 20 seconds, it updates the value to meet the minimum value of 20 seconds.
When it alters a parameter value, the mmigrate utility maintains the original value as a comment prefixed with #
was:. For example, if you execute the mmigrate utility with the -ap
option and it alters the EventDBKeepClosed
, EventDBSize
, StateBuildSize
, and TraceFileSize
parameter values to meet the minimum constraints in the mcell.conf file, the stanzas look as follows:
Before/after comparison: mmigrate impact on configuration files
BEFORE: *************************************************** EventDBKeepClosed=2d EventDBSize=100000 StateBuildSize=1000 TraceFileSize=1M ############## CellDuplicateMode=0 ServiceModelDirectFeed=Yes ServiceModelPublish=Yes AFTER: *************************************************** EventDBKeepClosed=3d # must be at least 3d # was: EventDBKeepClosed=2d EventDBSize=330k # must be at least 330k # was: EventDBSize=100000 StateBuildSize=10M # must be at least 10M # was: StateBuildSize=1000 TraceFileSize=5M # must be at least 5M # was: TraceFileSize=1M ############## CellDuplicateMode=0 ServiceModelDirectFeed=Yes ServiceModelPublish=Yes POMEnabled=Yes ServiceModelEnabled=Yes
The .load files must reference all the customized KB source files that you want the mmigrate utility to merge in the new output directory.
After the mmigrate utility is run, it merges the contents of both the customer load lists and reference load lists in generated .load files, in the following order:
Conflicts identified by the mmigrate utility are marked in the following way:
<<<<<<< your source file name your definition ======= BMC definition >>>>>>> BMC source file name
For example, we have three files:
The ancestor KB has the following definition:
MC_PUBLISH_DATA_CLASS : BMC_Application ISA BMC_ApplicationSystem DEFINES { ApplicationType : ApplicationType; }; END
Your KB definition (yours):
MC_PUBLISH_DATA_CLASS : BMC_Application ISA BMC_ApplicationSystem DEFINES { ApplicationType : ApplicationType; ApplicationEntityName : STRING; }; END
My KB definition (mine):
MC_PUBLISH_DATA_CLASS : BMC_Application ISA BMC_ApplicationSystem DEFINES { ApplicationType : ApplicationType; ApplicationInstanceCount : INTEGER; }; END
The conflict will appear in the merge as follows:
MC_PUBLISH_DATA_CLASS : BMC_Application ISA BMC_ApplicationSystem DEFINES { ApplicationType : ApplicationType; <<<<<<< yours ApplicationEntityName : STRING; ======= ApplicationInstanceCount : INTEGER; >>>>>>> mine }; END
Open the file containing the conflicts, and review the conflicting definitions shown by the conflict markers. Select one of the conflicting definitions or replace it with something else. Save and close the file, and then recompile.
Migrating the configuration of Infrastructure Management cells