KNOWLEDGE BASE

Can Not Deploy A Containerized Tableau Server With Backup Data From Tableau Server 2019.X


Published: 27 Dec 2021
Last Modified Date: 30 Dec 2021

Issue

Can not deploy a containerized Tableau Server with backup data from Tableau Server 2019.X.

Environment

  • Tableau Server 2021.3.4

Resolution

Error one:

If you get an error like the one shown below in the run-tableau-server.log, use the IGNORE_TOPOLOGY_CONFIG parameter to ignore the config of topology and set it manually after containerized Tableau Server is deployed.
+ tsm pending-changes apply -iw --ignore-prompt  

Pending changes were not applied. 

There are 8 topology validation errors/warnings. 

Error: There must be at least '1' service instances of 'activationservice'. 
Service: Activation Service       

Error: Service 'floweditor' is not present on any node in the cluster. 
Service: Tableau Prep Flow Authoring 

Example:
docker run \
-v <full-path-to-backup-file>:/docker/config/backup/backup-file.tsbak \
-v <full-path-to-config-only-file>:/docker/config/config.json:ro \
-e IGNORE_TOPOLOGY_CONFIG=1 \
-e LICENSE_KEY=<key> \
-p 8080:8080 -d <Tableau Server in a Container image ID or tag>

Error two:

If you get an error like the one shown below in run-tableau-server.log, preconfigure the identity store information.
+ register 
+ echo 'Registering Tableau Server' 
Registering Tableau Server 
+ '[' '!' -f /docker/customer-files/reg-info.json ']' 
+ tsm register --file /docker/customer-files/reg-info.json 
Registration complete. 
+ echo 'Starting Server...' 
Starting Server... 

+ tsm initialize --start-server 

Initializing the server... 

Server initialization was unsuccessful. 

See '/var/opt/tableau/tableau_server/data/tabsvc/logs/tabadmincontroller/tabadmincontroller_*.log' on Tableau Server nodes running the Administration Controller process for server log information. 

Invalid Initialization Request: The identity store must be set before initialization. 

++ exit_container
For Local Authentication to work around this issue set the identity store in the pre-initialization hook.
  1. Create a file called ./customer-files/pre_init_command in the Tableau Server Image Build Tool customer-files directory and edit it to contain:
#!/bin/bash
tsm configuration set -k wgserver.authenticate -v local --force-keys
  1. Set the script to be executable.
    1. chmod +x ./customer-files/pre_init_command
  2. Build and run the image.
For Active Directory see this reference.

Cause

May be caused by any of the following: 
  • Mismatch in topology information(config.json) due to the difference in the number of processes between 2019.X and 2021.2 or later. 
  • No Identity Store setting in config.json. Because when restoring from backup, there is no default identity store specification.
Did this article resolve the issue?