Skip to content

FAQ

Failure to launch the TSM BA GUI

  • When trying to start the backup GUI, the setup may be launched again. If this happens, let it run through. You may get prompted and asked to continue, to restart services, please just accept and continue. If you're asked to reboot, then select "no".
  • The GUI is a JAVA application, so if you don't have JRE or any equivalent, you might get this error.
    JRE error
    You can then download https://github.com/adoptium/temurin21-binaries/releases/download/jdk-21.0.5%2B11/OpenJDK21U-jdk_x64_windows_hotspot_21.0.5_11.msi and run this command to install it: 
    msiexec /i OpenJDK21U-jdk_x64_windows_hotspot_21.0.5_11.msi ADDLOCAL=FeatureMain,FeatureEnvironment,FeatureJarFileRunWith INSTALLDIR="c:\Program Files\AdoptOpenJDK\" ALLUSERS=1 /qn /l*v "%temp%\BaaS-openjdk21_jre_x64.log"
    You could use other providers of JRE according to your license preferences, but we cannot vouch for other ones working.

How do I get keys to generate my API token?

Login at the Safespring Backup portal, go to Settings and then select API access and click Add.

The Origin, the generated client_id together with your username and password will allow you to create access tokens and a refresh token. Access tokens are short-lived (5 minutes), and a new one can be generated by either re-authenticating with your username and password, or using the refresh token.

Keys

For more details and examples, see our API Documentation.

Where can I fetch IBM TSM client software?

See our TSM installation guide

How do I install TBMR (Bare machine recovery for TSM)

When will Operating System X version Y be fully supported by TSM?

IBMs official stance on the issue is that they will have a working client "within 6 months of the release", but it is usually faster than that.

What ports need to be opened in the firewall?

During the installation, platforms with TBMR will want to make an https call to get a license for TBMR, so tcp/443 needs to be open until the installation is done, then during backups and schedule calls, only tcp/1600 outwards. All TSM communication is always initiated by the client to our server, no inbound ports need to be configured, so installation and operations behind NAT are ok.

What known issues are there with the clients and the services on top of TSM?

  • You currently can't take backups of files with dates outside 1970-Jan-1 00:00 and 2105-Feb-07. TSM uses 0 to represent both the date 1970-Jan-1 00:00 but also to mark expired files in the inventory, so files before that have undefined date stamps.
  • We have a case where TSM up to the release 7.1.4.0 can fail to restore some files on Solaris x86. We have pre-release binaries one can test in case your Solaris box gives you strange errors (ANS4042E, which normally is related to locale settings like en_US and sv_SE) on large restores. The next patch release contains the fixed code for it.
  • MacOS X 10.11.x needs the TSM release 7.1.4.0 or newer, otherwise the Apple security framework will interfere with the backup client software locations and not allow you to install or use the backup client. If you update your MacOSX and TSM stops working, install the latest release on top of the old one. No need to change anything in the config files or certificate stores. The upgrade will not disturb those files either.
  • If you forcibly kill the client while doing restore, it will take close to 10 minutes for the server to recognize that the client is not coming back to make a "restartable restore". If you run the client again, it will error out with "Restore already in progress". If the client restore was broken due to network hiccups or similar in-transit issues, it will restart by itself from where it left off as long as the issue is resolved within 10 minutes. If you forcibly kill the client, it will forget that it had a session running and you will have to wait until 10 minutes pass before being able to start a new full restore. "dsmc cancel restore" may or may not speed up this timeout.
  • There is a known issue with the local deduplication cache if you run exactly Linux kernel 2.6.32 and TSM client version 7.1.0.2. If you have this combination, either upgrade the client (preferred, this is verified to help as a single action), or increase the DEDUPCACHESIZE in dsm.sys (which may workaround the problem).
  • The 8.1.0.0 TSM client (not 8.1.0.2 or later) will fail if you have 1400+ directories in a single directory. The error will be something like this: "ANS6718E The path contains too many nested subdirectories. The maximum number of nested directories is 1400". The solution is to either upgrade to 8.1.0.2 or later, or edit the dsm.opt to include this line: "TESTFLAGS threadstacksize:2048" if you can't upgrade.

Why can't I delete filespaces from the client?

This is a security feature since some cryptolockers and ransomwares target backups. If you want to delete a filespace from the backup, please contact our support to enable the feature temporarily.

Credentials to Safespring Backup Portal?

To get credentials for Safespring Backup Portal you need to talk to your backup admin to invite you, if you are the first one in your organisation, please open a ticket with our support.