Verify Installation

This section covers common tasks performed after installing XReplicator, including verifying the installation, updating packages, and uninstalling components.

Verify Backup Server


sudo systemctl status backup-server

Verify the backup server is running before starting agents.

Verify Backup Agents

Linux: Agent Service


sudo systemctl status backup-agent

A healthy service should show: active (running)

Verify Web UI (Optional)

Open http://localhost:3000 in your browser.

Check Installed Binary (Optional)

Ensure the xreplicator binary is available in the system path:

Linux: Check Path


which xreplicator

Expected output:


/usr/local/bin/xreplicator

Linux: Check Version


xreplicator --version

Windows


# Verify agent binary
Get-Item "C:\Program Files\XReplicator\backup.exe"
 
# Verify version (if built with version metadata)
& "C:\Program Files\XReplicator\backup.exe" --version

Updating Packages

Upgrade Backup Agents

Debian / Ubuntu


sudo dpkg -i backup-agent_VERSION_amd64.deb

RHEL / CentOS / Fedora


sudo rpm -U backup-agent-VERSION-1.x86_64.rpm

Windows


# Download the new MSI (replace VERSION)
Invoke-WebRequest -Uri https://github.com/xmigrate/xreplicator/releases/download/VERSION/xreplicator-agent-VERSION-windows-amd64.msi -OutFile C:\Temp\xreplicator-agent-VERSION-windows-amd64.msi
 
# Upgrade (run as Administrator)
Start-Process msiexec -Wait -ArgumentList '/i C:\Temp\xreplicator-agent-VERSION-windows-amd64.msi'
 
# Restart the service
Restart-Service XReplicatorAgent

Upgrade Backup Server


sudo dpkg -i backup-server_VERSION_amd64.deb

Always back up your configuration files before upgrading.

Upgrade backup agents before upgrading the backup server.

Uninstalling Packages

Uninstall Backup Agents

Debian / Ubuntu


sudo systemctl stop backup-agent
sudo systemctl disable backup-agent
sudo dpkg -r backup-agent

RHEL / CentOS / Fedora


sudo systemctl stop backup-agent
sudo systemctl disable backup-agent
sudo rpm -e backup-agent

Windows


# Uninstall (run as Administrator)
# Option 1: Use Apps & Features
# Option 2: Use msiexec with the original MSI
Start-Process msiexec -Wait -ArgumentList '/x C:\Temp\xreplicator-agent-VERSION-windows-amd64.msi'
 
# Optional cleanup
Remove-Item "C:\Program Files\XReplicator" -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item "C:\ProgramData\xreplicator" -Recurse -Force -ErrorAction SilentlyContinue

Uninstall Backup Server


sudo systemctl stop backup-server
sudo systemctl disable backup-server
sudo dpkg -r backup-server

Uninstalling removes services but does not delete backup repositories.