Skip to main content

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

重要

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

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

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

このドキュメントでは、サポートされていないバージョンのServerについてのみ説明しています。サポートされているバージョンについて詳しくは、「バージョンごとのServerアップグレードガイド: サポートされているバージョン」を参照してください。

リリーススケジュール

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

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

凡例

ピットストップ

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

MongoDBのアップグレード

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

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

重要

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

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

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

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

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

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

関連記事

2018.1

バージョン

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

2018.1

MongoDB 3.4

MongoDBのアップグレード: 埋め込みMongoDBのバージョン3.0.4から3.4にアップグレード。

タスク: 埋め込みMongoを使用している場合、2021.4+にアップグレードする前に2019.3-2021.3にアップグレードすると、埋め込みMongoをバージョン4.0にアップグレードできます。現在のMongoデータベースサイズの1~3倍の空きドライブ容量が必要です。

2019.3

バージョン

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

2019.3

MongoDB 4.0

MongoDBのアップグレード: 埋め込みMongoDBのバージョン3.4から4.0.10へのアップグレード

タスク: 埋め込みMongoを使用している場合、2021.4+にアップグレードする前に2019.3-2021.3にアップグレードすると、埋め込みMongoをバージョン4.0にアップグレードできます。現在のMongoデータベースサイズの1~3倍の空きドライブ容量が必要です。

2019.3

重要

Pythonのアップグレード: 埋め込みPythonの3.6.0から3.6.8へのアップグレード(Conda)

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

タスク: すべてのコネクタツールをYXIから再インストールする必要があります。

2020.1

バージョン

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

2020.1

MongoDBの問題: ユーザー名、メールアドレス、サブスクリプションがNullの場合、このバージョンと将来のバージョンでアップグレードに失敗します。

タスク: このバージョン以降にアップグレードする前に、アップグレード前チェックワークフローを使用してNull値を特定します。

2020.1

管理上の変更: クリエイターは、既定でコレクションを作成できるようになりました。

影響: これにより、これまでクリエイターが持っていなかった機能が追加されます。

タスク: ユーザーのこの機能を削除するには、ユーザーレコードを編集し、[コレクションの作成]を[いいえ]に設定します。

2020.1

管理上の変更: ビューワーロールのユーザーが、共有されているコレクションのワークフローを実行できなくなりました(TGAL-2666)。

影響: コレクション内で共有されているワークフローをユーザーが実行する場合は、[ロール]を[メンバー]に設定する必要があります。予想されるエラーメッセージ: This Workflow is published in a private Studio.プライベートスタジオで公開されたワークフローを実行するには、Analytics Galleryメンバーシップが必要です。メンバーシップをリクエストするには、ワークフローを共有しているクリエイターに連絡してください。メンバーシップの詳細については、sales@ Alteryx .comまでお問い合わせください。

タスク:ユーザーの[ロール]を[メンバー]に設定します。

2020.1

不具合TGAL-2745: AD認証を使用している場合、スケジュール、コレクション、個々のユーザーが表示されない(2020.3.9で修正済み)。

影響: Active Directory認証を使用していて、ADユーザーが削除された場合:

  • 編集時に、ユーザーレコードに以下のエラーが表示されます: 不明なエラー: IdentityNotMappedException

  • スケジュールまたはコレクションを所有している場合は、そのビューにError loading schedules or Error loading collectionsと表示されます。

タスク: アップグレード前にADユーザーアカウントを削除したServerユーザーがいるかどうかを確認するには、AD健全性チェックワークフローを実行します。この問題が発生した場合は、カスタマサポートに連絡してWindows認証を使用時のCSE Galleryエラーを解決します。

2020.2

バージョン

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

2020.2

新しい機能

2020.3

バージョン

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

2020.3

新しい機能

  • ユーザーとグループの管理

  • APIを介してファイル参照ツールが含まれるワークフローを実行する機能

  • 直接ダウンロードを無効にする機能

2020.3

不具合TSM-317: 出力ツールのSQL Serverエラー(2021.2で修正済み)

影響: Output Tool SQL Server: An unknown error occurred in II_PushRecord (出力ツールSQL Server: 不明なエラーがII_PushRecordで発生しました)を参照してください。

2020.3

不具合TGAL-2832: ADグループを使用していると、ADの「表示名」が使用されて、それが異なるか空白になる場合がある(2021.4で修正済み)

影響: AD認証を使用している場合、ADグループ名が「ネットワーク名」から「表示名」フィールドに変わりました。そのため、ADグループ名がServer UIで異なって表示されるか、完全に空白になる場合があります。

タスク: Active Directory Groups Not Showing when Adding Groups (グループを追加するときに表示されないActive Directoryグループ)を参照してください。

2020.3

重要

不具合TGAL-2671: Active Directory認証によりユーザーリストの管理者アクセスが遅くなる(2020.4で修正済み)

影響: Active Directory認証を使用している場合は、バージョン2020.4以降に移行します。

2020.4

バージョン

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

2020.4

重要

Pythonのアップグレード: 埋め込みPythonの3.6.8から3.8.5へのアップグレード(Conda)

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

タスク: Pythonを使用するすべてのコネクタツールはYXIから再インストールする必要があります。

2020.4

新しい機能

2020.4

管理上の変更: コレクションをプライベートスタジオと共有できなくなり、代わりにユーザーとコレクションを共有します。

影響: この機能では以前、Active Directory認証を使用するServerでバックドアが利用され、さまざまなADフォレストのユーザーがコレクションにアクセスできる事態となりました。

そのバックドアは以下のような手順でした。

  1. 他のドメインのADユーザーがServer UI Webサイトにアクセスした。

  2. これにより、他のドメインのADユーザーに対し、プライベートスタジオとServerUserレコードが作成された。

  3. コレクションはその後、プライベートスタジオと共有されて、この他のADドメインから入ったServerユーザーに、コレクションへのアクセス権が与えられた。

今後、コレクションは同じADフォレスト内のユーザーだけで共有されるため、異なるドメインのADユーザーはコレクションの共有ができません。

2020.4

不具合TGAL-6039: AD認証を使用している場合、コレクション所有者を変更できない(2022.1で修正済み)

影響: Active Directory認証を使用している場合、コレクションを所有するServerユーザーのADユーザーを削除すると、コレクションの所有者を変更するページが空白になります。

タスク: この問題を解決するには、Server UIでユーザーを編集し、[ロール]を[アクセス権なし]に設定します。

2020.4

不具合TDALI-1078: レンダリングツールから出力するPowerPointが破損する(2022.3で修正済み)

影響: PPT/PPTXファイルを開くと以下のエラーが表示されます。PowerPoint found a problem with content in….[修復]を選択して、ファイルを開きます。

2021.1

バージョン

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

2021.1

重要

管理上の変更: Server共有データベース接続では、接続を使用してワークフローを実行またはスケジュールしようとするユーザーと共有することが必要になりました。以前は、共有データベース接続を使用するワークフローはコレクションと共有して、そのコレクション内のすべてのユーザーが実行できました。

影響: 以前まで動作していたワークフローとスケジュールで、エイリアスを翻訳できませんというエラーが表示される可能性があります。2022.1パッチ5と2022.3パッチ2では、この機能を復元するオプションが提供されています。

タスク: アップグレード後にエラーが発生したワークフローは、そのワークフローが使用する共有Serverデータベース接続を特定して、そのワークフローの実行またはスケジュールを試みているユーザーと共有します。

2021.1

新しい機能

  • スケジュール予測

  • ユーザー管理のMongoで、TLS/SSL、レプリカセット、シャーディング、Mongo Atlasの接続文字列をサポート。[Alteryxシステム設定] > [コントローラー] > [永続性]を参照してください。

2021.1

システム変更: 構成ファイルの場所が変更されました。

影響:

  • 構成ファイル:

    • 変更前: C:\Program Files\Alteryx\bin\config

    • 変更後: C:\Program Files\Alteryx\bin\server\config

  • ウェブルート:

    • 変更前: C:\Program Files\Alteryx\bin\RuntimeData\gallery

    • 変更後: C:\Program Files\Alteryx\bin\RuntimeData\server

2021.1

セキュリティ強化: OAuthパラメーターがクエリパラメーターではなくヘッダーとして送信されるように強化されました。

2021.1

不具合TGAL-2872: 管理者は共有ワークフローで他のユーザーが実行しているジョブを見ることができるが、その結果にアクセスしようとするとアクセス拒否エラーが表示される(2021.4で修正済み)。

影響: ユーザーAがコレクションを介してまたは同じスタジオにいることで、管理者とワークフローを共有している場合、管理者はユーザーAが手動またはスケジュールで実行したジョブを確認できます。管理者がそのジョブを選択して結果を表示すると、Error Getting Job Results Access deniedというメッセージを受け取ります。不具合は、ユーザーAにより実行されたジョブが、管理者が表示するジョブのリストに表示されないことです。

2021.2

バージョン

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

2021.2

ピットストップ

2022.3以降の暗号化移行と互換性がある最初のバージョン

影響: バージョン2021.2から2022.1は、2022.3以降へのアップグレード時に実行されるMongoDBの暗号化移行と互換性があります。

タスク: 以前のバージョンから2022.3以降にアップグレードする場合は、2021.2~2022.1にアップグレードし、テストしてから2022.3にアップグレードすることが必要です。

2021.2

MongoDBの変更: メールアドレスが重複していると、このバージョンとそれ以降のバージョンでアップグレードに失敗します。

影響: このバージョン以降のバージョンにアップグレードする前に、アップグレード前チェックワークフローを使用して重複したメールアドレスを特定します。

2021.2

新しい機能

2021.2

削除された機能: ワークフローを共有するオプションがワークフローページから削除されました。

影響:このページから、ソーシャルメディアやメールでワークフローを共有するオプションが削除されました。

2021.2

不具合TCPE-120: Designerセレクトツールの不具合。フィールド「XXX」が、既存のフィールド名と競合する名前に変更された(2022.1で修正済み)

影響: ツールが設定された後に入力データフィールド名の大文字と小文字が変更された場合、セレクトツールにエラーメッセージが表示されます。

2021.2

アップグレードの変更: MongoDBスキーマの移行に失敗した場合、サービスは開始しません。

影響: これにより、サービスの開始前に、スキーマの移行を妨げる問題に対処できるようになります。アップグレード前チェックワークフローは、スキーマの移行が正常に行われるようにする最良の方法です。

2021.2

不具合TCPE-531: .hyperファイルが文字列をV_WString(可変長ワイド文字列)にしてAlteryxに読み込む

影響: .hyperファイルは文字列をV_WString(1,073,741,823サイズ)でAlteryxに読み込みますが、以前のバージョンではV_WString(255サイズ)で読み込んでいました。

タスク:.hyperデータを読み込んだ後、オートフィールドまたはセレクトツールを使用して列タイプをリセットします。

2021.3

バージョン

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

2021.3

パフォーマンスの向上 - スケジュール予測のパフォーマンスが大幅に向上

2021.3

不具合: alteryxservice setserversecretを実行すると、以下のエラーが発生するサーバーシークレットの設定に失敗しました: CryptImportKey(3)のエラー: 不良なデータ(-2xxx)

影響: 不具合は発生しませんでした。これを修正するには、[ランタイム設定]を編集し、サーバーシークレットセクションの内容を削除して保存します。

2021.3

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

影響: 32ビットデータベース接続のサポート終了に関するFAQを参照してください。32ビットのサポートが終了する最終バージョンは2023.1です。

タスク: ユーザーは64ビット接続に移行する必要があります。21.3と32ビット接続を参照してください。

2021.3.4

不具合TGAL-6268: APIエンドポイントのGET /admin/v1/workflows/workflows/jobs/が、予想されるデータを返さない(2021.3.6、2021.4.2パッチ2で修正済み)

影響:

  • Get admin/v1/jobs - すべてのジョブを返すために使用する空白検索で、空の配列が返されるようになりました。

  • Get admin/v1/workflows - すべてのワークフローを返すために使用する空白検索で、空の配列が返されるようになりました。

  • admin/v1/workflows APIエンドポイントを使用して、Server間でワークフローを移行するプロセスが影響を受けます。

タスク: 必要な変更について、また、この不具合に基づいて更新されたワークフロー移行の実行例は、ワークフローの移行を参照してください。

2021.3.6

MongoDB 4.2

MongoDBのアップグレード: 埋め込みMongoDBのバージョン4.0から4.2へのアップグレード

影響: 2021.3のメンテナンスリリースでMongoDBバージョンがアップグレードされます。詳細については、下の2021.4セクションを参照してください。

2021.3.6

不具合TGAL-6566: 2021.3.6へのアップグレード後に、以下のMongoエラーでサービスが起動しない:「インデックス名fd5e7f7ad987788251ca676578977ec1は別の名前ですでに存在します」汎用サーバーエラー。コード: <mongodb:85> (LastStartupError.txt) (2021.3.7で修正済み)

影響: これは2021.3.6へのアップグレードにのみ影響があります。

タスク: サポートに連絡し、CSEに内部記事Unable to upgrade Server with User managed database on version 4.2+ (バージョン4.2でユーザー管理型のデータベースが存在するServerをアップグレードできない)を参照するよう伝えます。TAMへのメモ: この記事の手順は簡単で、アップグレードの前に事前実行できます(Jennifer Powellを参照)。

2021.4

新機能/リリースノート

バージョン

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

2021.4

MongoDB 4.2

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

影響:最初のアップグレードが4.0.10でしたが、その後のパッチは4.2.15までアップグレードされました[CSE Internal (TGAL-6772)]。

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

注記

最初のServerインストールが2018.1より前で、MongoDBフォルダーに.WT拡張子のファイルが含まれていない場合は、Mongoデータベースをバックアップして復元した後、このアップグレードの前に復元されたデータフォルダーを使用するようにServerを設定する必要があります。 MongoDB Migrate from MMAPv1 to WiredTiger Storage (MongoDBをMMAPv1からWiredTigerストレージに移行する)を参照してください。[CSE Internal-TGAL-6590チーム](2021.3.7で修正済み)

2021.4

重要

内部変更: コントローラートークンの長さが拡張されました

影響: 短いコントローラートークンはアップグレード後も動作し続けますが、「AlteryxService.exe setserversecret」ステップを受け入れないため、短いトークンを使用してServerホスト復元を実行できません。ベストプラクティスは、将来的にServerホスト復元を実行できるように、コントローラートークンを事前に新しく拡張した長さにリセットすることです。

タスク:

非常に重要

  1. Serverをアップグレードして、予想どおりに動作するかどうかをテストします。

  2. すべてのノードでAlteryxServiceを停止します(順序: ワーカー...Server UI...コントローラー)。

  3. コントローラーノードで[Alteryxシステム設定]を実行します。

  4. 既存のコントローラートークンRuntimeSettings.xmlバックアップを作成します。このコントローラートークンは、必要に応じて2021.3以前にロールバックする場合や、最近の2021.4バックアップを復元する場合に必要です。

  5. [コントローラー] > [一般] > [コントローラートークン] > [再生成]を選択します。

  6. [終了]に到達するまで[次へ]を選択して、コントローラーサービスを再起動します。

  7. すべてのノードを新しいコントローラートークンで更新します(順序: Server UI...ワーカー)

2021.4

新しい機能: データ接続マネージャー(DCM)

影響: ユーザーは資格情報のパスワード、データソース、コネクタをDCMに保存できます。これらはユーザーがローカルまたはServerのワークフローで使用し、Server上で共有できるため、他のユーザーまたはグループがServerでそのユーザーのワークフローを実行できます。これにより、資格情報の制御がServer管理者からワークフローを公開するユーザーに移ります。

2021.4

新しい機能: API V3に多数の新しい管理エンドポイント、OAuth2、新しいAPIエンドポイントを追加

影響:

タスク: Serverがlocalhost以外のベースアドレスを使用している場合は、そのドメインを[Alteryxシステム設定] > [Gallery] > [一般]のWeb APIアドレスにコピーします。http://mydomain/gallery/APIエンドポイントはOAuth1のままですが、2022.1で廃止されます。新しいOAuth2 Web APIの詳細については、以下の2022.1を参照してください。

API-21_4_change.png

ロードバランサーを使用している場合は、OAuth2使用するためにスティッキーセッションを実装する必要があります。そうしないと、ロードバランサーがBearerトークンを生成したマシンとは異なるマシンにAPI呼び出しを送信したときに、401-Unauthorizedエラーが断続的に発生します。[CSES-JIRA TGAL-6353、TCPE-402、Aha SERV-605]

2021.4

Server UIの変更: プライベートスタジオページとホームページがマージされました

影響:

2021.4

Server UIの変更: ユーザーがプライベートスタジオ間を移動した場合、作成したすべてのワークフローが表示されます

影響: このバージョンより前のバージョンでは、ユーザーがプライベートスタジオ(サブスクリプション)間を移動した場合、現在のプライベートスタジオのワークフローだけが表示されていました。[マイワークスペース]にワークフローが表示されるこの変更により、ユーザーはこれまでに作成したすべてのワークフローを表示できるようになりました。ただし、表示されている間は、現在のサブスクリプション([管理者] > [サブスクリプション]ページで割り当てられたもの)以外のワークフローを削除したり開いたりできません。

これは、Server製品からプライベートスタジオを削除して、コレクションでワークフローを共有するという将来に向けた、ステップです。将来のリリースでは、ユーザーは自分が作成したプライベートスタジオかどうかに関係なく、すべてのワークフローを開いたり削除したりできるようになります。

タスク: アクションは不要です。

2021.4

管理上の変更: プライベートスタジオ(現在は[マイワークスペース])から[共有ジョブ]タブが削除されました

影響: 同じプライベートスタジオのユーザーが、スタジオ設定の[共有スケジュール]を有効にして、スケジュールされたワークフロージョブの結果を共有した場合、これらのスケジュールのジョブ結果を示す[共有ジョブ]タブがプライベートスタジオに表示されなくなります。

タスク: 共有スケジュールへのアクセス権を提供するには:

  • オプション1: アクセス権を失ったユーザーについて、そのユーザーの[ジョブのスケジュール設定]許可を有効にします。[スケジュール]ページにスケジュールジョブの結果が表示されるようになりましたが、これによりジョブをスケジュール設定する機能も提供されます。

  • オプション2: すべてのユーザーがメンバーになっているコレクション内のスケジュールをスケジュール所有者が共有します。Serverデザインがプライベートスタジオからコレクションに移行するため、このオプションが推奨されます。

2021.4

改善: テレメトリが、ワークフローレベルで使用状況を追跡するよう強化されました

影響:

  • 顧客管理テレメトリ

2021.4

不具合TGAL-6408: プライベートスタジオに割り当てられた既定のワーカータグが保存されない(2022.3で修正済み)

影響: プライベートスタジオに割り当てられたワーカーの設定が保存されません。

タスク: ワークフローの公開時にジョブタグを設定します(ユーザーは[ジョブの割り当て]を[True]に設定する必要があります)。

2021.4

不具合TGAL-6502/TCPE-292: ユーザー管理のMongoDB Atlasの場合、250以上のユーザー/サブスクリプションでスキーマ移行が失敗する(2021.4.2パッチ2で修正済み)

影響: 上記のバージョンで修正されました。

2021.4

不具合TCPE-473: コレクション名にアンパサンドのスペースではなく%20または%26が表示される(2023.1で修正済み)

影響: 過去のバージョンでは、コレクション名はURLEncodedで保存され、スペースは%20に置き換えられていました(他の文字の置換も行われていました)。2021.4以降では、コレクション名がデータベースに表示されているとおりに表示されます。

タスク: AlteryxGallery.collectionsコレクションで%20の名前を確認し、これが問題になるかどうかを判断してください。問題となる場合は、Server UIでコレクションを編集して修正できます。編集が容易でない場合は、カスタマーサポートに連絡してサポートを受けてください。

2021.4

Excel XLSXファイル処理の変更: Excel XLSXファイルが、Excelで開くと読み取ることができなくなった[TDCB-3592]

影響: この変更は、データの整合性を確保するために行われました。

2021.4.2

不具合TDES-4123: ユーザーによる特定の単一Server UI URLへのDesignerアクセスをロックダウンする機能の使用に関連(2021.4.2パッチ2で修正済み)

影響: (1)既定のServer UI URLを指定する機能と、(2)ユーザーが選択したServer UIに接続できないようにする機能がローカルのDesignerインストールで使用されている場合、そのユーザーは[ファイル] > [ワークフローを開く]メニューから既定のServer UIを失い、Server UIからワークフローを開くことができなくなります。

影響を受ける機能:ServerへのDesignerアクセスの制御

問題の原因となる特定の設定:

<Designer>
<ManageGalleriesEnabled>False</ManageGalleriesEnabled>
<DefaultGalleryUrl>http://my-server.com/gallery</DefaultGalleryUrl>
</Designer>

タスク: XMLファイルの<ManageGalleriesEnabled>設定を[True]に変更して、ユーザーにDesignerでServer UIを手動で追加させます。注: そのユーザーは、以前はできなかった他のServer UIのノードを自由に追加できるようになります。

2021.4.2

不具合TGAL-6443: POST /v3/workflows/ID/versionsがDesignerからアップロードされたワークフローのUIに表示されない(2022.3で修正済み)

影響: ワークフローがDesignerから最初に発行された場合、その後POST /v3/workflows//versions{workflowId}エンドポイントを使用してワークフローを更新できません。APIで最初にアップロードされたワークフローは、予期したとおりに更新されます。

2021.4.2

セキュリティに関する注意: AMP Engine (2021.4.2パッチ1で修正済み)

影響: Alteryxは、AMP処理に脆弱性があるという報告を受けました。現在可能性のある影響を調査しています。(TELC-2814)

タスク: DesignerServerでAMPを無効にすることを推奨します。

2021.4.2.47792パッチ5

不具合TGAL-6990:Galleryデータ接続に空白のパスワードが含まれているとアップグレードに失敗する(21.4.2パッチ6、22.1.1パッチ4で修正済み)

影響: Galleryデータ接続に空白のパスワードが含まれていると、アップグレードが失敗します。コミュニティ[TGAL-6990]を参照してください。

タスク:

  • オプション: このパッチをスキップします。

  • オプション:コミュニティを参照してください。AlteryxGalleryデータベースのRobo3Tで、問題のあるレコードを検索します。

    db.getCollection('dataConnections').find({"PasswordSecured" : ""})

    空白のパスワードがあるすべてのレコードについて、AlteryxGallery.dataConnections.PasswordSecuredフィールドを編集し、別のレコードのパスワードをコピーします。注: Serverのアップグレードが完了したら、Server UIでGalleryデータ接続を更新します。

2021.4.2.47792パッチ5

不具合TGAL-7256: Serverホストの復元後にDCM接続が機能しない(オープン)

影響: Mongoデータベースを新しいマシンに復元すると(Serverホスト復元)、DCM接続が機能しません(エラーはDCMを使用するツールごとに異なります)。

タスク: 回避策 - 最適なオプション:

  • 最適なオプション: ユーザー自身でServer UIのDCM資格情報を編集し、パスワードを再入力します。

  • 代替方法: AlteryxServiceの3つのコレクション(dCMEConnections、dCMECredentials、dCMEDataSources)からレコードを削除し、ユーザー自身で新しいServerにDCM接続をDesignerから同期します。このプロセスでは、DCMエントリは古いバージョンにDesignerから置き換えられるため、Server UIでは更新されないと考えられます。

2022.1

新機能/リリースノート

バージョン

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

2022.1

重要

Server要件の変更: 推奨される論理コアとメモリ要件が変更されました

影響: 2022.1でAMPが既定で有効になり、メモリと論理コアの要件がこれに対応するように変更されました。さらに、AMPは同時ワークフローを実行できるようになりました(8つの論理コアにつき1つ)。「物理コア」から「論理コア」への変更については、以下のテーブルを確認してください。

Recommended_syssettings.png

タスク: AMPが無効になっていない限り、ワーカーノードが新しいガイドラインを満たしているかを確認します。AMP Engineのベストプラクティスも参照してください。

ServerでAMPを無効にするには、AMP Engineのベストプラクティスのエンジンの現在のシステム設定を維持したい場合はどうすればよいですか?を参照してください。

AMPを使用する場合のベストプラクティス: Serverでワークフローとメモリを同時に管理できるようにするには、以下を有効にします。

  • [Alteryxシステム設定] > [ワーカー] > [一般] > [Serverによるワークフローの同時実行の管理を許可する]

  • [Alteryxシステム設定] > [Engine] > [ServerによるEngineリソースの管理を許可する]

2022.1

重要

設定の変更: AMP Engineと[Serverによるワークフローの同時実行の管理を許可する]が既定で有効[TCPE-309]

影響: これにより、既存の[同時に実行できるワークフロー]の設定が、上記の新しいAMP推奨に基づいてリセットされます。AMPを無効にする場合は、パフォーマンスに影響を与えないように、同時ワークフロー設定を復元する必要があります(非AMP同時ワークフローの計算はphysical_cores/2)。

タスク: 詳細については、リリースノートの「AMP Engineの既定での有効化」セクションを参照してください。

AMPを無効にするには、[Alteryxシステム設定] > [Engine] > [一般] > [Engine] > [オリジナルのEngineのみ]を選択します。

2022.1

重要

APIの変更: OAuth1 APIを廃止

影響: APIはOAuth2のみを使用するようになりました。Server UIページの右上にあるクエスチョンマークをクリックすると、APIドキュメントにアクセスできます。OAuth2について紹介している「2021.4」のセクションで、重要なリンクと指示を確認してください。

API_change_221_1.png
API_change_221_2.png

スクリプト内のOAuth1認証は、OAuth2に更新する必要があります。ダウンタイムなしでスクリプトを移行できるよう、両方の認証タイプを利用可能な2021.4に、まずはアップグレードすることを考慮してください。

2022.1パッチ5

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

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

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

2022.1

ビルトイン認証のピットストップ

ビルトイン認証の変更: ビルトイン認証パスワードの暗号化が変更されました[TGAL-6431]

影響: ビルトイン認証パスワードの暗号化が変更されました。ビルトイン認証を使用している場合、新しいバージョンにアップグレードする前にこのバージョンにアップグレードして、以下の手順に従う必要があります。

ログイン試行をカスタマイズできるオプションが追加されています。

タスク:

Server UIにアクセスしてプロンプトが表示されたらパスワードをリセットするように、ユーザーに伝えます(同じパスワードを再入力できます)。

DesignerをServerに接続する必要がある場合は、Designer 2022.1にユーザーをアップグレードします。

ユーザーが上記の手順を実行しないと、「メールアドレスまたはパスワードが正しくありません。もう一度お試しください。」というメッセージが、Serverへの接続時にDesignerに表示されます。

このタスクを行わずに新しいバージョンに移行した場合、各ユーザーはパスワードリセットオプションを使用する必要があります。

2022.1

重要

Rのアップグレード: 組み込みRの4.0.5から4.1.3へのアップグレード

タスク: 外部Rライブラリを再インストールし、ワークフローでRを再テストするようユーザーに指示します。詳細については、Rバージョン4.2.3互換パッケージでRツールを使用する方法を参照してください。

2022.1

VDIへのDesignerのデプロイ: Designerデプロイのための仮想デスクトップインフラストラクチャ(VDI)サポートの追加

影響: Designerを永続的にも非永続的にもVDIにデプロイできます。仮想デスクトップインフラストラクチャサポートを参照してください。

2022.1

ダウンロードツールSSLセキュリティの強化: SSLの脆弱性に対応[JIRA PSEC-8]

影響: ハンドシェイク再ネゴシエーションに関するSSLの脆弱性(CVE-2009-3555)に対処しました。しかし、これは一部の顧客のダウンロードツールが「データを転送中のエラー: SSL接続エラー」で動作しなくなる原因となっています。

タスク: アクセスしているサイトに連絡し、RFC 5746をサポートするようにServerをアップグレードするよう依頼します。これが可能でない場合は、カスタマーサポートに連絡して、JiraカードPSEC-8を伝え、追加のサポートを受けてください。2022.3で、ピア検証許可リスト設定オプションを提供しています。

2022.1.42590パッチ3

不具合TGAL-6990: 空白のパスワードが含まれるGalleryデータ接続で、アップグレードが失敗する(21.4.2パッチ6、22.1.1パッチ4で修正済み)

影響: 空白のパスワードが含まれるGalleryデータ接続が存在すると、アップグレードに失敗する。コミュニティの記事と「TGAL-6990」を参照してください。

タスク:

  • オプション1: このパッチをスキップします。

  • オプション2:コミュニティの記事を参照します。AlteryxGalleryデータベースのRobo3Tで、問題のあるレコードを検索します。

    db.getCollection('dataConnections').find({"PasswordSecured" : ""})

    空白のパスワードがあるすべてのレコードについて、AlteryxGallery.dataConnections.PasswordSecuredフィールドを編集し、別のレコードのパスワードをコピーします。: Serverのアップグレードが完了したら、Server UIでGalleryデータ接続を更新します。

2022.2-FIPS

新機能/リリースノート

バージョン

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

2022.2-FIPS

これは、FIPS環境で作業する新規顧客向けに設計されたFIPS専用リリースです。FIPSはFederal Information Processing Standards (連邦情報処理標準)の略です。

一般リリースのServer製品とDesigner製品は四半期ごとのリリースがスキップされるため、次のバージョンは2022.3になります。Alteryxでは、2022.3四半期バージョンをリリースするまで、前バージョンのメンテナンスアップデート版のリリースを継続します。以前のバージョンからアップグレードする場合は、このバージョンをスキップして、2022.3以降にアップグレードします。

2022.3

What's New / Release Notes / Server Community Blog / Overview Community Blog

Version

Actions to take when upgrading to—or past—this version.

2022.3

CRITICAL

Upgrade Requirement for 2022.1 Defect TCPE-1100: If Upgrading from 2022.1 to this or later version, a patch is required.

Impact: If currently on 22.1, you must be on 22.1.1.9.42691_Patch_9 or higher before upgrading to or through 22.3 to avoid the defect TCPE-1100.  This defect affects the workflow revision numbers, setting them all to "1".

Task: Apply the latest 22.1 patch before proceeding with the upgrade if you are not already on Patch_9 or later.

2022.3

CRITICAL

MongoDB Re-encryption: Database collections must be re-encrypted with AES256 and SHA256 hashing standard prior to upgrade

Impact: The Crypto Migration Prep Tool should be run prior to upgrade to 2022.3+ to re-encrypt workflows in the background while the Server continues to function. After running the Prep Tool, the first time the Service starts after upgrading a few more collections, as well as the RuntimeSettings.xml, will also be CryptoMigrated.

Task:

Your Server should be on 2021.2 or later before starting this process. If you are on a prior version, upgrade to a version between 2021.2 and 2022.1 prior to attempting to upgrade to 2022.3+.

Run the Crypto Migration Prep Tool prior to upgrading Server and review the Migrator log for error lines containing ;3;. Don't upgrade Server until Migrator issues are resolved. Review log again if Server Upgrade fails as additional collections being migrated could error.

Following upgrade, you can delete the old, unencrypted collections. Contact Support for information on cleaning up the temporary files created and reducing the size of the Mongo database (CSEs see here).

If you need to rollback the upgrade, you will need to restore the backup of the RuntimeSettings.xml made during upgrade, C:\ProgramData\Alteryx\.

2022.3

CRITICAL

Designer Version Requirement: Designer 2022.3 required

Impact: The encryption methods used by 2022.3 Server require Designer 2022.3.

Task: Users must upgrade Designer to save workflows to the Server.

2022.3

CRITICAL

Configuration Change: SAML ACS endpoint must be all lowercase

Impact: The ACS endpoint is now lowercase (/saml2/acs) but was mixed-case (/Saml2/Acs).  This prevents Service start.  [TCPE-940 is asking that both old and new casing be accepted without error].

Task: Change the ACS endpoint in the IDP to all lowercase.

2022.3 Patch 2

Administrative Change: Option to allow users to run workflows using Shared Server Database Connections

Impact: Allow Access to Workflows Without Shared Credentials option added to allow a workflow using a Shared Server Database Connection to be run by anyone the workflow has been shared via a Collection. The other users do not require the Gallery Connection to be explicitly shared with them.

Task: Go to Server UI > Admin > Settings > Assets. Then select the Allow Access to Workflows Without Shared Credentials checkbox.

2022.3

Administration Change: Load Balancer

Impact: Alteryx System Settings > Server UI > Canonical Address options have been added to ensure email messages from the Server will use the URL your users use to access the Server UI.

Task: If you use a Load Balancer, set these values to the URL your users typically use to access the Server UI or API.

2022.3

Server Usage Report has been deprecated

Impact: The Server Usage Report is no longer supported by Alteryx. Previous versions might continue to function.

2022.3

Password Management: HashiCorp and CyberArk password vault support added

2022.3

Download Tool access to less secure handshake renegotiation: Settings file allows site-specific control

Impact: Use the Peer Validation Allow List if receiving "SSL connect error" from Download Tool. Download Tool updated to OpenSSL 3.0.7.

2022.3

Internal Change: Controller Token length

Impact: Server 2021.4 introduced a longer, more secure Controller Token, however, upgrades from 2021.3 retained their shorter Token. If the Token was not Regenerated to the longer length at some point it will be automatically regenerated in the 2022.3 upgrade. This will occur on all nodes in the same manner so they will create the same longer token and be able to communicate with the Controller following upgrade.

Task: Use the new Controller Token to add new nodes to your Server architecture in the future.

2022.3

Defect TGAL-7199: All versions of workflow labeled "1" (corrected 2022.3.1_Patch2)

Impact: When viewing the list of versions of a workflow, all versions display "1" instead of a sequential version number. This is a UI issue and the correct version is being used to run Jobs.