Extracting customer data

Last Updated : Jun 21, 2024 |
Prolog information
Metadata
Keywords:
Use this procedure to extract customer data from the old system before you copy and activate it on the new system.
Before you begin
  • Ensure that you performed the required preparation to extract data to a network mount point.
  • To upgrade a VMware system, download the CMS upgrade ISO file from the Avaya Support site.
  1. To begin the extract process, log in to the CMS server with root privileges.
  2. Copy the CMS upgrade ISO file to the CMS server and run the following command to mount the ISO file:
    ADDITIONAL INFORMATION: cd /
    mount <UpgradeISOPath> /mnt
    Tip:
    If the mount fails, you can run the following commands:
    cd /
    unmount /mnt
    mount <UpgradeISOPath> /mnt
  3. Run cd /mnt to switch to the mount location.
  4. Run ./cvue_extract to start the extract process.
    ADDITIONAL INFORMATION:
    The extract process verifies whether CMS supports the platform you are upgrading. If the platform is not supported, a warning such as the following is displayed:
    ***WARNING***
    You are upgrading from a hardware platform that is not supported by CMS. Do not continue if you do not have the proper platform for upgrade available.
    Do you want to continue? (y or n) :
  5. Enter y to continue with the upgrade or n to stop the upgrade until you have the correct hardware ready.
    ADDITIONAL INFORMATION:
    Proceed to the next step if you are continuing with the upgrade.
  6. Review the extract process output to ensure that the CMS converter tool was run successfully.
    ADDITIONAL INFORMATION:
    Information such as the following is displayed:
    Continuing with CMS Upgrade Express ... 
    Admin data will be saved
    /var/tmp/new/adminsave/cmsadmin.saved 
    Converter completed successfully.
  7. Continue reviewing the extract process output to check if ACD 1 is administered.
    ADDITIONAL INFORMATION:
    • If ACD 1 is administered, the extract process continues.
    • If ACD 1 is not administered, you see an error message such as the following: 
      ERROR:
      
ACD 1 is currently administered as a skipped ACD. 
      
CUE cannot upgrade when ACD 1 is a skipped ACD. 
      
Please run cmsadm, add a temporary ACD 1, then run 
      
“./cvue_extract” again.
      
#
      For information about adding a temporary ACD 1, see Checking for ACD 1 and then go back to step 4 to restart the extract process.
  8. If required, upgrade your ACD system (for example, Communication Manager) when you upgrade CMS.
    ADDITIONAL INFORMATION:
    The extract process verifies each ACD to determine if any of the ACDs are administered with an unsupported switch model.
    • If you have an unsupported switch model, enter information about the upgraded switch as indicated in steps 9 to 13.
    • If this CMS release supports all the ACDs, the extract process continues as indicated in step 14.
  9. Enter the upgraded switch model for the ACD.
    ADDITIONAL INFORMATION:
    If no other ACDs are administered with an unsupported switch model, proceed to the next step.
  10. Enter the hostname or IP address of the switch.
    ADDITIONAL INFORMATION:
    A message similar to the following is displayed:
    You have entered the following TCP/IP information for <acd_name> (ACD <acd number>):
    *************************************
    Host name or IP address: <host_name or IP_address>
    *************************************

    If you would like to make changes to the entry above, 
    enter choice (y or n) (default: n):
  11. Do one of the following:
    • If the entry is correct, press Enter to proceed with the extract process.
    • If the assignment is not correct, enter y to return to the previous step.
  12. When prompted, enter the switch TCP port number.
    ADDITIONAL INFORMATION:
    A message such as the following is displayed:
    You have entered the following TCP/IP information for <acd_name> (ACD <acd number>):
    ************************************* 
    TCP Port Number: <port_number>
    *************************************

    If you would like to make changes to the entry above, 
    enter choice (y or n) (default: n):
  13. Do one the following:
    • If you want to make changes to the entry, type y and then repeat the previous step.
    • If the entry is correct, press Enter to proceed.
      If there are more ACDs to be converted to TCP/IP, you are prompted to configure them as indicated in step 10. Otherwise, the extract process continues.
  14. Wait for the extraction of the administration files to be completed.
    ADDITIONAL INFORMATION:
    The extraction might take a few minutes. When it is completed, you see a message such as the following:
    NOTE: Be sure to review the cvuelog for any files 
    to be merged manually in the upgraded system.
  15. Review the messages that are displayed as the extract process continues.
  16. When prompted, select the extract device type.
    ADDITIONAL INFORMATION:
    You should be using a network mount point to extract data. Note that tape drives are no longer supported with the latest CMS releases and USB storage devices are not supported on VMware deployments.
  17. Enter the extract device path when prompted.
    ADDITIONAL INFORMATION:
    When using a network mount point, the extract device path must exist on the CMS server and must be mounted. If the network mount point does not exist or is not mounted, the extract will fail.
  18. Continue reviewing the messages displayed.
    ADDITIONAL INFORMATION:
    Ensure that the extract process writes the administration data to the extract device. A message such as the following is displayed:
    ADDITIONAL INFORMATION: Admin data will be saved to /storage/cue/cvue_extract.tar

    manual_merge/ manual_merge/var/
    . . .
    . . .
    var/spool/cron/ 
    var/yp/
    Extract complete.
    The cvue_extract process is complete.
  19. Enter the following commands to verify that the directory contains upgrade scripts.
    ADDITIONAL INFORMATION: cd /var/tmp/new/adminsave/init.d
    ls -l
    If the scripts do not exist, check for free space on the server. Reboot the server and retry the extract.
  20. Run more /var/tmp/new/var/log/cvuelog to display the temporary upgrade log file.
    1. Check for failure messages (FAIL) or other indications that the extract process was not successful.
      ADDITIONAL INFORMATION:
      This file also contains a list of files that are copied to the new system. The list of files might be useful for later troubleshooting.
  21. Run ls -l /var/tmp/new/adminsave/cmsadmin.saved and review the information displayed.
    1. If the files setup.out, fp.install, and stor.def do not exist or have a file size of zero, escalate though normal channels.