Restoring packed MPP log files

Last Updated : Jun 05, 2026 |

About this task

You can use the restorempplogs.sh script to restore the MPP log files that were packed using either the getmpplogs.sh script or the Pack Files Options page available from the Media Server Service Menu.

The restorempplogs.sh script:

  • Restores the call data records

  • Restores the installation logs

  • Restores the process logs, if available

  • Restores the transcriptions and utterances, if available

Procedure

  1. If the MPP was started through the EPM:
    1. Log on to the EPM web interface by using an account with the Administration or Operations user role.
    2. From the EPM main menu, select System Management > MPP Manager.
    3. On the MPP Manager page, use the Selection check box in the MPP server table to select which MPPs you want to change.
    4. Click Stop in the State Commands group.
    5. After the grace period expires, click Refresh to ensure that the state is now Stopped.
    6. Click offline in the Mode Commands.
  2. Log on to Linux on the Experience Portal MPP server.

    • If you are an Avaya Services representative, and use Avaya Enterprise Linux, or if the Avaya Service accounts are installed on this server, log on to the local Linux console as root.

    • Otherwise, log on remotely as a non-root user, and then change the user to root by entering the su - root command.

  3. Restore the log files by entering the bash restorempplogs.sh <path/file.tar.gz> command, where <path/file.tar.gz> is the fully qualified path and file name of the file created by the Pack command or the getmpplogs.sh script.

    If the script finds the file, it displays the following:

    This utility will restore records of type:
 Records
 Installation logs
 Process logs
 Transcriptions & Utterances
from a tar file generated by the getmpplogs script.
If the directories for these records already exist, then 
the directory will be renamed to <directory-YYYYMMDD-HHMM> before the restore.
Press Enter to continue, or press Control-c to cancel
  4. Press Enter to run the script and restore the log files. The script produces output similar to the following: 
    Extracting files from 
'/opt/Avaya/VoicePortal/MPP/tmp/AVPSupport/cl-mpplab-02_Apr_24_2007_14_12_17_MPP.tar.gz'...
 Depending on the amount of data, this may take several minutes.
  Stopping services...
    Checking service 'mpp'
    - stopping: 'mpp'
 - Restoring 'Records'
    Moving existing '/opt/Avaya/VoicePortal/MPP/logs/records' to 
    '/opt/Avaya/VoicePortal/MPP/logs/records-20070424-1419'...
Restoring '/tmp/untar/logs/records' to '/opt/Avaya/VoicePortal/MPP/logs/records'...
    Restoring directory and file permissions...
 - Restoring 'Installation logs'
    Moving existing '/opt/Avaya/VoicePortal/MPP/logs/install' to 
    '/opt/Avaya/VoicePortal/MPP/logs/install-20070424-1419'...
    Restoring '/tmp/untar/logs/install' to '/opt/Avaya/VoicePortal/MPP/logs/install'...
    Restoring directory and file permissions...
 - Restoring 'Process logs'
    Moving existing '/opt/Avaya/VoicePortal/MPP/logs/process' to 
    '/opt/Avaya/VoicePortal/MPP/logs/process-20070424-1419'...
    Restoring '/tmp/untar/logs/process' to '/opt/Avaya/VoicePortal/MPP/logs/process'...
    Restoring directory and file permissions...
 - Restoring 'Transcriptions & Utterances'
    Moving existing '/opt/Avaya/VoicePortal/MPP/logs/transcriptions' to 
    '/opt/Avaya/VoicePortal/MPP/logs/transcriptions-20070424-1419'...
    Restoring '/tmp/untar/transcriptions' to '/opt/Avaya/VoicePortal/MPP/logs/transcriptions'...
Restoring directory and file permissions...
Log Restoration Complete!
INFO: The service 'mpp' will not be automatically restarted by this script.  If you wish to restart 
this service, use the command:
          /sbin/service mpp start
  5. If the hostname of the current machine is different than the hostname stored in the log files, the restorempplogs.sh script displays a warning message alerting you that the names of the log files in the $AVAYA_MPP_HOME/logs/records and $AVAYA_MPP_HOME/logs/transcriptions directories need to be changed so that the hostname included in the filename matches the server’s new hostname.

    When you rename these files:

    • Use the short name for the server instead of the fully qualified domain name.

    • Make sure that the hostname you specify matches the exact server hostname, including case.

    Note:

    If you do not change the log file names, then these records will not be accessible to the EPM server and therefore will not be accessible to any reports created through the EPM.