System Management Hub 8.2 allows you to migrate users from System Management Hub 8.1 to the latest product installation. The MigrationTool.bat (or .sh) executable starts a tool that migrates users from products that use System Management Hub 8.1 to the corresponding products that use System Management Hub 8.2.
Note:
The tool migrates users only to installed, upgraded products. If a
user is available in the previous version but the same product is not upgraded
by the new installation, the tool does not migrate that user. In addition, you
cannot migrate users from a particular old version product and use them in new
version products that differ from the original product.
The following tasks describe the usage of the tool and outline the commands that you can perform with it.
To start and use the migration tool
Start the migration tool in the following directory:
Software
AG_directory\InstanceManager\bin\MigrationTool.bat (or .sh)
The following commands are available with the tool:
help
You use this command to display more information in the console window about the available commands in the migration tool. The exact syntax and brief description of the command is displayed.
set
You use this command to specify values to the parameters required by the tool. For more information about setting the mandatory tool parameters, see Setting Tool Parameters.
migrate
You use this command to start the migration of users. For more
information about the migrate command, see
Migrating Users.
gui
You use this command to start the tool in graphical mode. For more information about the graphical user interface of the tool, see Starting the Migration Tool in Graphical Mode.
exit
You use this command to stop and exit the tool.
Enter a command that you want to perform and follow the instructions.
For more information about starting the tool and migrating users silently, see Migrating Users Silently.
The MigrationTool.bat (or .sh) executable tool has mandatory parameters that must be set prior to user migration. These parameters define the installation directories of System Management Hub version 8.1 and 8.2. The parameter that defines the installation directory of System Management Hub 8.2 is set by default during the installation of that product. However, if you need to define a different directory, the tool allows you to manually set a new installation directory for System Management Hub 8.2.
You can set the installation directory parameters as configuration properties within the .bat executable file when you open it for editing. Thus, the configuration remains persistent and the tool can be used without specifying any other configuration settings with each invocation.
To set the parameters in the .bat executable
Open the following directory:
Software
AG_directory\InstanceManager\bin\
Locate and open the MigrationTool.bat (or .sh) file for editing.
Enter the following parameter -Dpath.smh81= before the
-Dpath.smh82= parameter as it is displayed in the sample code
excerpt.
-Dpath.smh81="<installation_directory_of_SMH_8.1>" -Dpath.smh82="%INSTALL_HOME%"
Save and close the MigrationTool.bat file.
Alternatively, you can provide the parameters to the tool when you start it in the console window.
To set the parameters when you start the tool in the console
window
Start a console window.
Open the following directory:
Software
AG_directory\InstanceManager\bin\
Locate and start the MigrationTool.bat (or .sh) file by specifying the corresponding configuration settings (optionally, you can add commands) in the console window as well.
For more information about specifying configuration setting and executing commands in the console window when you start the tool, see Migrating Users Silently.
Example:
>MigrationTool.bat path.smh81="<installation_directory_of_SMH_8.1>" path.smh82="<installation_directory_of_SMH_8.2>"
>MigrationTool.sh path.smh81="<installation_directory_of_SMH_8.1>" path.smh82="<installation_directory_of_SMH_8.2>"
Another way to configure the System Management Hub installation
directories in the tool is to start it and configure the parameters using the
set command. The settings that you provide with the
set command are applicable only for the current
invocation of the tool. You must configure these settings every time you start
the tool.
To set the parameters using the console window
Start the MigrationTool.bat (or .sh) executable file.
Enter "set" and then press Enter.
Note:
This step, in which you configure the location of the registry
file, appears only on UNIX based operating systems.
On the Specify the path for regfile of SMH 8.1 Y/N ? enter "Y" and then press Enter.
Specify the registry directory and file of System Management Hub 8.1 and press Enter.
If the registry file that you specify does not exist or the entry is invalid, the tool allows you to re-enter the directory that hosts the registry file of SMH 8.1.
On the Specify the path for installation of SMH 8.1 Y/N ? enter "Y" and then press Enter.
Specify the installation directory of System Management Hub 8.1 and press Enter.
If the directory that you specify does not exist or the entry is invalid, the tool allows you to re-enter the directory that hosts the installation of version 8.1.
On the Specify the path for installation of SMH 8.2 Y/N ? enter "Y" and then press Enter.
Specify the installation directory of System Management Hub 8.2 and press Enter.
If the directory that you specify does not exist or the entry is invalid, the tool allows you to re-enter the directory that hosts the installation of version 8.2.
The MigrationTool.bat (or .sh) executable tool allows you to migrate users from System Management Hub 8.1 to System Management Hub 8.2 flexibly using a set of predefined migration commands. Depending on the particular business case, the tool allows you to migrate all available users at one go, migrate all users of a particular product at one go, or migrate single users from products with versions 8.1 to 8.2.
The instructions below outline the usage of the different sub-commands
that are available with the migrate command of the
tool.
To migrate users
Start the MigrationTool.bat (or .sh) executable file.
Enter "migrate" and then press Enter.
Note:
If you did not specify any of the mandatory tool parameters, such
as installation directories of the products which users you want to migrate,
the tool allows you to specify those parameters at this stage. For more
information, see Setting Tool
Parameters.
The tool displays the available sub-commands for the
migrate command.
help
You use this command to display more information in the console window about the available commands in the migration tool. The exact syntax and brief description of the command is displayed.
list
You use this command to list all available users in both installation directories for versions 8.1 and 8.2.
all
You use this command to start the migration of all available users from version 8.1 to 8.2.
product
You use this command to start the migration of all users of a
specific product. The names of the available products are displayed when you
list all available user entries (using list
command).
single
You use this command to migrate single users from version 8.1 to
8.2. The names of the available users are displayed when you list all available
user entries (using list command).
cancel
You use this command to stop and exit the
migrate command. The tool allows you to enter a
command from the initial set of commands. For more information, see
Migrating System Management Hub
Users.
Enter a command that you want to perform and follow the instructions.
The MigrationTool.bat (or .sh) executable tool allows you to migrate users from System Management Hub 8.1 to System Management Hub 8.2 silently using a set of predefined migration parameters (settings or commands). Similarly to the console based or GUI based migration and depending on the particular business case, the tool allows you to set configuration parameters, migrate all available users at one go, migrate all users of a particular product at one go, or migrate single users from products with versions 8.1 to 8.2.
The instructions below outline the silent invocation and usage of the different commands that are available with the tool.
To migrate users silently
Start a console window.
Open the following directory:
Software
AG_directory\InstanceManager\bin\
Locate and start the MigrationTool.bat (or .sh) file by specifying the configuration settings or commands in the console window.
The following table outlines the parameters (settings or commands) that you can use with the silent invocation of the tool:
| Parameter | Description |
|---|---|
path.regfile.smh81="<SMH_8.1_registry_file_directory>" |
Specify the directory and the registry file of System Management Hub 8.1. This parameter can be used only on UNIX based operating systems. |
path.smh81="<installation_directory_of_SMH_8.1>" |
Specify the installation directory of System Management Hub 8.1. |
path.smh82="<installation_directory_of_SMH_8.2>" |
Specify the installation directory of System Management Hub 8.2. |
migrate="all.users" |
Migrate all available users from System Management Hub 8.1 to 8.2. The tool migrates only users that are created in and used by product versions which are installed on the system and use System Management Hub 8.1 and 8.2 respectively. |
migrate="all.users.for.product" |
Migrate all available users for a particular product that uses System Management Hub. The tool migrates users only if versions of the product are installed and use System Management Hub 8.1 and 8.2 respectively. To start this command, you must set the
|
product="product
name" |
Specify a product which users you want to migrate. This parameter is mandatory when you migrate all users of a product or a single user. |
migrate="single.user" |
Migrate a single users of a particular product that uses System Management Hub. The tool migrates the user only if versions of the product are installed and use System Management Hub 8.1 and 8.2 respectively. To start this command, you must set the
|
user="user
name" |
Specify a user which you want to migrate. This parameter is mandatory when you migrate a single user only. |
Example
MigrationTool.bat path.smh81="<installation_directory_of_SMH_8.1>" migrate="all.users"
MigrationTool.bat path.smh81="<installation_directory_of_SMH_8.1>" path.smh82="<installation_directory_of_SMH_8.2>" migrate="single.user" product="<product_name>" user="<user_name>"
MigrationTool.sh path.regfile.smh81="<SMH_8.1_registry_file_directory>" path.smh81="<installation_directory_of_SMH_8.1>" path.smh82="<installation_directory_of_SMH_8.2>" migrate="single.user" product="<product_name>" user="<user_name>"
When you start the MigrationTool.bat (or .sh) executable tool in console mode, you can switch to the graphical mode of the tool using the corresponding command. The graphical tool displays the configured installation directories of System Management Hub 8.1 and 8.2 and the corresponding users in both directories. The graphical mode allows you to perform the same commands from the console mode of the tool in a more flexible environment.
The instructions below outline the graphical mode of the tool and the commands which you can execute with it.
To start the GUI mode of the tool
Start the MigrationTool.bat (or .sh) executable file.
Enter "gui" and then press Enter.
The tool starts in graphical mode.
Specify the installation directories of System Management Hub version 8.1 and 8.2. Click the button on the right hand side of the corresponding field.
Note:
On UNIX based operating systems, specify the location of the
registry file of System Management Hub version 8.1 as well.
The tool displays the available users in both installation directories. You can filter the users by selecting the following options:
Select the users you want to migrate from System Management Hub 8.1 to System Management Hub 8.2.
You cannot select for migration users that are colored in red. The tool colors in red the following entries:
Users that are already migrated to the newer product.
Users that are created within products which are not available with the newer installation.
Click .
When you migrate the users from System Management Hub version 8.1 to 8.2 and if you want to exit the tool, click .