Kaseya Unitrends Documentation

https://helpdesk.kaseya.com/hc/en-gb
Admin
This project provides comprehensive documentation and knowledge base articles for Kaseya's Unitrends...
Tokens:1,133,245
Snippets:17,134
Trust Score:10
Update:3 months ago
Show doc for...
Tokens:
Raw
### Sendmail Service Status - Good Example

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/4407527747217-No-Email-After-CentOS-Migration

Example output showing sendmail is correctly configured to start on boot.

```bash
sendmail 0:off 1:off 2:on 3:on 4:on 5:on 6:off
```

--------------------------------

### Example: Get Systems Output

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/4407510119313-How-to-change-the-number-of-concurrent-backups

Example output from `get systems` command, showing system IDs and names. Identify the ID corresponding to your appliance's hostname.

```bash
"id": 1,
            "name": "UB110",
```

--------------------------------

### Sendmail Service Status - Bad Example

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/4407527747217-No-Email-After-CentOS-Migration

Example output showing sendmail is not set to start on boot.

```bash
sendmail 0:off 1:off 2:off 3:off 4:off 5:off 6:off
```

--------------------------------

### Start Database Servers and Perform Backup

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/229933228-Migrate-Traverse-to-New-Linux-Server

Navigate to the Traverse installation directory and start the database servers. Then, execute the database backup script.

```bash
cd /usr/local/traverse  
etc/dgedb.init start  
etc/provdb.init start  
utils/db_backup.sh
```

--------------------------------

### Get Examples for a Hyper-V Cmdlet

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/4407517753233-Hyper-V-backup-fails-with-error-Hyper-V-PowerShell-Module-is-not-installed

Obtain practical examples of how to use a specific Hyper-V cmdlet, such as New-VM, to understand its application.

```powershell
Get-Help New-VM –Examples
```

--------------------------------

### Example Acronis Installation Log Success Message

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/229017788-Backup-client-installation-failed

This is an example of a successful installation log entry from Acronis. Check the summary at the bottom of Acronis log files for similar messages to confirm successful module installation.

```text
MSI (s) (7C:20) [13:11:54:247]: Product: Acronis Backup & Recovery 11.5 Agent Core -- Installation completed successfully.
MSI (s) (7C:20) [13:11:54:247]: Windows Installer installed the product. Product Name: Acronis Backup & Recovery 11.5 Agent Core. Product Version: 11.5.37977. Product Language: 1033. Installation success or error status: 0.
=== Logging stopped: 31/01/2014 13:11:54 ===
```

--------------------------------

### Access Token Usage Example

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/7006294343313-How-to-get-a-bearer-token-for-the-MSP-portal-API

This example shows how to use the obtained access token in a GET request to the /v1/customers endpoint. Replace <YOUR ACCESS_TOKEN HERE> with the actual token.

```http
GET /v1/customers HTTP/1.1
Host: public-api.backup.net
Authorization: Bearer <YOUR ACCESS_TOKEN HERE>
```

--------------------------------

### Execute APC UPS Setup and Start Service

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/4407512277905-Issue-a-clean-shutdown-from-an-APC-UPS

Download, make executable, and run the apcConfig.sh script to set up the UPS. Then, start the apcupsd service to enable UPS monitoring and shutdown capabilities. A reboot will also start the service.

```bash
# wget https://sftp.kaseya.com/utilities/apc/apcConfig.sh
# chmod +x apcConfig.sh
# ./apcConfig.sh
# service apcupsd start (a reboot will also start the service)
```

--------------------------------

### Start repqueuer Service

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/4407593789969-Hot-Copy-replication-jobs-not-running-after-10-4-update

After ensuring the necessary ports are open and packages are installed, use this command to start the repqueuer service if it is not already running.

```bash
repqueuer_ctl start
```

--------------------------------

### Get SQL Server Instances and Versions

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/229011968-SQL-Audit

This PowerShell script retrieves installed SQL Server instances and their respective versions from the registry. It iterates through the instances to gather setup information.

```powershell
$inst = (get-itemproperty 'HKLM:\SOFTWARE\Microsoft\Microsoft SQL Server').InstalledInstances  
foreach ($i in $inst)  
{  
$p = (Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Microsoft SQL Server\Instance Names\SQL').$i  
(Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\Microsoft SQL Server\$p\Setup").Edition  
(Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\Microsoft SQL Server\$p\Setup").Version  
}
```

--------------------------------

### Example: Querying for libXp.so.6 on CentOS 5

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/229041508-What-Pre-requisites-are-Needed-for-Installation

This example demonstrates how to use the 'rpm -q --whatprovides' command to find the package that provides 'libXp.so.6' on a CentOS 5 system.

```bash
[root@host ~]# rpm -q --whatprovides libXp.so.6
libXp-1.0.0-8.1.el5
```

--------------------------------

### Compile and Install Compatibility Libraries

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/4407510362385-Protecting-FreeBSD-EOL-See-KB-6643

As root, navigate to the compatibility library source directory, compile, and install the necessary libraries.

```bash
cd /usr/src/lib/compat
make obj
make
make install
```

--------------------------------

### Example setupvars.ini for Kaseya Network Monitor

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/229035788-Howto-Kaseya-Network-Monitor-silent-install

Configure installation parameters by editing the setupvars.ini file. Variables are case-sensitive. This example shows common settings for installation path, shortcuts, service, and edition.

```ini
[SetupValues]
%AppFolder% = c:\KNM
%AppShortcutFolderName% = Kaseya\KNM
%InstallService% = yes
%SERVICE_USERNAME=DOMAIN\knmservice
%SERVICE_PASSWORD=Password
%WEB_PORTNUMBER%=8080
%ServiceName%=Kaseya Network Monitor
%edition%=Standard
```

--------------------------------

### Launch Linux Client Agent Installer

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/4407512762641-Linux-Client-Agent

Execute this command in the same directory as the installer to begin the installation process.

```bash
./lnx32_cnt.run
```

--------------------------------

### Start SSH Service

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/4407521003153-Cannot-ssh-into-recovery-appliance-ssh-error-while-loading-shared-libraries

After installing or reinstalling the required libraries, use this command to start the SSH daemon and enable SSH connections.

```bash
service sshd start
```

--------------------------------

### Install GRUB

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/27498521136017-Appliance-boots-into-GRUB-Rescue-screen

Install GRUB to the identified boot partitions (e.g., /dev/sda, /dev/sdb).

```bash
grub2-install /dev/sda
```

```bash
grub2-install /dev/sdb
```

--------------------------------

### Check Installer Log File

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/229038848-VSA-9-Agents-Not-Updating-to-Latest-Version

On-premises VSA only. Search for and open the KASetup.log file on target machines to verify if the installer ran and to review for errors.

```text
KASetup.log
```

--------------------------------

### Example: License Feature String Output

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/4407510119313-How-to-change-the-number-of-concurrent-backups

Example output showing the feature string, highlighting the MUX value which indicates the maximum concurrent backups.

```bash
"feature_string": "ENTRB,MUX=20,VC=INF,RC=INF,D2D=INF,ENC,ADX,MKT=4"
```

--------------------------------

### Download and Execute New Disk Script

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/4407512594193-Move-the-Unitrends-database-off-of-stateless-storage-and-onto-a-new-partition

Download the 'newdisk' utility script from the provided URL, make it executable, and run it to prepare the new disk for the database partition. This script identifies the newly added virtual disk.

```bash
wget https://sftp.kaseya.com/utilities/newdisk
chmod +x newdisk
./newdisk
```

--------------------------------

### Example pg_hba.conf Configuration

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/4407521617809-Error-Database-on-system-with-hostname-is-not-responding

This is an example of the minimum required configuration for the pg_hba.conf file on the source system. Additional entries may be present.

```conf
# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
local   all             all                                     trust
# IPv4 local connections:
host    all             all             127.0.0.1/32            trust
# IPv6 local connections:
host    all             all             ::1/128                 trust
# Allow replication connections from localhost, by a user with the
# replication privilege.
host    bpdb    +bpexch,wguest  0.0.0.0/0              md5
hostssl bpdb     postgres       172.17.3.1/32         trust
```

--------------------------------

### Example IP Ranges for New Target Setup

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/4407593609233-Secure-network-does-not-conform-to-standard-VPN-IP-structure-11-255-0

Illustrates valid IP ranges that conform to the required structure for new target setups. Ensure the third octet is between 11 and 255 to avoid conflicts with Unitrends Cloud.

```text
172.22.13.0, 10.10.55.0, 192.168.254.0 etc.
```

--------------------------------

### Get IPMI Sensor Data

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/4407529649809-Configuring-and-using-IPMI-LAN-for-remote-access-via-BIOS-Console-SSH

Use this command to retrieve sensor readings from the IPMI interface. Ensure you have the ipmiutil client installed and elevated privileges.

```bash
ipmiutil sensor –c –N <<ip address>> –U ADMIN –P <<password>>
```

--------------------------------

### Device Input File Examples

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/229045128-Traverse-How-to-use-the-bulk-provisioning-tool-to-add-devices

Format for the device input file used by the bulk provisioning tool. Examples show configurations for SNMPv2, SNMPv3, and Windows devices.

```text
_# example with SNMPv2 options_  
10.16.32.1  | device_name | snmp_community_string | * |  | * |  | version=2 |  
  
_# example with SNMPv3 options  
_10.16.32.1  | device_name | USER:AUTH:ENCRYPT | * |  | * |  | version=3 | authproto=sha1 | privproto=aes  
  
# _example with Windows options_  
10.16.32.1 | device_name| Domain\administrator pAssw0rd | | | | | type=windows | proxy=127.0.0.1

```

--------------------------------

### Get Detailed Help for a Hyper-V Cmdlet

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/4407517753233-Hyper-V-backup-fails-with-error-Hyper-V-PowerShell-Module-is-not-installed

Retrieve comprehensive help information, including detailed usage and examples, for a specific Hyper-V cmdlet like New-VM.

```powershell
Get-Help New-VM –Detailed
```

--------------------------------

### Post-Installation Steps for FreeBSD Compatibility

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/4407510362385-Protecting-FreeBSD-EOL-See-KB-6643

After installing compatibility libraries, rename .sh.sample files to .sh in /usr/local/etc/rc.d/, sync, and reboot the system.

```bash
Rename /usr/local/etc/rc.d/*.sh.sample to *.sh
sync
Reboot the system.
```

--------------------------------

### Registry Editor Steps for Loading Hive and Modifying Start Key

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/4407522069905-Image-based-Bare-Metal-restore-Stop-code-7B-after-driver-injection-was-successful

These steps detail how to load the SYSTEM hive and modify the 'Start' key for a storage controller driver (LSI_SAS in this example) within the Registry Editor. This is performed when the system encounters a stop code 7B after a bare metal restore.

```powershell
1. In the Registry Editor, select HKEY_LOCAL_MACHINE.
2. Select **File** > **Load Hive**.
3. Navigate to the drive on which Windows is installed (usually C:\).
4. Open the file named SYSTEM located at Windows/system32/config.
5. Name the file as P2V, when prompted.
6. Navigate to HKEY_LOCAL_MACHINE\P2V\ControlSet001\services\LSI_SAS.
7. Right-click the **Start** key and click **Modify**.
8. Set the Value data to REG_DWORD 0.
9. Close the Registry Editor.
10. Restart the virtual machine.
```

--------------------------------

### Get Acknowledged Events by Event Time

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/115003814632-Traverse-Example-Web-Services-Requests

Fetch acknowledged event details filtered by event time. This example allows specifying a username filter and time ranges.

```curl
curl -k -i -H "Content-Type: application/json" -H "Accept: application/json" -X POST -d '{
  "username":"superuser",
  "password":"traverse",
  "usernameFilter":"superuser",
  "departmentSerialNumbers":[
  ],
  "deviceSerialNumbers":[
  ],
  "severities":[
  ],
  "startTimeExp":"2-days-ago",
  "endTimeExp":"now"
}' https://localhost/api/json/event/getEventAckDetails
```

--------------------------------

### List Available Unitrends Packages

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/4407520022545-Unitrends-config-not-installed

Use 'yum list unitrends-c*' to display all available Unitrends packages starting with 'unitrends-c', which helps in identifying the correct version of 'unitrends-config' to install.

```bash
[root@Grandledge-823 unitrends]# yum list unitrends-c*
Loaded plugins: fastestmirror  
Loading mirror speeds from cached hostfile  
base | 1.1 kB 00:00  
unitrends | 1.2 kB 00:00  
update | 1.9 kB 00:00  
Available Packages  
unitrends-config-172.noarch 0.3.0-2 unitrends  
unitrends-config-212.noarch 0.3.2-2 unitrends  
unitrends-config-312.noarch 0.3.2-2 unitrends  
unitrends-config-313.noarch 0.0.6-2 unitrends  
unitrends-config-612.noarch 0.3.2-2 unitrends  
unitrends-config-712.noarch 0.3.4-2 unitrends  
unitrends-config-713.noarch 0.3.4-2 unitrends  
unitrends-config-722.noarch 0.3.3-2 unitrends  
unitrends-config-732.noarch 0.3.3-2 unitrends  
unitrends-config-812.noarch 0.3.3-2 unitrends  
unitrends-config-813.noarch 0.3.5-2 unitrends  
unitrends-config-822.noarch 0.3.5-2 unitrends  
unitrends-config-823.noarch 0.3.5-2 unitrends  
unitrends-config-824.noarch 0.0.6-2 unitrends  
unitrends-config-832.noarch 0.3.3-2 unitrends  
unitrends-config-833.noarch 0.3.5-2 unitrends  
unitrends-config-943.noarch 0.0.9-2 unitrends  
unitrends-config-standard.noarch 0.0.3-0 unitrends  
unitrends-config-vm.noarch 1.0.5-2 unitrends
```

--------------------------------

### Mount NFS Share for /backups (stateless_init)

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/4407512087441-UEB-Installable-Software-Configuration-Tips

Sample steps for the stateless_init script to mount an NFS share on the /backups partition. Ensure the NFS server and share are accessible.

```bash
mount -t nfs -overs=3 mynode:/myshare /backups

```

--------------------------------

### DCA Job Error Log Example

Source: https://helpdesk.kaseya.com/hc/en-gb/articles/11413680116497-DCA-Job-fails-with-Cannot-get-UEB-IP-Address

This log snippet from /usr/bp/logs.dir/rdr/unitrends-rdr.nohup indicates the specific error 'Cannot get the UEB IP address' during a DCA job execution, along with the call stack.

```log
2022-12-14 11:57:17 [Information] Start (StartIR)  
2022-12-14 11:57:18 [Error] Ueb_Operations.cs(51): StartIR(): Cannot get the UEB IP address  
 at rdrjob.Management.Ueb_Operations+<>c__DisplayClass4_3.<StartIR>b__6 () [0x00049] in <1c89a7aa1b14479db46fd4834ed21206>:0  
 at rdrjob.Management.Common.RetryExecution[T] (System.Func`1[TResult] command, System.Nullable`1[T] retries, System.Boolean rethrow, System.String sourceFile, System.String sourceMember, System.Int32 sourceLine) [0x00089] in <1c89a7aa1b14479db46fd4834ed21206>:0
```
Tokens:
Raw