Skip to main content

バージョンごとのServerアップグレードガイド: サポートされているバージョン

重要

Serverアップグレードチェックリストをご確認いただき、アップグレードが失敗する問題を特定できる、アップグレード前のチェックワークフローなど、Serverを正常にアップグレードするための計画と実行にお役立てください。

このドキュメントがどのように役立つか

このドキュメントでは、Alteryx Serverのバージョンをアップグレードする際に注意する必要があるタスクと変更点について説明しています。問題は累積的なため、複数バージョンのアップグレードを通して各セクションを読んでください。これはリリースノートに代わるものではありません(各セクションのリンクから参照してください)。

リリーススケジュール

  • 半年ごとのリリースで、機能が追加されますが、管理者やユーザーの動作変更が必要な、Server管理が変更されることもあります。

  • 各四半期内のメンテナンスリリース/パッチでは、初期リリースで見つかった問題に対処します。たとえば、2022.3の最初のメンテナンスリリースは2022.3.2になります。

凡例

ピットストップ

重要な変更があり、新しいバージョンにアップグレードする前に、このバージョンにアップグレードする必要があります。

MongoDBのアップグレード

Mongoデータベースのバージョンがアップグレードされます。

Alteryx Serverアップグレードでは、現在のバージョンとターゲットアップグレードバージョン間のMongoDBバージョンアップグレードを1つだけ含めることができます。

重要

重要な問題: 管理者は、このバージョン以降に移行するときに、対処するか認識する必要があります。

このリストのエントリ基準

このリストでは、各バージョンのリリースノートを要約して、以下についてハイライトしています。

  • 管理者またはユーザーがアクションを実行する必要がある。

  • アップグレードバージョンの選択で重要な項目(変更された動作や欠陥)。

  • Serverの管理に大きな変更があった。

関連記事

2022.3

新機能/リリースノート/Serverコミュニティブログ/概要コミュニティブログ

バージョン

このバージョン以降にアップグレードするときに必要なアクション。

2022.3

重要

2022.1不具合TCPE-1100のアップグレード要件: 2022.1からこのバージョン以降のバージョンにアップグレードする場合、パッチが必要です。

影響: 現在22.1を使用している場合は、TCPE-1100の不具合を回避するために、22.3にアップグレードする前に22.1.1.9.42691パッチ9以降を使用する必要があります。  この不具合はワークフローのリビジョン番号に反映され、すべてが「1」に設定されます。

タスク: パッチ9以降を使用していない場合は、アップグレードを続行する前に最新の22.1パッチを適用します。

2022.3

重要

MongoDBの再暗号化: データベースコレクションは、アップグレード前にAES256とSHA256のハッシュ標準で再暗号化する必要があります。

影響: 2022.3以降にアップグレードする前に、暗号化の移行準備ツールを実行して、Serverを機能させつつ、バックグラウンドでワークフローを再暗号化する必要があります。この準備ツールを実行した後、アップグレード後にサービスが初めて起動するとき、さらにいくつかのコレクションとRuntimeSettings.xmlも暗号化移行されます。

タスク:

このプロセスを開始する前に、Serverが2021.2以降になっている必要があります。以前のバージョンを使用している場合は、2022.3+にアップグレードする前に、2021.2~2022.1のバージョンにアップグレードします。

Serverをアップグレードする前に暗号化の移行準備ツールを実行して、移行ログに;3;が含まれるエラー行がないかを確認します。移行の問題が解決するまで、Serverをアップグレードしないでください。Serverのアップグレードが失敗した場合、追加コレクションの移行中にエラーが発生する可能性があるため、ログを再確認してください。

アップグレード後、暗号化されていない古いコレクションを削除できます。作成された一時ファイルのクリーンアップとMongoデータベースのサイズ縮小については、サポートまでお問い合わせください(CSEはこちらを参照してください)。

アップグレードをロールバックする必要がある場合は、アップグレード中に作成されたRuntimeSettings.xmlのバックアップの復元が以下で必要になります。C:\ProgramData\Alteryx\

2022.3

重要

Designerバージョンの要件: Designer 2022.3が必要

影響: 2022.3 Serverで使用される暗号化メソッドにはDesigner 2022.3が必要です。

タスク: ワークフローをServerに保存するには、Designerをアップグレードする必要があります。

2022.3

重要

設定の変更: SAML ACSエンドポイントはすべて小文字にする必要があります

影響: 現在ACSエンドポイントは小文字になりましたが(/saml2/acs)、以前は大文字と小文字が混在していました(/Saml2/Acs)。  これによりサービスは開始されません。  (TCPE-940は、以前の大文字と小文字の使用も、エラーなしで受け入れられるよう求めています)

タスク: IDPのACSエンドポイントをすべて小文字に変更します。

2022.3パッチ2

管理上の変更: 共有サーバーデータベース接続を使用して、ワークフローを実行できるオプション

影響: コレクションを介してワークフローを共有しているすべてのユーザーが、共有Serverデータベース接続を使用するワークフローを実行できるように、資格情報を共有せずにワークフローへのアクセスを許可するオプションが追加されました。他のユーザーはGallery接続を明示的に共有する必要はありません。

タスク: [Server UI] > [管理者] > [設定] > [アセット]に移動します。次に、[資格情報を共有せずにワークフローへのアクセスを許可する]チェックボックスを選択します。

2022.3

管理の変更: ロードバランサー

影響: [Alteryxシステム設定] > [Server UI] > [Canonical Address]オプションが追加され、ServerからのEメールメッセージで、ユーザーがServer UIにアクセスするために使用するURLが使用されるようになりました。

タスク: ロードバランサーを使用している場合は、その値をユーザーがServer UIまたはAPIへのアクセスに通常使用するURLに設定します。

2022.3

Server使用状況レポートが廃止されました

影響: Server使用状況レポートはAlteryxでサポートされなくなりました。以前のバージョンでは引き続き有効です。

2022.3

パスワード管理: HashiCorpとCyberArkのパスワード保管庫サポートが追加されました

2022.3

安全性の低いハンドシェイク再ネゴシエーションへのダウンロードツールアクセス: 設定ファイルでサイト固有の制御が可能です

影響: ダウンロードツールから「SSL接続エラー」を受信した場合は、ピア検証許可リストを使用してください。ダウンロードツールはOpenSSL 3.0.7に更新されました。

2022.3

内部変更: コントローラートークンの長さ

影響: Server 2021.4ではより長くより安全なコントローラートークンが導入されましたが、2021.3からのアップグレードでは短いトークンが維持されていました。トークンがある時点でより長く再生成されなかった場合、2022.3のアップグレードでは自動的に再生成されます。すべてのノードで同じ方法で行われるため、同じ長さのトークンを作成して、アップグレード後にコントローラーと通信できます。

タスク: 新しいコントローラートークンを使用して、将来のServerアーキテクチャに新しいノードを追加します。

2022.3

不具合TGAL-7199: ラベルが「1」のワークフローのすべてのバージョン(2022.3.1パッチ2で修正済み)

影響: ワークフローのバージョンのリストを表示すると、すべてのバージョンが連続したバージョン番号ではなく「1」と表示されます。これはUIの問題であり、ジョブの実行には正しいバージョンが使用されています。

2023.1

新機能/リリースノート

バージョン

このバージョン以降にアップグレードするときに必要なアクション。

2023.1

重要

Designerの最低バージョン

影響: Serverとの接続にDesigner 2022.3パッチ3以降が必要です。Server 2023.1リリースノートを参照してください。

2023.1

管理上の変更: 共有サーバーデータベース接続を使用して、ワークフローを実行できるオプション

影響: コレクションを介してワークフローを共有しているすべてのユーザーが、共有Serverデータベース接続を使用するワークフローを実行できるように、資格情報を共有せずにワークフローへのアクセスを許可するオプションが追加されました。他のユーザーはGallery接続を明示的に共有する必要はありません。

タスク: [Server UI] > [管理者] > [設定] > [アセット] > [資格情報を共有せずにワークフローへのアクセスを許可する]チェックボックスを選択します。

2023.1

パスワード管理: AWS Secrets Managerのパスワード保管庫のサポートが追加されました

影響: AWS Secrets Manager

2023.1

APIの追加: Active Directory (AD)認証のServerの場合、ADグループをカスタムグループに追加できます

影響: 追加されたエンドポイント:

  • POST /v3/usergroups/{id}/activedirectorygroups

  • DELETE /v3/usergroups/{userGroupId}/activedirectorygroups/{adGroupSid}

2023.1

管理上の変更: SAML認証によるAzure Active Directoryグループをサポート

影響: 管理者は、Azure Active Directory (Azure AD)とSCIMプロトコルを使用して、ユーザーとグループのアクセス権をServerで同期できるようになりました。

タスク: Alteryx Server SCIM Azure Active Directoryを設定します。

2023.1

DCM機能: DesignerとServer間のDCM同期を無効にするオプション

影響: この機能は、本番環境のServerでユーザーが誤って同期して、ローカルDesignerで本番環境の資格情報を使用しないようにするために役立ちます。

タスク: [Alteryxシステム設定] > [DCM] > [Block DCM Connections Synchronization between Server and Designer]チェックボックスを選択します。詳細については、「DCMサーバー」を参照してください。

2023.1

管理上の変更: ワーカーはユニークな資格情報を使用してユーザー管理MongoDBに接続できます。

影響: これにより、ワーカーごとの監査が可能になります。

2023.1

データベース接続: 32ビットデータベース接続のサポート終了

影響: 32ビットデータベース接続に関するFAQのサポートが終了しました。32ビット接続はもう機能しません。

2023.1

Rインストーラー

重要

Rアップグレード: RInstaller_2023.1.200.exe+で埋め込まれるRバージョンが、4.1.3から4.2.3にアップグレード

影響: Rバージョンは、以下のように4.1.3または4.2.3になります。

  • Rバージョン4.1.3=Server 23.1のインストール(すべてのバージョン)

  • Rバージョン4.1.3=RInstaller_2023.1.1.123

  • Rバージョン4.2.3=RInstaller_2023.1.1.200+

  • パッチはRバージョンには影響しません。

タスク:

  • 特定のRInstaller_2023を使用して、特定のRバージョンにします。

  • 4.2.3へのアップグレード時に外部Rライブラリを再インストールし、ワークフローでRを再テストするようユーザーに指示します。

  • DesignerのRバージョンは、Serverで使用しているRバージョンと一致する必要があります。

Rバージョン4.2.3互換パッケージでRツールを使用する方法

2023.1

分析アプリの不具合(2023.1パッチ2で修正済み)

影響:

  • TPRI-2043: ドロップダウンとリストボックスツールが、名前:値のペアの値ではなく名前を返す。

  • TGAL-8126: 日付ツールが選択した日付から前の日付を返す。

2023.1

重要

Connect製品: Connectは初期の2023.1リリースと互換性がありません

影響: リリースノートには、どのパッチが2022.3との互換性があるかが記載されます。

2023.2

新機能/リリースノート

バージョン

このバージョン以降にアップグレードするときに必要なアクション。

2023.2

MongoDB 6.0.5

MongoDBのアップグレード: 埋め込みMongoDBがバージョン4.2.15から6.0.5にアップグレード

影響: 埋め込みMongoDBが6.0.5にアップグレード

タスク: 埋め込みMongoDBを使用している場合、このバージョン以降にアップグレードすると、MongoDBがバージョン6.0.5にアップグレードされます。現在のMongoDBサイズの1~2倍の空きドライブ容量が必要です。

2023.2

重要

MongoDBアップグレードのダイアログ: 埋め込みMongoDBアップグレードを開始するダイアログが最小化されます

影響: 2023.2にアップグレードするとき、アップグレードの[終了]を選択すると、埋め込みMongoDBの移行ダイアログが開きますが、すぐに最小化され、アップグレードが完了したような印象を与えます[TGAL-9041]。詳細については、サーバーバージョン23.2へのアップグレード時のサービスログのエラー: 5.0、5.3、6.0に予想される無効な機能互換性バージョン値を参照してください。

タスク: このダイアログが表示されていることを確認して、MongoDBアップグレードの開始をクリックします。サービスはMongoDBがアップグレードされるまで開始しません。

2023.2

MongoDBの変更: ServiceDataBlobフィールドがAlteryxGalleryコレクションから削除されました

影響: ServiceDataBlobフィールドはAlteryxGalleryコレクションから削除され、そのフィールドが標準のMongoDBフィールドとして表示されるようになりました。

タスク: ServiceDataParserマクロを使用をしてこのBlobからデータを解凍する管理ワークフローがある場合は、そのリファクタリングが必要になります。

2023.2

DCM管理の変更: コラボレーションでDCM接続を共有できるようになりました

影響: Server UIでDCM接続を共有するときに、[コラボレーションのために共有]オプションで、Designer内の他のユーザーがDCM接続を使用できます。詳細については、データ接続マネージャー: Server UI>Designerでの共有を参照してください。

タスク: この変更により、共有ワークフローのコラボレーションが容易になり、同僚のDCM接続を使用して新しいワークフローを作成できます。

2023.2

Pythonのアップグレード: 埋め込みPythonの3.8.5から3.8.16へのアップグレード

影響: ワークフローでPythonを再テストする必要があります。EngineではまだPythonバージョン3が使用されるため、スクリプトへの影響はほとんどありません。

タスク: 詳細については、Alteryx埋め込みPythonを参照してください。

2024.1

新機能/リリースノート

バージョン

このバージョン以降にアップグレードするときに必要なアクション。

2024.1

管理上の機能: UIとAPIを介してアセットの所有権を移転する機能

管理者は、Server UIまたはServer API V3エンドポイントを使用して、ユーザー間でワークフローとスケジュールの所有権を移転できます。

影響:

注記

  • ワークフロージョブ履歴は新しい所有者に表示されません。

  • ワークフローは新しい所有者のスタジオに移動し、移動元または移動先のスタジオで他のユーザーへの表示に影響を与えます。

  • ワークフローを正常に実行するには、以下の追加要素を新しい所有者と共有する必要があります。

    • DCM 接続

    • 共有のGalleryデータベース接続

    • 共有のGallery資格情報

2024.1

新機能: 新しいデータベースオプションの追加(SQL DB)

MongoDBの代わりにユーザー管理SQL Serverデータベースを使用できます。現在、公式にサポートされているSQLのバージョンは、MSSQL Server 2019とMSSQL Server 2022のみです。

影響:

2024.1

重要

Pythonのアップグレード: 埋め込みPythonの3.8.16から3.10.13へのアップグレード

影響:

互換性のないバージョンのコネクタがDesignerで使用されている場合、以下のエラーメッセージが表示されます。「バージョン3.8はAlteryx割り当てで見つかりませんでした。別のバージョンを選択してください。Internal Error - Deadlock detected.」

タスク:

  • すべてのコネクタツールを新しいバージョンに置き換える必要があります。

  • ユーザーはワークフローでPythonを再テストする必要があります。EngineではまだPythonバージョン3が使用されるため、スクリプトへの影響はほとんどありません。

2024.1

重要

MongoDBの日時フィールドの変更(ServerデータベースでサービスのタイムスタンプがUTC形式に移行)

影響: すべての日時フィールドがUTCに移行され、タイムゾーンと夏時間の変更処理が改善されました。詳細については、Server 2024.1のリリースノートを参照してください。

  • タイムスタンプ要素があるすべてのServer APIが影響を受けます。

  • 古いバージョンから2024.1にアップグレードする場合、AlteryxServiceの起動時に既存のアセットのタイムスタンプが新しいUTC標準に変換されます。

タスク: MongoDBまたはAPIにアクセスするアプリケーションで日時フィールドがどのように処理されるかを確認します。UTCの日時になるように調整が必要な場合があります。

2024.1

DCMの開発/実稼働Server管理: 本番環境Serverでは、開発DCMを実稼働接続にリダイレクトできます

影響: DCM接続とDCM接続処理が管理者メニューに追加されました。詳細については、以下のヘルプページを参照してください。

タスク: 実稼働ServerにDCMリダイレクトを追加することで、ワークフローを変更せずに、開発環境から移行したワークフローが実稼働データソースにアクセスできるようになります。

2024.1

DCMの管理: ユーザー権限の粒度

影響: 新しいDCM権限が追加されました。詳細については、ユーザーロールと権限ヘルプページを参照してください。

2024.1

DCMの管理: DCM汎用外部保管庫の追加

影響: 基本認証を使用するプログラムインターフェースで、任意の保管庫からシークレットを取得できる汎用保管庫を設定できます。

2024.1

管理上の変更: DCMの同時共有

影響: コラボレーション用と実行用に別々に、同じDCM接続を共有できます。以前は1つの共有オプションしか選択できませんでした。詳細については、データ接続マネージャー: Server UIを参照してください。

2024.1

インサイトのサポート終了について

影響: Alteryx Serverでインサイトを利用できなくなりました。詳細については、FAQページを参照してください。

2024.2

新機能/リリースノート

バージョン

このバージョン以降にアップグレードするときに必要なアクション。

2024.2

ピットストップ

重要

組み込みのMongoDBをバージョン7にアップグレードする

影響: Server 2024.2のインストールの一部で、埋め込みMongoDBがバージョン7.0にアップグレードされます。アップグレードに必要な最小のServerバージョンは23.2 (MongoDBバージョン6.0)です。

タスク: Serverバージョンが2023.2または2024.1であることを確認し、Server 2024.2リリースノートに記載されている手順に従ってください。

2024.2

データ接続とワークフローをDCMに移行する

共有Serverのデータ接続をDCM接続に移行できるようになりました。これについては、Serverデータ接続をDCMとデータ接続に移行する方法を確認してください。

2024.2

スタジオ内のユーザーを1人に制限する機能

スタジオ内のユーザーを1人に制限することで、管理者が共有スタジオをオフにできるオプションが追加されました。管理者は、ワークフローをあるスタジオから別のスタジオに移行することで、アセットの所有権を簡単に移行できるようになりました。

スタジオのメンバー数を1人に制限するには、[管理者] > [設定] > [設定] > [ユーザー]に移動します。次に、[スタジオを1名のユーザーに制限]チェックボックスを選択します。詳細については、Alteryx Serverの設定を参照してください。

2024.2

ワークフロー公開の制限: グローバル設定

管理者は、[パブリックワークフローの制限(グローバル)]チェックボックスをオンまたはオフにすることで、ワークフローの公開方法(公開または非公開)を制御できるようになりました。これを行うには、[管理者] > [設定] > [セキュリティ]に移動します。

詳細については、Alteryx Serverの設定を参照してください。

2024.2

Designerプロキシ設定の拡張

Designerに、[オプション] > [ユーザー設定] > [ユーザー設定の編集] > [プロキシ] > [新しいプロキシ設定を有効にする(プレビュー版)]が追加されました。これにより、プロキシ設定を制御しやすくなり、PACスクリプトを使用できるようになります。

: この初期リリースでは、この設定はDesignerのいくつかの機能(ダウンロードツールなど)に適用されますが、他の機能(コネクタやODBCなど)には適用されません。詳細については、ユーザー設定を参照してください。

2024.2

システム設定の「実行時間の秒数がこれより長い場合はジョブをキャンセル」がすべてのジョブに適用されるようになりました

以前のバージョンでは、この設定はスケジュールされたジョブにのみ適用されていました。手動ジョブをスケジュールされたジョブよりも長く実行するには、この設定をクリアし、以下で説明する2つの新しいServer UIオプションを使用します。

詳細については、Alteryx Serverの設定を参照してください。

実行時間の長い手動ジョブ実行のキャンセルに追加されたオプション

[Server UI] > [管理者] > [設定] > [アセット]に、指定した時間より長く実行される、手動ジョブの実行(APIジョブ実行を含む)をキャンセルする新しいオプションが追加されました。これは、そのワーカーが[Alteryxシステム設定] > [ワーカー] > [一般] > [実行時間の秒数がこれより長い場合はジョブをキャンセル]を設定していない限り、すべてのワーカーに適用されます。ワーカーの設定はServer UIの設定よりも優先されます。

実行時間の長いスケジュールされたジョブ実行のキャンセルに追加されたオプション

[Server UI] > [管理者] > [設定] > [アセット]に、指定した時間より長く実行される、スケジュールされたジョブの実行をキャンセルする新しいオプションが追加されました。これは、そのワーカーが[Alteryxシステム設定] > [ワーカー] > [一般] > [実行時間の秒数がこれより長い場合はジョブをキャンセル]を設定していない限り、すべてのワーカーに適用されます。ワーカーの設定はServer UIの設定よりも優先されます。

2024.2

APIの更新:

GET v3/workflows/{workflowID}/jobsに追加されたAPIフィルタリング

GET v3/workflows/{workflowID}/jobsエンドポイントを使用して、オプションでステータスとResultCode別にフィルタリングし、これらのフィルターに一致するジョブIDのリストを返せるようになりました。詳細については、Server 2024.2のリリースノートワークフローエンドポイントを参照してください。

  • タイムスタンプ要素があるすべてのServer APIが影響を受けます。

  • 古いバージョンから2024.1にアップグレードする場合、AlteryxServiceの起動時に既存のアセットのタイムスタンプが新しいUTC標準に変換されます。

タスク: MongoDBまたはAPIにアクセスするアプリケーションで日時フィールドがどのように処理されるかを確認します。UTCの日時になるように調整が必要な場合があります。

サブスクリプション(スタジオ)用の新しいAPIエンドポイント

管理者はServer V3 APIエンドポイントを使用して、サブスクリプション(スタジオ)を管理できるようになりました。これらのエンドポイントはサブスクリプションを一括編集するのに役立ち、個々のユーザーをそれぞれのスタジオに戻す機能を提供します。

これらのエンドポイントの詳細については、サブスクリプションエンドポイントを参照してください。

ワークフローエンドポイントのAPI更新

  • SourceAppIdが、以下のAPI呼び出しの応答の本文で返されるようになりました。

    • GET/v3/workflows

    • GET/v3/workflow/{workflowID}

    • GET /admin/v1/workflows/migratable

  • クリエイターは以下の呼び出しができるようになりました:get v3 /workflows/{workflowId}

  • [ステータス]と[結果コード]によるフィルタリングが、GET v3/workflows/{workflowID}/jobsに追加されました。

詳細については、Server 2024.2のリリースノートワークフローエンドポイントを参照してください。

個々のスケジュール設定を更新できる新しいAPIエンドポイント

新しいAPIエンドポイントPATCH /v3/schedules/{scheduleId}を使用して、一度の変更を行うために複数の必須フィールドを入力することなく、スケジュールを更新できるようになりました。詳細については、スケジュールエンドポイントを参照してください。

ジョブエンドポイントの更新

  • 新しいAPIエンドポイントGET /v3/jobs/{jobId}/messages

    このエンドポイントは管理者専用です。入力パラメーターにjobIdを使用して、そのジョブに対応するメッセージを取得します。

  • 更新されたAPIエンドポイントGET /v3/jobs/{jobId}

    GET /v3/jobs/{jobId} エンドポイントが更新され、コレクションで共有されているジョブをユーザーが確認できるようになりました。

詳細については、ジョブエンドポイントを参照してください。