MicroStrategy Repository アップグレードのガイドラインとトラブルシューティング

• Repository アップグレードの概要

• MicroStrategy Repository のデータベース

• MicroStrategy Repository 管理ツール

• ネイティブ PostgreSQL バックアップ/復元ユーティリティ

  • Windows

  • Linux

• MicroStrategy ブランド PostgreSQL バックアップ/復元ユーティリティ

• プラットフォーム インストーラーによる MicroStrategy Repository のアップグレード

  • Linux

  • Windows

• PostgreSQL のアップグレード失敗のトラブルシューティング

  • ハードディスクの容量が足りない

  • パスワードが一致しない

  • アクセス権に問題がある

  • 構成設定に誤りがある

  • データが破損している

• フェイルオーバーのシナリオと復元

  • Windows

  • Linux

Repository アップグレードの概要

MicroStrategy スイートの継続的なセキュリティと安定性を実現するために、MicroStrategy Repository は 2021 Update 10 で PostgreSQL をバージョン 14.7 にアップグレードしています。

今回のアップグレードの内容は次のとおりです。

• PostgreSQL の旧バージョンに存在していた既知のセキュリティ脆弱性を解決します

• 製品の急な停止を防止します

• PostgreSQL の最新リリースによる追加機能と強化されたパフォーマンスを活用できます

このアップグレード ワークフローでは、リモート リポジトリではなく、MicroStrategy のローカルにインストールされた PostgreSQL のみが対象です。

このアップグレードは 2 つの部分で構成されています。

• PostgreSQL サーバー バイナリのアップデート

• データの移行

このアップグレードでは、PostgreSQL のフォルダー構造は変更されないため、PostgreSQL を使用するコンポーネントに影響はありません。

未設定の MicroStrategy Repository のバックアップに使用できるユーティリティ/ツールは複数あります。

1. MicroStrategy Repository 管理ツール

2. ネイティブ PostgreSQL バックアップ/復元ユーティリティ

   pg_dump, pg_dumpall

3. MicroStrategy ブランド PostgreSQL バックアップ/復元ユーティリティ

   mstr_pg_dump, mstr_pg_dumpall

MicroStrategy Repository のデータベース

Windows および Linux にインストールしたばかりの環境では、未設定の MicroStrategy Repository に以下のデータベースがインストールされています。

Linux インストールおよび Windows カスタム インストールでは、選択したコンポーネントの対応するウェアハウスのみが MicroStrategy Repository にインストールされます。たとえば、Platform Analyticsコンポーネントをインストールしない場合は、platform_analytics_wh MicroStrategy リポジトリに存在しません。

MicroStrategy Repository 管理ツール

MicroStrategyリポジトリ管理ツールは、MicroStrategyユーザーに、データベース情報に基づいてデータベースをバックアップ、復元、およびバキュームするためのコマンドラインインターフェイスを提供します。DBAdminConfig.yaml。

MicroStrategyリポジトリ管理ツールの詳細については、以下を参照してください。リポジトリ管理。

ネイティブ PostgreSQL バックアップ/復元ユーティリティ

ネイティブ PostgreSQL バックアップ/復元ユーティリティを使用して、MicroStrategy Repository をバックアップ/復元できます。このツールは MicroStrategy Repository に標準装備されています。

• pg_dump単一のデータベースをダンプします。

  例:

  コピー

  # To dump a database called mydb into an SQL-script file:
  pg_dump mydb > db.sql

• pg_dumpall特定のクラスター内のすべてのデータベースをバックアップし、ロールや表領域の定義などのクラスター全体のデータも保存します。

  例:

  コピー

  # To dump all databases
  pg_dumpall > db.out

• 復元するには、psqlまたはpg_restore。

  例:

  コピー

  # To reload pg_dump file into a (freshly created) database named newdb
  psql -d newdb -f db.sql
  
  # To restore pg_dumpall file db.out
  psql -f db.out postgres

バックアップ オプションのダンプ パラメーターがたくさんあるため、自分のニーズに応じて使い分けることができます。

パラメータのリストと使用例については、pg_dump、pg_dumpall、 そしてpg_restore。

Windows

デフォルトパス: C:\Program Files (x86)\Common Files\MicroStrategy\Repository\pgsql\bin

例:

 #dump mstr_collab
 pg_dump -d mstr_collab -Umstr > mstr_collab.sql
 
 #dump the whole postgres cluster
 pg_dumpall -Umstr > postgres.sql

Linux

デフォルトパス: /opt/mstr/MicroStrategy/install/Repository/postgres11/bin

例:

#source setenv.sh
source /opt/mstr/MicroStrategy/install/Repository/bin/setenv.sh

#declare unix-domain socket and use pg_dump to dump metadata
cd /opt/mstr/MicroStrategy/install/Repository/postgres11/bin
./pg_dump -h /tmp -d poc_metadata -Umstr > md.dump

#dump the whole postgres cluster
./pg_dumpall -h /tmp -Umstr > postgres.dump

MicroStrategy ブランド PostgreSQL バックアップ/復元ユーティリティ

MicroStrategy は Linux に対して「ブランド」バックアップ/復元ユーティリティを提供しています。このユーティリティは、ネイティブ PostgreSQL バックアップ/復元ユーティリティをベースに作成されています。ソースは必要ありませんsetenv.shこのツールを使用して Unix ドメイン ソケットを宣言します。

このユーティリティはネイティブ PostgreSQL バックアップ/復元ユーティリティをベースに作成されているため、ネイティブ PostgreSQL バックアップ/復元ユーティリティで使用するパラメーターも使用できます。

デフォルトパス: /opt/mstr/MicroStrategy/install/Repository/bin

例:

#dump metadata
cd /opt/mstr/MicroStrategy/install/Repository/bin
./mstr_pg_dump -d poc_metadata -Umstr > md.dump

#dump the whole postgres cluster
./mstr_pg_dumpall -Umstr > postgres.dump

プラットフォーム インストーラーによる MicroStrategy Repository のアップグレード

Linux

1. インストーラを起動して選択アップグレードローカルの MicroStrategy バージョンを 2021 Update 10 にアップグレードします。

   

2. もしMicroStrategy プラットフォーム アナリティクス以前のインストールで選択された場合は、自動的に選択されますコンポーネントを選択。アップグレードしたいコンポーネントを確認し、クリックします次。

   

3. MicroStrategy Repository への接続情報が前回のインストール以降に変更されている場合、データベース ログインのユーザー名、パスワード、およびポートを入力するように要求されます。フィールドに入力してクリック次。

   

4. 操作を進める前に、リポジトリのバックアップが要求されます。レビュー上記のセクションリポジトリのバックアップと復元に関する情報。アップグレードを続行するには、次のコマンドを入力してリポジトリをバックアップしたことを確認する必要があります。アップグレード。クリック次。

   

5. インストーラーは、システム上に十分なディスク空き容量があるかどうかを確認します。空き容量が不足している場合は、満たしていない要件が表示され、アップグレードが中断します。

   

6. 十分なディスク容量がある場合、リポジトリに加え、他の MicroStrategy コンポーネントのアップグレード処理も続行されます。ただし、リポジトリのアップグレードに失敗した場合は、アップグレード全体が中断し、以下の画面が表示されます。

   

   根本的な原因の分析およびトラブルシューティングの詳細な手順は、リンクをクリックしてください。問題が解決したら、インストールを再実行してアップグレードを完了します。

12 Apr 2023, 07:29:41 AM:INFO: Configuring pg_hba.conf file completed
12 Apr 2023, 07:29:49 AM:INFO: Successfully stopped MicroStrategy Repository Administration.
12 Apr 2023, 07:29:49 AM:INFO: Successfully stopped PostgreSQL.
12 Apr 2023, 07:29:49 AM:INFO: Backing up PostgreSQL bin files.
12 Apr 2023, 07:29:49 AM:INFO: Backing up pgdata files.
12 Apr 2023, 07:29:49 AM:INFO: Backing up Repository Administration Tool files.
12 Apr 2023, 07:29:49 AM:INFO: MicroStrategy Repository bin files and pgdata backup completed.
12 Apr 2023, 07:29:49 AM:INFO: Extracting new postgres binary files.
12 Apr 2023, 07:29:50 AM:INFO: Installing Repository files...
12 Apr 2023, 07:29:50 AM:INFO: Copying fileset RepositoryLinuxRepositoryInstallPath files...
12 Apr 2023, 07:29:56 AM:INFO: Initializing PostgreSQL
12 Apr 2023, 07:29:57 AM:INFO: Configuring postgresql.conf file.
12 Apr 2023, 07:29:57 AM:FINE: Using port 54302 temporarily for PostgreSQL upgrade.
12 Apr 2023, 07:29:57 AM:INFO: Configuring postgresql.conf file completed
12 Apr 2023, 07:29:57 AM:INFO: Checking postgres upgrade compatibility.
12 Apr 2023, 07:29:58 AM:INFO: Upgrade compatibility check has been passed.
12 Apr 2023, 07:29:58 AM:INFO: Starting PostgreSQL upgrade.
12 Apr 2023, 07:30:04 AM:INFO: PostgreSQL upgrade completed.
12 Apr 2023, 07:30:04 AM:INFO: Restoring old cluster's configuration files.
12 Apr 2023, 07:30:04 AM:INFO: Restoring pg_hba.conf file.
12 Apr 2023, 07:30:04 AM:INFO: Restoring pg_hba.conf file completed.
12 Apr 2023, 07:30:04 AM:INFO: Restoring postgresql.conf file.
12 Apr 2023, 07:30:04 AM:INFO: Restoring postgresql.conf file completed.
12 Apr 2023, 07:30:04 AM:INFO: Checking MicroStrategy Repository status
12 Apr 2023, 07:30:05 AM:INFO: Started PostgreSQL.
12 Apr 2023, 07:30:05 AM:INFO: Cleaning up files under Repository. 

Windows

1. インストーラーを起動し、ローカルの MicroStrategy のバージョンを 2021 Update 10 にアップグレードします。

   

2. もしMicroStrategy リポジトリ以前のインストールで選択された場合は、自動的に選択されますコンポーネントを選択。アップグレードしたいコンポーネントを確認し、クリックします次。

   

3. MicroStrategy Repository への接続情報が前回のインストール以降に変更されている場合、データベース ログインのユーザー名、パスワード、およびポートを入力するように要求されます。フィールドに入力してクリック次。

   

4. 操作を進める前に、リポジトリのバックアップが要求されます。レビュー上記のセクションリポジトリのバックアップと復元に関する情報。アップグレードを続行するには、次のコマンドを入力してリポジトリをバックアップしたことを確認する必要があります。アップグレード。クリック次。

   

5. インストーラーは、システム上に十分なディスク空き容量があるかどうかを確認します。空き容量が不足している場合は、容量の要件が表示され、アップグレードが中断します。

   

6. 十分なディスク容量がある場合、リポジトリに加え、他の MicroStrategy コンポーネントのアップグレード処理も続行されます。ただし、リポジトリのアップグレードに失敗した場合は、アップグレード全体が中断し、以下の画面が表示されます。

   

   根本的な原因の分析およびトラブルシューティングの詳細な手順は、リンクをクリックしてください。問題が解決したら、インストールを再実行してアップグレードを完了します。

Performing Consistency Checks

-----------------------------
Checking cluster versions                                   ok
Checking database user is the install user                  ok
Checking database connection settings                       ok
Checking for prepared transactions                          ok
Checking for reg* data types in user tables                 ok
Checking for contrib/isn with bigint-passing mismatch       ok
Checking for tables WITH OIDS                               ok
Checking for invalid "sql_identifier" user columns          ok
Creating dump of global objects                             ok
Creating dump of database schemas
                                                            ok
Checking for presence of required libraries                 ok
Checking database user is the install user                  ok
Checking for prepared transactions                          ok

If pg_upgrade fails after this point, you must re-initdb the
new cluster before continuing.

Performing Upgrade
------------------
Analyzing all rows in the new cluster                       ok
Freezing all rows in the new cluster                        ok
Deleting files from new pg_xact                             ok
Copying old pg_xact to new server                           ok
Setting next transaction ID and epoch for new cluster       ok
Deleting files from new pg_multixact/offsets                ok
Copying old pg_multixact/offsets to new server              ok
Deleting files from new pg_multixact/members                ok
Copying old pg_multixact/members to new server              ok
Setting next multixact ID and offset for new cluster        ok
Resetting WAL archives                                      ok
Setting frozenxid and minmxid counters in new cluster       ok
Restoring global objects in the new cluster                 ok
Restoring database schemas in the new cluster
                                                            ok
Adding ".old" suffix to old global/pg_control               ok

If you want to start the old cluster, you will need to remove
the ".old" suffix from C:/Program Files (x86)/Common Files/MicroStrategy/Repository/pgsql/PGDATA/global/pg_control.old.
Because "link" mode was used, the old cluster cannot be safely
started once the new cluster has been started.

Linking user relation files
                                                            ok
Setting next OID for new cluster                            ok
Sync data directory to disk                                 ok
Creating script to analyze new cluster                      ok
Creating script to delete old cluster                       ok

Upgrade Complete
----------------
Optimizer statistics are not transferred by pg_upgrade so,
once you start the new server, consider running:
    analyze_new_cluster.bat

Running this script will delete the old cluster's data files:
    delete_old_cluster.bat

PostgreSQL のアップグレード失敗のトラブルシューティング

PostgreSQLのアップグレードに失敗した場合は、install.log根本的な原因を見つけるためです。

PostgreSQL のアップグレードが失敗する一般的なシナリオを次に示します。

ハードディスクの容量が足りない

リポジトリのアップグレードには、バックアップ、PostgreSQL バイナリ、およびデータベース移行のためのディスク容量が追加で必要になります。

インストーラーは、システム上に十分なディスク空き容量があるかどうかを確認します。空き容量が不足している場合、アップグレード プロセスが中断し、以下の警告が表示されます。

The upgrade cannot proceed as this machine does not have enough disk space.

パスワードが一致しない

MicroStrategy のインストーラーは、最初の PostgreSQL インストールを実行したスーパー ユーザーの権限を使用して古い PostgreSQL リポジトリに接続する必要があります。パスワードが変更されていて、アップグレード時に正しく指定しなかった場合、アップグレード処理に失敗する可能性があります。

古い PostgreSQL データベースに接続するには、正しいスーパー ユーザー パスワードを指定する必要があります。

アクセス権に問題がある

アップグレードを実行するユーザーが必要な権限を持っていないために、アップグレードで要求される特定のファイルやディレクトリにアクセスできない可能性があります。

MicroStrategy のインストールおよびリポジトリのアップグレードを正しく実行できるユーザーはスーパー ユーザーです。

構成設定に誤りがある

アップグレード プロセスで、PostgreSQL の構成設定を更新しなければならない場合があります。設定に誤りがあると、アップグレードに失敗する可能性があります。

無効な設定が含まれているため、構成ファイルが有効でないことを示すエラー メッセージがログに記録されます。無効な構成を修正し、インストールを再実行する必要があります。

データが破損している

移行中のデータにエラーや問題がある場合、アップグレード プロセス中にデータが破損することがあります。

データベースのデータ ファイルが破損していることを示すエラー メッセージがログに記録されます。バックアップからデータを復元し、再度インストールを実行してデータ エラーを修復する必要があります。

フェイルオーバーのシナリオと復元

アップグレード中に PostgreSQL のデータ ファイルが中断された場合、アップグレードを開始する前に取得したバックアップからデータベースを復元しなければならない場合があります。

• MicroStrategy Repository 管理ツールでバックアップした場合、そのツールを使用して復元する必要があります。以下の手順に従ってくださいリポジトリ管理復元を実行します。

• ネイティブ PostgreSQL バックアップ ユーティリティでバックアップした場合、ネイティブ PostgreSQL 復元ユーティリティで復元することを推奨します。

Windows

デフォルトパス: C:\Program Files (x86)\Common Files\MicroStrategy\Repository\pgsql\bin

例:

# To restore platform_analytics_wh from dump file with creating same database name
pg_restore -d postgres -Umstr --clean --create platform_analytics_wh.dump

# To restore mstr_collab to the new created database from dump file
psql -Umstr -d mstr_collab < mstr_collab.sql

# To restore pg_dumpall file all_dbs.out
psql -Umstr -f all_dbs.out postgres

Linux

デフォルトパス: /opt/mstr/MicroStrategy/install/Repository/bin

例:

# To restore database platform_analytics_wh
cd /opt/mstr/MicroStrategy/install/Repository/bin
./mstr_pg_restore -d platform_analytics_wh -Umstr < platform_analytics_wh.dump