CERT-Polska/drakvuf-sandbox
1
0
Fork 0
mirror of https://github.com/CERT-Polska/drakvuf-sandbox.git synced 2026-10-12 02:01:43 +00:00
Code Issues Packages Projects Releases Wiki Activity

Enhance troubleshooting section in README.md (#8)

Browse Source
This commit is contained in:
Michał Leszczyński
2020-03-21 19:57:00 +01:00
committed by GitHub
parent 98fca1882d
commit 4e20a68f25
1 changed files with 34 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+34 -14
View File
@@ -67,32 +67,52 @@ DRAKVUF Sandbox may optionally draw a behavioral graph using [ProcDOT](https://w
### Troubleshooting
### Checking service status
If your DRAKVUF Sandbox installation seems to work improperly, here are some commands that would help to troubleshoot the infrastructure.
Check the status of web interface service:
Check service status:
```
systemctl status drak-web
journalctl -e -u drak-web
```
Check the status of internal queue system:
```
systemctl status drak-system
journalctl -e -u drak-system
```
Check the status of builtin object storage:
```
systemctl status drak-minio
journalctl -e -u drak-minio
systemctl status drakrun@1
```
Check the status of first sandbox worker:
Check service logs:
```
systemctl status drakrun@1
journalctl -e -u drak-web
journalctl -e -u drak-system
journalctl -e -u drak-minio
journalctl -e -u drakrun@1
```
### Debug `device model did not start`
You may encounter the following error with `draksetup` command or `drakrun@*` service, which will prevent the VM from starting properly.
```
libxl: error: libxl_create.c:1676:domcreate_devmodel_started: Domain 4:device model did not start: -3
...
subprocess.CalledProcessError: Command 'xl create /etc/drakrun/configs/vm-0.cfg' returned non-zero exit status 3.
```
In such a case, you should inspect `/var/log/xen/qemu*.log` in order to determine the actual reason why the VM is refusing to start.
### Debug `can't allocate low memory for domain`
The following error with `draksetup` command or `drakrun@*` service means that your machine is missing memory resources:
```
xc: error: panic: xc_dom_boot.c:122: xc_dom_boot_mem_init: can't allocate low memory for domain: Out of memory
...
subprocess.CalledProcessError: Command 'xl create /etc/drakrun/configs/vm-0.cfg' returned non-zero exit status 3.
```
Resolutions:
* adjust the amount of memory dedicated to the Dom0 (host system) in `/etc/default/grub.d/xen.cfg` (look for `dom0_mem=2048M,max:2048M`) and run `update-grub && reboot`;
* adjust the amount of memory dedicated to the DomU (guest systems) in `/etc/drakrun/scripts/cfg.template` (`maxmem` and `memory` keys);
## Project contents
The project is divided into two main packages: