Ask the Community
Groups
Name and Character considerations in Unitrends - Connect IT Community | Kaseya
<main> <article class="userContent"> <h2 data-id="summary"><strong>SUMMARY</strong></h2> <p>Special considerations for characters and length when assigning names to your protected assets, backup copy targets, appliance configuration, etc.</p> <h2 data-id="issue"><strong>ISSUE</strong></h2> <p>You are creating a naming convention for your Unitrends appliance or have run into a problem with creating/modifying a name, backups, or restores.<br>Some assets will not save or report password errors. </p> <h2 data-id="resolution"><strong>RESOLUTION</strong></h2> <p>If you run into a problem with using a name first make sure your appliance is up-to-date, many issues have been corrected in updates. The following considerations need to be kept in mind when making names in Unitrends:<br><br><b>When modifying AD settings</b><br>Active Directory Server - This field is limited to 15 characters. Follow DNS or <a rel="nofollow" href="/home/leaving?allowTrusted=1&target=https%3A%2F%2Fsupport.microsoft.com%2Fen-us%2Fhelp%2F909264%2Fnaming-conventions-in-active-directory-for-computers-domains-sites-and">NetBIOS naming conventions</a>.<br><br><b>Protected Assets</b><br>In general, do not make names over 31 characters, and assets should be registered with their short DNS names and not FQDNs<br>CIFS, NFS, or SAN protected assets names cannot contain spaces<br><br><br><b>Backup copy targets</b><br>Third-Party Cloud bucket names:<br>Only upper and lowercase letters, numbers, dots, and dashes are supported<br><br>CIFS, NFS, or SAN Backup Copy Target names cannot contain spaces. SMB/CIFS and NFS specs both do not supprot a space in the DNS name OR share name. spaces in folders below the mount point are supportable but not in the mount address itself. UNC spec technically allows for this, but not the SMB/.NFS specs themselves. <br><br><br><b>non-<a rel="nofollow" href="/home/leaving?allowTrusted=1&target=https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FUTF-8">UTF-8</a> characters</b><br><br>non-UTF-8 characters may cause issues for backup or restore, especially in an older Linux/Unix OS, Novel, or AIX<br><a rel="nofollow" href="/home/leaving?allowTrusted=1&target=https%3A%2F%2Funitrends-support.zendesk.com%2Fhc%2Fen-us%2Farticles%2F360013161317">non-UTF-8 characters causing skipped files in a backup</a><br><a rel="nofollow" href="/home/leaving?allowTrusted=1&target=https%3A%2F%2Funitrends-support.zendesk.com%2Fhc%2Fen-us%2Farticles%2F360013166177">non-UTF-8 characters causing problems with restore</a><br><br>For Linux systems you can run the following command to get lines with non-UTF-8 characters:<br>grep -n -P '[\x80-\xFF]' Mast_Apr_29-04_00_45.txt<br><br>For Windows systems you can perform these steps to find non-UTF-8 characters:<br>Run Powershell<br>Change to root of drive<br>Run:<br>gci -recurse . | where {$_.Name -match "[^\u0000-\u007F]"}<br><br><b>VMWare Name Length: </b>32 chrs on vmware 4.1 and lower, 63 characters on 5.x+, 80 characters on current releases. Note the "computername" value for a defined windows VM cannot exceed 15 characters in VMWare. <br><br><b>SQL</b><br><a rel="nofollow" href="/home/leaving?allowTrusted=1&target=https%3A%2F%2Funitrends-support.zendesk.com%2Fhc%2Fen-us%2Farticles%2F360013266878">SQL databases with non-alphanumeric characters</a><br><a rel="nofollow" href="/home/leaving?allowTrusted=1&target=https%3A%2F%2Funitrends-support.zendesk.com%2Fhc%2Fen-us%2Farticles%2F360013182497">SQL database names over 103 characters</a><br><br><b>Novell backups</b><br><a rel="nofollow" href="/home/leaving?allowTrusted=1&target=https%3A%2F%2Funitrends-support.zendesk.com%2Fhc%2Fen-us%2Farticles%2F360013262498">Tilde "~" character in an exclude list breaks Novell backups</a>, or files with over 400 characters<br><br><b>Solaris backups</b><br><a rel="nofollow" href="/home/leaving?allowTrusted=1&target=https%3A%2F%2Funitrends-support.zendesk.com%2Fhc%2Fen-us%2Farticles%2F360013148457">File paths over 1024 characters</a><br><br><b>Password Restrictions</b><br>Some 3rd party systems, most notably VMWare in our product needs, may allow passwords for accounts to be used for direct login that are less restrictive than the password restrictions enforced by vendors to connect to to those systems via API or html commands. If you are receiving errors connecting an asset or updating a password for a prior saved credential, for the highest level of success, do not use passwords that contain non-ascii characters and seek to avoid characters that are used in HTML or curl string commands. This would include avoiding the following characters as a best practice: \ / " [ ] : | < > + = ; , ? * )( @ & or a trailing space<br>Additionally, many systems have password length restrictions in API calls. VMWare limits password lengths to 20 characters for example for vCenter Operations Manager and vAPI calls that we require, though user login to VMWare UI does not have this restriction. </p> <h2 data-id="notes"><strong>NOTES</strong></h2> <p>External links<br>UTF-8 characters: <a rel="nofollow" href="/home/leaving?allowTrusted=1&target=https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FUTF-8">https://en.wikipedia.org/wiki/UTF-8</a><br>Microsoft naming conventions in Active Directory for computers, domains, sites, and OUs: <a rel="nofollow" href="/home/leaving?allowTrusted=1&target=https%3A%2F%2Fsupport.microsoft.com%2Fen-us%2Fhelp%2F909264%2Fnaming-conventions-in-active-directory-for-computers-domains-sites-and">https://support.microsoft.com/en-us/help/909264/naming-conventions-in-active-directory-for-computers-domains-sites-and</a><br>VMware length limits on names and descriptions: <a rel="nofollow" href="/home/leaving?allowTrusted=1&target=https%3A%2F%2Fkb.vmware.com%2Fs%2Farticle%2F2051649">https://kb.vmware.com/s/article/2051649</a><br>VMWare Password Limitations for vAPI and Operations manager: <a rel="nofollow" href="/home/leaving?allowTrusted=1&target=https%3A%2F%2Fkb.vmware.com%2Fs%2Farticle%2F1037850">https://kb.vmware.com/s/article/1037850</a></p> </article> </main>