Skip to main content

Alteryx Serverのダウングレード

この資料では、Alteryx Serverをダウングレードする方法について説明します。

Alteryx Serverのアップグレードは予期しない問題を招く場合があり、さらなる業務の中断を避けるためには、緊急でその問題を解決するかダウングレードする必要が生じます。コミュニティページ のリソースあるいはAlteryxサポートへのお問い合わせで、ほとんどの問題を解決できます。特定の状況においては、根本的な問題を解決するために、最新の動作バージョンの復元が必要になります。

注記

ダウングレードする前に、Alteryxコミュニティ を検索し、Alteryxサポート に連絡して、ダウングレードの理由について話し合うことができます。

重要

アップグレードをする前に、MongoDBのバックアップ があることを確認してください。これがなければ、ダウングレードすることはできません。

重要

MongoDBからユーザー管理MSSQLに移行した場合、SQL Serverのサポートは2024.1以降でのみ利用可能なため、2024.1以前のリリースにダウングレードすることはできません。

ユーザー管理SQL環境からダウングレードするには、まずSQLに移行する前に使用していたMongoDBの最後のバージョンに切り替える必要があります。移行前にMongoDBのバックアップを作成している場合は、現在のSQLデータベースと切り替えることができます。これを行うには、Alteryxシステム設定で、コントローラーとServer UIの接続文字列を更新して、古いMongoDBを再度指定するようにします。バックアップの詳細については、Serverのバックアップとリカバリに関するこちらのナレッジ記事を参照してください。これを行うと、移行を行った時点のMongoDBの状態に戻ります。そのため、SQLへの移行後に環境に加えられた変更は、古いMongoDBには反映されません。

環境

  • Alteryx Server(全バージョン)

  • 組み込み型またはユーザー管理型のMongoDB (全バージョン)

必要条件

  • Serverマシンについて管理者権限が必要です。

  • ダウングレードを実行するためのServerダウンタイム(メンテナンス)のウィンドウ。

    Serverのダウンタイムウィンドウの計画は必須ではなく、社内ポリシーによって異なります。ダウンタイムウィンドウの長さは、設定とデータベースのサイズによって変わります。

  • ダウングレードしようとするServerの以前のバージョンのインストーラーファイル。

  • ダウングレードしようとする以前のバージョンで取得したMongoDBのバックアップ。詳細については、「Alteryx Serverのバックアップとリカバリ手順」の記事を参照してください。

  • バージョン2022.3以降から2022.3より前のバージョンにダウングレードする場合は、バージョン2022.3以降にアップグレードするためのRuntimeSettings.xmlファイルのバックアップが必要です。C:\ProgramData\Alteryx\RuntimeSettings.22_2_legacy.xml

Alteryx Serverのダウングレード

この手順は、Alteryx Serverを同じ環境で以前に実行されていた古いバージョンにダウングレードする方法を示します。この記事での説明のために、Alteryx Server 2023.1から2022.3へのダウングレードを例にとります。

  1. Alteryx Serverに接続します。マルチノード環境の場合は、組み込みMongoDBまたはユーザー管理MongoDBをホストしているコントローラーノードに接続します。

  2. Services.msc コンソールを開き、サービスを 停止 します。

    サービスを停止する方法の詳細については、AlteryxServiceを開始する方法を参照してください。この記事で説明されている手順Aで、[開始]の代わりに[停止]を使用します。

  3. コントロールパネル を開くには、[開始] メニュー で [コントロールパネル] を検索します。

  4. [プログラム] を選択して、Alteryx Server 2023.1をアンインストールします。アンインストーラーは、Alteryx予測ツールセットも自動的にアンインストールします。

    downgrade_Server_01_03.png

  5. バージョン2022.3以降から2022.3より前のバージョンにダウングレードする場合は、元のRuntimeSettings.xml を復元する必要があります。

    1. RuntimeSettings.xmlファイルがあるフォルダー(例えば%ProgramData%\Alteryx\RuntimeSettings.xml)に移動して、そのファイルを右クリックし、[名前の変更] を選択します。次に、名前を RuntimeSettings_rollback_bkp.xml に変更します。

    2. 同じフォルダー内で、RuntimeSettings.22_2_legacy.xml を右クリックし [名前の変更] を選択して、ファイル名を RuntimeSettings.xml に変更します。

  6. 完全にアンインストールしたら、2022.3(またはダウングレードするバージョン)用のAlteryx Serverインストーラーを実行します。インストーラーファイルを右クリックし、[管理者として実行] を選択します。

    注記

    以前とまったく同じバージョンで、同じパッチレベルまでダウングレードしていることを確認してください。以前にどのパッチを使用していたかわからない場合は、そのバージョンの最新パッチにダウングレードしてください。

  7. ライセンス契約を確認し、[次へ] を選択します。

  8. 既定の場所と異なる場合は、インストール先のフォルダーパスを選択して、[次へ] を選択します。

    downgrade_Server_02_02.png

  9. インストールが完了すると、以下の図に示すように予測ツールセットをインストールするように求められます。このバージョンを引き続き使用する予定で、予測ツールセットに依存するワークフローがある場合は、[予測ツールをインストール] を選択し、[完了] を選択します。そうでない場合は、[閉じる] を選択し、Alteryx Designerを後で実行して、[完了] を選択します。

    downgrade_Server_03_02.png

注記

マルチノード環境では、ノードごとに同じ手順を実行します。

MongoDBの復元

次の手順で、MongoDBデータベースを以前のバージョンに復元します。

  1. この時点では、Alteryx Serviceは停止状態のままで作業します。確認するには、Services.msc コンソールを確認します。

  2. Rename the current Persistence folder to “MongoDB_failedUpgradeAttempt_to_version##”.  While this folder is no longer in use, it’s best practice to avoid deleting files and folders during a Server incident.

  3. Recreate the Persistence folder in File Explorer. The folder is now empty and ready for the database restore.

  4. ダウングレードする先のバージョンから取得した最新のMongoDBのバックアップからMongoDBを復元します。MongoDBの復元と、それが成功したと確認する手順については、「MongoDBのバックアップ」ヘルプページの「MongoDBバックアップからの復元」セクションを参照してください。

注記

To confirm your Persistence folder, go to Alteryx System Settings > Controller > Persistence > Data Folder, or go to C:\ProgramData\Alteryx\RuntimeSettings.xml and search for <EmbeddedMongoDBEnabled>.

ダウングレード後のチェック事項

  • Server UIがアクセス可能で、ユーザー、ワークフロー、スケジュールなどの期待されるコンテンツが正常に復元されたことを確認します。

  • Serverログに予期しないロックがないかどうかを確認します。ログファイルの場所については、「Serverログファイルを添付する方法」を参照してください。以下のエラーが表示された場合は、Mongoコマンドdb.locks.remove({})を実行してロックを削除します。成功すると、writeResult({ “nRemoved” : N })が表示されます。このNの数値は0から3までの値です。

    • 2020-05-11 15:53:06.564593,FATAL,18,QueueWorker,RunOnce,,,,LD-LT-241,,,,,,Lock obtain timed out: MongoDB.Lucene.MongoDocumentLock->Retry in (1) seconds...,"Lucene.Net.Store.LockObtainFailedException: Lock obtain timed out: MongoDB.Lucene.MongoDocumentLock-context, String name)

    • 2020-05-11 15:33:59.700855,FATAL,20,QueueWorker,RunOnce,,,,LD-LT-241,,,,,,Failed to obtain IndexWriter lock.->Retry in (1) seconds...,System.Exception: Failed to obtain IndexWriter lock.-> at Alteryx.Server.Models.BackgroundThread.QueueWorker.RunOnce()

注記

このプロセスの実行に不安がある場合は、Alteryxサポート にお問い合わせください。

このセクションの内容: