Update encrypted data using MigrateEncryptedInfo

You can change the merchant key and update the encrypted data using the command line tool, MigrateEncryptedInfo. This utility supports two ways of specifying the values of the merchant keys. One is to provide the actual values of the old and new merchant keys as command line arguments. The other is to retrieve the values through the Key Locator Framework.

AIX|Linux|Solaris:

Before running the MigrateEncryptedInfo.sh utility, ensure that the user ID that runs the utility (wasuser) has full permission to access files and subfolders in the WC_installdir/instances/ instance directory.

(Oracle) Before running the MigrateEncryptedInfo script for Oracle 9i databases, set the UNDO table space to a sufficiently large size by setting the datafile for the UNDO table space to autoextend with maxsize unlimited. From an SQLPlus prompt, enter the following command

alter database datafile undotablespace datafile autoextend on
maxsize unlimited;

Run the MigrateEncryptedInfo utility as follows:

1. Back up your database, following the instructions in your database engine documentation.

2. Windows: Log on using a Windows user ID with Administrator authority.

3. AIX|Linux|Solaris: Switch to the WAS user ID (for example, wasuser):

   su - WC_non_root_user
   
   
   

4. Stop the WC_instance application server in the WAS console. If it is running, use the WAS "stopServer" script to stop it.

5. Windows: For DB2 databases, open a DB2 command window. For Oracle databases, open a regular command window.

6. Switch to the WC_installdir\bin directory.

7. Run the MigrateEncryptedInfo utility

   The MigrateEncryptedInfo tool generates the following log files:

   • CCInfoMigration.log

   • MKChangeUserAndCCInfoMigration.log

   • MigrateEncryptedInfoError.log

   in the following directory:

   • WC_userdir/instances

   • WC_installdir/logs

   You should review the information in these log files and ensure they do not contain any error messages.

8. Start the WebSphere Commerce instance.

9. Run the following command:

   • AIX|Linux|Solaris: WC_installdir/bin/config_ant.sh -DinstanceName= instance UpdateEAR

   • I5/OS:

     WC_userdir/bin/config_ant.sh -DinstanceName= instance UpdateEAR

   • Windows: WC_installdir/bin/config_ant.bat -DinstanceName= instance UpdateEAR

10. Restart your WebSphere Commerce instance.

 

Related tasks

Updating encrypted data using Configuration Manager
Updating encrypted data using MigrateEncryptedInfo