MigrateEncryptedFiles utility

The MigrateEncryptedFiles utility updates the encrypted information in configuration files from 3DES encryption to AES encryption, and sets the encryption mechanism to AES.

Parameter values

checkAESFilesFlag

Checks if the current encryption mechanism is set as AES_Files.

checkInstanceAESFilesFlag

Checks if the current instance encryption mechanism is set as AES_Files.

instance_name

The name of the WebSphere Commerce instance with which we are working (for example, demo).

checkProductAESFilesFlag

Checks if the current runtime product encryption mechanism is set as AES_Files.

restoreProductBackupFiles

Restores the product backup files.

restoreInstanceBackupFiles

Restores the instance backup files.

MigrateCustomizedFiles

Migrates the runtime customized files.

Usage

1. To migrate configuration files to use AES encryption:

   1. Go to the following directory:

      • WC_installdir/bin

      • (Developer) WCDE_installdir\bin

   2. Run the MigrateEncryptedFiles utility:

      • (AIX) (Linux) (IBM i) MigrateEncryptedFiles.sh

      • (Windows) MigrateEncryptedFiles.bat

      • (Developer) MigrateEncryptedFiles.bat

   3. Verify that the utility completed successfully:

      1. Review the information in the log file to ensure that it does not contain any error messages:

         • WC_installdir/logs/MigrateEncryptedFiles_timestamp.log

      2. Review the following file and ensure that the AES_FILES parameter is set to true:

         • (AIX) (Linux) (IBM i) (Windows) WC_installdir/xml/product.xml

         • (AIX) (Linux) (IBM i) (Windows) WAS_installdir\profiles\instance_name\installedApps\instance_name_cell\instance_name.ear\xml\config\wc-server.xml

         • (Developer) workspace_dir\WC\xml\config\wc-server.xml

2. To verify the current encryption mechanism to ensure that it is set as AES_Files:

   1. Go to the following directory:

      • WC_installdir/bin

      • (Developer) WCDE_installdir\bin

   2. Run the MigrateEncryptedFiles utility to check for the flag:

      • (AIX) (Linux) (IBM i) MigrateEncryptedFiles.sh checkAESFilesFlag

      • (Windows) MigrateEncryptedFiles.bat checkAESFilesFlag

      • (Developer) MigrateEncryptedFiles.bat checkAESFilesFlag

   3. Verify the utility results.

3. To verify the current instance encryption mechanism to ensure that it is set as AES_Files:

   1. Go to the following directory:

      • WC_installdir/bin

      • (Developer) WCDE_installdir\bin

   2. Run the MigrateEncryptedFiles utility to check for the flag:

      • (AIX) (Linux) (IBM i) MigrateEncryptedFiles.sh checkInstanceAESFilesFlag -DinstanceName=instance_name

      • (Windows) MigrateEncryptedFiles.bat checkInstanceAESFilesFlag -DinstanceName=instance_name

      • (Developer) MigrateEncryptedFiles.bat checkInstanceAESFilesFlag -DinstanceName=instance_name

   3. Verify the utility results.

4. To verify the current runtime product encryption mechanism to ensure that it is set as AES_Files:

   1. Go to the following directory:

      • WC_installdir/bin

      • (Developer) WCDE_installdir\bin

   2. Run the MigrateEncryptedFiles utility to check for the flag:

      • (AIX) (Linux) (IBM i) MigrateEncryptedFiles.sh checkProductAESFilesFlag

      • (Windows) MigrateEncryptedFiles.bat checkProductAESFilesFlag

      • (Developer) MigrateEncryptedFiles.bat checkProductAESFilesFlag

   3. Verify the utility results.

5. To restore the product backup files:

   1. Go to the following directory:

      • WC_installdir/bin

      • (Developer) WCDE_installdir\bin

   2. Run the MigrateEncryptedFiles utility to restore the files:

      • (AIX) (Linux) (IBM i) MigrateEncryptedFiles.sh restoreProductBackupFiles

      • (Windows) MigrateEncryptedFiles.bat restoreProductBackupFiles

      • (Developer) MigrateEncryptedFiles.bat restoreProductBackupFiles

   3. Verify the utility results.

6. To restore the instance backup files:

   1. Go to the following directory:

      • WC_installdir/bin

      • (Developer) WCDE_installdir\bin

   2. Run the MigrateEncryptedFiles utility to restore the files:

      • (AIX) (Linux) (IBM i) MigrateEncryptedFiles.sh restoreInstanceBackupFiles -DinstanceName=instance_name

      • (Windows) MigrateEncryptedFiles.bat restoreInstanceBackupFiles -DinstanceName=instance_name

      • (Developer) MigrateEncryptedFiles.bat restoreInstanceBackupFiles -DinstanceName=instance_name

   3. Verify the utility results.

7. To migrate the product customized files:

   1. Go to the following directory:

      • WC_installdir/bin

      • (Developer) WCDE_installdir\bin

   2. Run the MigrateEncryptedFiles utility to migrate the files:

      • (AIX) (Linux) (IBM i) MigrateEncryptedFiles.sh MigrateCustomizedFiles -DinputFile=absoluteInputFile

      • (Windows) MigrateEncryptedFiles.bat MigrateCustomizedFiles -DinputFile=absoluteInputFile

      • (Developer) MigrateEncryptedFiles.bat MigrateCustomizedFiles -DinputFile=absoluteInputFile

   3. Verify the utility results.

8. To migrate the runtime instance customized files:

   1. Go to the following directory:

      • WC_installdir/bin

      • (Developer) WCDE_installdir\bin

   2. Run the MigrateEncryptedFiles utility to migrate the files:

      • (AIX) (Linux) (IBM i) MigrateEncryptedFiles.sh MigrateCustomizedFiles -DinputFile=absoluteInputFile -DinstanceName=instance_name

      • (Windows) MigrateEncryptedFiles.bat MigrateCustomizedFiles -DinputFile=absoluteInputFile -DinstanceName=instance_name

      • (Developer) MigrateEncryptedFiles.bat MigrateCustomizedFiles -DinputFile=absoluteInputFile -DinstanceName=instance_name

   3. Verify the utility results.