Tableau Serverの『ダウングレード』を試してみる

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

Tableau Serverでは環境を『アップグレード』させる手順が整備されており、基本的には最新バージョン・新し目のバージョンに『アップグレード』させていくのが普通です。ですが状況に拠っては止むを得ない理由で環境のバージョンを戻す、所謂『ダウングレード』を必要とする場合もあるかも知れません。例えば一旦アップグレードしてみたけれど動作しない部分があったりしてすぐには改善が見込めない場合の緊急措置として元のバージョンに戻す、等です。Tableauのナレッジベースにこの『ダウングレード』手順が紹介されていましたので、現行最新バージョンv10.0と任意の過去バージョンでこの内容を試してみたいと思います。

目次

 

1.Beforeな環境を用意(Tableau Server 9.2.0)

まず始めに検証を行う上で必要となる環境を用意(Amazon EC2: Windows Server 2012 RTM R2 日本語版/Dドライブ100GBを追加)。Tableau Serverのインストーラも過去バージョンが入手出来る下記サイトから最新バージョン(v10.0)と任意の過去バージョン(今回はv9.2.0をチョイスしてみました)をそれぞれダウンロードしておきます。

tableau-server-downgrade_00

ダウングレード対象となるバージョン(v9.2.0)のTableau Serverをインストール。

tableau-server-downgrade_01

この時のインストールパスはD:¥Tableauとしています。(インストーラ側で自動的に¥Tableau Serverは補完されます)

tableau-server-downgrade_02

インストールを進め、任意のプロジェクトを新規作成し、中にコンテンツをPublishしておきました。

tableau-server-downgrade_03

そしてこのタイミングでtabadmin backupコマンドを使いバックアップファイルを作成しておきます。(このファイルを後程使ってリストアする形となります)

Windows PowerShell
Copyright (C) 2014 Microsoft Corporation. All rights reserved.

PS C:\Users\Administrator> D:
PS D:\> cd .\Tableau
PS D:\Tableau> cd '.\Tableau Server'
PS D:\Tableau\Tableau Server> cd .\9.2
PS D:\Tableau\Tableau Server\9.2> cd .\bin
PS D:\Tableau\Tableau Server\9.2\bin> .\tabadmin.exe backup D:\tableau-server-backup¥tableau-server-92-backup -d
===== Using as backup tmp directory: D:/Tableau/Tableau Server/data/tabsvc/temp (free space: 102.17 GB)
===== Cleaning entries from http_requests log older than 7 days
   -- Deleted 0 rows
===== Backing up database data
===== Backing up dataengine extracts
===== Backup of database data done
===== Backup of dataengine extracts done
===== Backup written to D:/tableau-server-backup/tableau-server-92-backup-2016-09-09.tsbak
PS D:\Tableau\Tableau Server\9.2\bin>

バックアップ作成完了。

tableau-server-downgrade_04

 

2.Afterな環境へのアップグレード(Tableau Server 10.0)

次いで、この環境を最新v10.0にアップグレードさせます。

tableau-server-downgrade_05

v10.0からは事前のバックアップ、前バージョンのアンインストールが手動で行わなくても良くなりました。

tableau-server-downgrade_06

インストールパスは前バージョンのものと合わせます。

tableau-server-downgrade_07

アップグレード完了。

tableau-server-downgrade_08

バージョンも最新版のものとなっています。

tableau-server-downgrade_09

 

3.Beforeな環境へダウングレード(Tableau Server 9.2.0)

そしてここからが今回の肝となる作業手順となります。現在のバージョン(v10.0)からの過去バージョン(v9.2.0)へのダウングレードです。まずは現行バージョン(v10.0)の環境を、『プログラムと機能』からアンインストール実施。

tableau-server-downgrade_10

アンインストール完了後、バージョンごとに作成されているフォルダの該当バージョンのものを削除します。デフォルト値でのインストールであればC:\Program Files\Tableau\Tableau Server\となりますし、今回のエントリの内容で言えばD:\Tableau\Tableau Server\がその場所となります。

tableau-server-downgrade_11

また併せてdataフォルダも削除してしまいます。デフォルト値での導入の場合だとC:\ProgramData\Tableau\Tableau Server\data、今回のエントリの内容だとD:\Tableau\Tableau Server\dataが該当します。

tableau-server-downgrade_12

アンインストール&フォルダ削除が完了したら前バージョン(v9.2.0)のTableau Serverを改めてインストール。

tableau-server-downgrade_13

インストールパスを合わせるのはこれまで通り。

tableau-server-downgrade_14

インストール完了。この時点では単純にインストールしただけですので環境も初期状態となっています。

tableau-server-downgrade_15

tabadmin restoreコマンドを使い、既存取得済みのバックアップファイルからリストア作業を行います。

PS C:\Users\Administrator> D:
PS D:\> cd .\Tableau
PS D:\Tableau> cd '.\Tableau Server'
PS D:\Tableau\Tableau Server> cd .\9.2
PS D:\Tableau\Tableau Server\9.2> cd .\bin
PS D:\Tableau\Tableau Server\9.2\bin> .\tabadmin.exe restore D:\tableau-server-backup¥tableau-server-92-backup-2016-09-09.tsbak
===== Beginning to restore the backup
===== Stopping service...
   -- Service stopped successfully
===== Verifying backup manifest
   -- Restoring service configuration
===== Initializing Tableau Server File Store remotely
   -- Initiating built-in extract engine data restore
   -- Restoring service data from backup file
   -- Database restore completed.
   -- Migrations already up to date.
===== Validating Database schema signature
===== Database schema is different from the expected schema. Use tabadmin validate_schema_signature for further investigation.
===== Initializing Tableau Server Coordination Service 0 remotely
   -- Waiting for built-in extract engine data restore to finish.
   -- Extract engine data restore completed.
===== Migrating extract data to filestore...
===== Finished Migrating. Cleaning up unmigrated data...
===== Cleaning up any unmigrated folders.
   -- Restoring web data connectors
   -- Web data connectors were distributed to all gateways.
   -- Web data connectors restore completed.
  *** The run-as password is empty. If the run-as user is a built-in system account, this is likely fine. Otherwise, services will likely fail to start.
===== Locking permissions on D:/Tableau/Tableau Server/data
===== Locking permissions on D:/Tableau/Tableau Server/config
===== Building search index
===== Search index built
===== Backup restore completed
===== Enter "tabadmin start" to start the service
PS D:\Tableau\Tableau Server\9.2\bin>

リストアが完了したらTableau Serverを起動し、

PS D:\Tableau\Tableau Server\9.2\bin> .\tabadmin.exe start
===== Starting service...
   -- Service was started successfully
PS D:\Tableau\Tableau Server\9.2\bin>

Tableau Serverにアクセス。前バージョン(v9.2.0)で先程のコンテンツ一式が復元出来ました。

tableau-server-downgrade_16

 

まとめ

Tableau Serverの『ダウングレード』手順に関するご紹介でした。いざとなったらこの手法を使って環境を戻すことが出来るのでアップグレード作業も思い切って出来ますね。こちらからは以上です。