NAME

      mximport - performs the data migration import function.

SYNOPSIS

      mximport [ -f <zip file name> ] [ -p <password> ]

      mximport tool allows you to perform the data migration
      import functionality. This is used to import data from an installation of
      HP Insight Control Suite 3.0 or later to an installation of HP Insight
      Control Suite 6.0. This tool takes a zip file as input.

OPTIONS

    mximport recognizes the following options:

    -f    Specifies the name of the zip file. If a file name
     is not specified, the zip file will be read from HPSIM's
     installed location \data\configdata-import with name as Products.zip.

    -p    Specifies the password. Minimum allowed length
     is 8 characters. If a password is not specified along with the command, you
     will be prompted to enter the password. This prevents the clear text password
     from being exposed to unintended eyes. This password is the same one that was
     given for mxexport on the source server.

PRE-REQUISITES

     1. You must be a member of the local windows Administrators group.
     2. The server has HP Insight Control Suite 6.0 or later installed,
        which includes HP SIM 6.0 or later. All HP Insight Control software that
        were installed on source server must be installed on target server as well.
     3. Stop the HP SIM service and all other HP Insight Control software before
        running import function.
     4. The CMS must be a clean installation and have no prior configurations.
     5. All OS and database level user credentials on source CMS must be created on target CMS.
     6. Please refer to section 'Remote SQL Server database settings' for
     more information if a remote database is used for import.

IMPORTANT

     This tool truncates all data from the concerned databases of target before it actually
     imports the data. This does not truncate the newly introduced tables of
     HP Insight Control Suite 6.0 for a migration from a lower version of the Software
     to a higher version. HP recommends that you take a snapshot of all databases
     before proceeding with import. The snapshot may be taken in the following means
     - by running mxexport on the server, or any user specific database backup method.
     The files mx.properties and globalsettings.props of [HPSIM]\config have to be backedup.
     If import fails, the database/files may be recovered from the snapshot, or the whole
     HP Insight Control Suite 6.0 may be re-installed.

     Trusted Certificates are not migrated. Please refer to section 'CONFIGURE AND REPAIR AGENTS'
     for more information on configure/repair Agent settings.

     Custom changes made to the MIB files on the source CMS will be lost after migration.
     User may take a backup of these files and copy them on the target CMS in their own means.

RETURN VALUE

      No return value.
      Note: If one HP Insight Control software fails during import,
      the entire import function fails.

SUPPORTED PLATFORMS

      All versions of HPSIM supported Windows operating system.
      All versions of HPSIM supported SQL server local or remote database.

POST MIGRATION STEPS

      1. HP recommends running the configure and repair agent settings on the
      target CMS against the discovered systems. The options chosen should include
      to reset the trap, indication destinations as well as reconfigure
      any certificates used by the System Management Homepage,iLO or OA
      for Single sign-on. Please see section Configure and Repair for more details.

      2. After migrating to HP SIM 6.0, sign in to HP SIM, and run the
      Daily System Identification task to ensure that all your associations
      are updated correctly.

      To run the daily Identification task:
         1. Select Tasks & Logs>View All Scheduled Tasks. The All Scheduled Tasks
         page appears.
         2. Select the Daily System Identification task.
         3. Click Run Now.

EXAMPLES


      mximport

      To import data without specifying file name and password.

      mximport -p d&e128Pa

      To import data by specifying a password.

      mximport -f c:\data\Products.zip

      To import data by specifying a filename

      mximport -f c:\data\Products.zip -p d&e128Pa

      To import data by specifying a filename and a password.

REMOTE SQL SERVER DATABASE SETTINGS

      1. The target CMS and the remote SQL database server must be
      in the same domain.
      2. The folder "configdata-import" under [HPSIM]\data on the target server
      must be shared and granted with full premissions.

CONFIGURE AND REPAIR AGENTS

CRA Query and Task XML files are created and placed under
[HPSIM]\config\migration\CRA. The CRA Query XML file is named as HPSIMCRAQuery.xml
and CRA Task XML file is named as HPSIMCRATask.xml. This CRA task is not scheduled
and will start running when it is fed into the CMS. It runs only once.
The settings given in the CRA Task XML is applicable to all the discovered
managed nodes by default. The CRA Task can not exist without a CRA Query.

User has a choice to modify the values in the XML files. User may refer to HPSIM's
documentation on configure and repair agents.

The below table shows the supported CRA task settings and its default and allowed values.

1. Create subscription to WBEM events:
XML Property name : argument_wbem
Default value : yes
Other allowed values : no

2. Configure SNMP: Set read community string:
XML Property name : argument_snmpread
Default value : public
Other allowed values : any allowed string
Note: This will also enable the SNMP communication between HP SIM
Central Management Server (CMS) and the SNMP agent on the managed system.

3. Configure SNMP: Set traps to refer to this instance of HP SIM:
XML Property name : argument_snmptrap
Default value : yes
Other allowed values : no
Note: A ReadWrite string will be created automatically
on Windows systems.

4. Configure secure shell (SSH) access authentication:
XML Property name : argument_ssh
Default value : host
Other allowed values : user

Host based authentication: All users from this instance of
HP SIM will be authenticated on the managed system.
User based authentication: Each user has to be
authenticated on the managed system

5. Set Trust Relationship:
XML Property name : argument_trust
Default value : certificate
Other allowed values : empty
Note: This enables HP SIM users to connect to the
System Management Homepage, Onboard Administrators, Integrated Lights-Out
(version 2 and later), and VCA using the HP SIM certificate for authentication.
This will deploy HP SIM certificate to the managed system.

6. Use sign-in credentials:
XML Property name : usesignincred
Default value : true
Other allowed values : false
Note: If this property is set as false, then User needs to
configure the credentials separately. The credentials configured using
this option will be applied for all systems.

The CRA Query XML will be having the full DNS names or names of all the
discovered managed nodes. The 'value' tag can be removed/added/modified
based on User's choice.

Note: If full DNS name is not present for a device,
its system name should be specified. The IPAddress of the managed node
is not allowed to specify for the 'value' tag.

Each HP Insight Control Software may create its own set of CRA task/query
XML files. The names of the XML files would reflect the software names.

User has the choice to create/run any number of CRA tasks/queries
having different set of configurations to be applied for different set of devices,
provided the names of the tasks and queries are different from the ones that are
already present in the CMS.

Steps to run a CRA Task/Query:

mxquery -af [CRA Query XML name]
mxtask -cf [CRA Task XML name]

AUTHOR

      mximport was developed by the Hewlett-Packard Company.

DEBUG SETTINGS

      By default, the debug log is disabled for migration. To turn on the debug log,
      open the file migration.props under [HPSIM]\config\debugsettings, and modify
      the value of the property 'GlobalEnable' to true and set the log level to 20
      or above for finest logging. The debug log file will be created under
      [HPSIM]\logs with name 'migration_log4j.log'. A backup log file will be 
      created with name 'migration_log4j_backup.log'.