fteMigrateLogger: migrate an FTE 7.0 database logger to MQ 7.5 or later
If you want to migrate the configuration of an existing stand-alone database logger from IBM® WebSphere® MQ File Transfer Edition 7.0.1 or later to IBM WebSphere MQ 7.5 or later, use the fteMigrateLogger command.
- Be a member of the mqm group (if the mqm group is defined on the system).
- Be a member of the group named in the BFG_GROUP_NAME environment variable (if one is named).
- Have no value set in the BFG_GROUP_NAME environment variable when the command is run.
If you have configured a stand-alone database logger to run as a Windows service, you cannot migrate that logger's configuration using the fteMigrateLogger command. If you run the fteMigrateLogger command on a logger configured to run as a Windows service, the command produces an error and does not continue. Alternatively, if you include the -f parameter, the command completes but produces a warning.
Before you run the fteMigrateLogger command, stop the database logger whose configuration you want to migrate on IBM WebSphere MQ File Transfer Edition 7.0.
If you run the command with the -f parameter, only the information about the logger is refreshed. If a required file is missing, the command fails. Specifically, the following properties files and .mqsc file associated with the logger configuration are migrated:
Name of the file migrated by the fteMigrateLogger command | Information |
---|---|
wmqfte.properties | The wmqfte.properties file is based on installation.properties in IBM WebSphere MQ 7.5 or later |
command.properties | |
coordination.properties | |
coordination_queue_manager.mqsc | |
databaselogger.properties or other properties file specified using the -file parameter | The databaselogger.properties is used to create the logger.properties file in IBM WebSphere MQ 7.5 or later. |
Syntax
Parameters
- -loggerName logger_name
- Required. The name that you want to give to the migrated logger configuration in IBM WebSphere MQ 7.5 or later. For more information about logger names, which are new for IBM WebSphere MQ 7.5 see logger_name parameter.
- -config configuration_directory
- Required. The path to the configuration directory for the installation that the logger configuration is being migrated from.
- -credentialPath credentials_path
- Required. Defines the location to migrate the credential
information to. This parameter can either be a directory path where existing credential files
are present or a new location to receive a new credential file. For z/OS platforms this can be a pre-existing partitioned data set extended
(PDSE), either with existing members to be updated, or without existing members to include a
new member for these credentials.Note: If a PDSE is used, it must be variable block.
- -file properties_file
- Optional. Specifies the database logger properties file to migrate. This parameter is required only if the properties file does not use the following default name and path: configuration_directory/coordination_qmgr_name/databaselogger.properties
- -f
- Optional. Forces migration even if some of the configuration files that are typically migrated conflict with the existing configuration. For example, if there is a mismatch a between the database logger properties files on IBM WebSphere MQ File Transfer Edition and the properties files on IBM WebSphere MQ 7.5 or later, specifying the -f parameter means this mismatch is ignored.
- -p configuration_options
- Optional. This parameter determines the set of configuration options that is used to locate the logger configuration to migrate. Use the name of a set of configuration options as the value of the -p parameter. By convention, this is the name of a coordination queue manager. If you do not specify this parameter, the default set of configuration options is used. For more information, see MFT configuration options on Multiplatforms.
- -? or -h
- Optional. Displays command syntax.
Example
In this example, the configuration of a stand-alone database logger located in /var/ibm/WMQFTE/config is migrated to IBM WebSphere MQ 7.5 and is named FTELOGGER1:fteMigrateLogger -loggerName FTELOGGER1 -config /var/ibm/WMQFTE/config
-credentialPath /home/user1/FTELOGGER1
Return codes
- 0
- Command completed successfully.
- 1
- Command ended unsuccessfully.
After running the fteMigrateLogger command
To verify the migration, after you have successfully run the fteMigrateLogger command, start the database logger whose configuration you have migrated on IBM WebSphere MQ 7.5 or later, using the fteStartLogger command.