Symptoms
Product may hang under specific circumstances.
There are 2 types of hanging:
- Actual hanging. That is a state similar to a crash. That means that software halts and is doing nothing inside.
- Infinite loop. This means that on the outside the software looks hanging but inside it is doing some actions over and over again.
Usually when a software hangs its process uses either 100% of CPU (especially when it is infinite loop) or does not use CPU and does not change RAM usage at all (Actual hanging). Still it is difficult to make sure if the software hangs or not. The above means that usually 1 dump is not enough because if that is Infinite Loop – the developers will see that software is working and there is no problem inside. So in order to troubleshoot application lockups you need about 5 dumps collected one after another. A Process Monitor Log will also be useful especially if it actually turns out to be an Infinite Loop.
Please note that an application lockup does not necessarily mean the software is completely unresponsive. A process can hang (e.g. service_process.exe hangs and a backup is stuck), but you can still browse vaults, create new plans etc.
Define the hanging process using Windows Task Manager. In some cases multiple processes are involved in an operation. In this case the hang of 1 process can be caused by some operations in another process. In this case you need to collect memory dumps of all processes involved in the operation.
E.g. 1 if a backup to Acronis Storage Node hangs, you need to collect a dump of service_process of the agent as well as StorageServer.exe process on ASN machine.
Troubleshooting
Each hanging/lockup should be investigated separately. In order for our development team to troubleshoot a lockup they need process dumps and other logs listed in this article. Select section corresponding with your operating system. With information collected please contact Acronis Support.
1. Windows
Step-by-step description of how the problem is reproduced and detailed description of the environment.
1.1. Process Monitor Log
Collect a Process Monitor Log while creating a dump of the hanging process, or immediately after. See Collecting Process Monitor Log
1.2. Dump of the hanging process
- Define the hanging process.
- Collect dumps as described in Creating Process Dumps with ProcDump using the following parameters:
procdump -ma -n 5 <process_name>
where <process_name> is the name of the hanging process.If you are collecting a dump of Acronis Storage Node (StorageServer.exe) with deduplication enabled please do not use "-ma". Use:
procdump StorageServer.exeFor Acronis Cyber Protect Home Office: if there is problem with creation of .tibx file (disk backup to cloud, disk backup to local storage, file backup to cloud), please collect dumps of backup_worker.exe process. If it is about .tib file (file backup to local storage), collect dumps of CyberProtectHomeOfficeService.exe process.
1.3. System Report
Collect System Report from the machine: see instruction for
- Acronis Cyber Protect 15
- Acronis Cyber Protect Cloud, Acronis Cyber Backup Cloud, Acronis Cyber Cloud
- Acronis True Image
- Acronis Cyber Protect Home Office
If this fails for any reason, you can use this AcronisInfo Utility.
1.4. Acronis Cyber Protect/Acronis Cyber Backup and Acronis Cyber Protect Home Office/Acronis True Image
If a backup operation hangs at the very beginning, the problem might be caused by a error during snapshot creation. Check if it's VSS-related by using Acronis VSS Doctor.
2. Linux
Step-by-step description of how the problem is reproduced and detailed description of the environment.
You will be prompted to provide root password.
2.1. Dump of the hanging process
- Install a debugger.
For example, use this command for installing GDB in Debian-based operating systems:
apt-get install gdb
Or this command for installing GDB in RedHat-based systems:
yum install gdb
- Find the process ID of the hanging process with the ps aux command. To filter out Acronis processes, use:
ps aux | grep Acronis
- Execute this command to remove any possible set limit for memory dumps:
ulimit -c unlimited - Open GDB shell with the following command:
gdb -pid <process_id>
where <process_id> is the identificator of the hanging process. - To write a core file, use:
gcore
- Detach the core file with:
detach
- Collect dump from the current working directory.
- Repeat steps 5-7 several times to collect more dumps.
- Quit GDB with:
quit
- Zip the collected dumps.
2.2. Strace Output
Collect strace output as described in Acronis Linux Products: Collecting Strace Output of Acronis Services in Linux
2.3. System Report
- Navigate to /usr/lib/Acronis/BackupAndRecovery.
- Execute systeminfo
- Collect the "sysinfo" archive from /var/lib/Acronis/sysinfo
3. Virtual Appliance
Step-by-step description of how the problem is reproduced and detailed description of the environment.
3.1. Dump of the hanging process
Collect dump as described in Using GDB to Create Memory Dumps of Processes Running on Acronis Virtual Appliance or Acronis Linux-based Bootable Media
Acronis Backup Appliance (All-in-One Appliance) is based on CentOS, follow the Linux part of this article.
3.2. System Report
Collect System Report from the machine: see instructions for Acronis Cyber Protect 15 or Acronis Cyber Protect Cloud. If this fails for any reason, you can use this AcronisInfo Utility.
4. Linux-based bootable media
Step-by-step description how the problem is reproduced and detailed description of the environment.
4.1. Dump of the hanging process
Collect dump as described in Using GDB to Create Memory Dumps of Processes Running on Acronis Virtual Appliance or Acronis Linux-based Bootable Media.
4.2. System Report
Collect System Report from the machine: see instructions for Acronis Cyber Protect 15 or Acronis Cyber Protect Cloud. If this fails for any reason, you can use this AcronisInfo Utility.
5. Mac OS
5.1. Sample of the hanging process
To take a sample, open the Activity Monitor application (from the Utilities folder inside your Applications folder).
After opening Activity Monitor, make sure the CPU tab is selected.
Select the process from the list. To find it easily, search for it using the search field at the top right. Typically you want to sample mms and service_process.
Click the Action pop-up menu (looks like a gear) in the toolbar, then select Sample Process.
A new window will open to display the sample. When Activity Monitor finishes sampling, click Save… to save the result as a text file.
5.2. System Report
Collect System Report from the machine: see instructions for Acronis Cyber Protect 15, Acronis Cyber Protect Cloud, Acronis Cyber Protect Home Office and Acronis True Image. If this fails for any reason, you can use this AcronisInfo Utility.
Tags:
- DST
- Backup
- Any
- Lockup
- N/A
- AB - Pre/Post-Backup/Recovery Operations
- AB - Installation
- AB - Backup
- application OS lockup
- ADD - Disk Management
- ASD - Deployment preparation
- ASD - Deployment operations
- AVMP - Replication
- AB - Recovery
- AB - Disk Management
- ATIH - Validation
- ATIH - Tools & Utilities
- ATIH - Recovery
- ATIH - Backup
- ATIH - Pre Backup/Recovery Operations
- ATIH - Cloning
- ATI - Backup
- ATI - Cloning
- ATI - Pre Post-Backup Recovery Operations
- ATI - Recovery
- ATI - Tools & Utilities
- ATI - Installation
- Application Lockup
- Deployment Operations
- ABRSP - Installation SheraPoint Explorer
- CMD