Troubleshooting Storage Issues

Restriction: The troubleshooting scenario below apply only to the Podman runtime.

If the storage mounted on /var/lib/containers or /var/lib/ai-services is smaller than the recommended minimum, deployment or runtime issues can occur.

As a temporary workaround, move both directories to a location with more available space and create symbolic links from the original paths.

Before moving ahead

Ensure that the target path has enough free space.
Stop dependent services before moving data.
This workaround is intended for environments where dedicated disks or volumes are not yet available.

Verify current disk usage

df -h
du -sh /var/lib/containers
du -sh /var/lib/ai-services
lsblk

Procedure

Back up the existing directories:

mv /var/lib/containers /var/lib/containers.backup
mv /var/lib/ai-services /var/lib/ai-services.backup

Copy the directories to a location with enough space.
Replace <target-path> with the path that has sufficient available storage.
```
sudo cp -a /var/lib/containers.backup/ <target-path>/
sudo cp -a /var/lib/ai-services.backup/ <target-path>/
```

Create symbolic links from the original paths. Replace <target-path> with the same location used in the previous step.

sudo ln -s <target-path>/containers.backup/ /var/lib/containers
sudo ln -s <target-path>/ai-services.backup/ /var/lib/ai-services

Clean up backup directories only after validation. Do not remove the backup directories until the system has been validated and, ideally, restarted successfully. After confirmation:
```
sudo rm -rf /var/lib/containers.backup
sudo rm -rf /var/lib/ai-services.backup
```

CAUTION: This is a temporary workaround.