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)

タスク: DesignerとServerで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

新機能/リリースノート/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 - Server」を参照してください。

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

What's New / Release Notes

Version

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

2024.1

Administrative Feature: Ability to Transfer Asset Ownership via UI and API

Admins can transfer ownership of workflows and schedules between users via Server UI or using Server API V3 endpoints.

Impact:

注記

  • Workflow job history is not visible to the new owner.

  • Workflow will move to the new owner's studio, impacting visibility to other users in source or destination studio.

  • Additional elements need to be shared with new owner to run workflow successfully:

    • DCM Connection

    • Shared Gallery Database Connection

    • Shared Gallery Credential

2024.1

New Feature: New Database Option Added (SQL DB)

User-Managed SQL Server database can be used instead of MongoDB. Currently, the only officially supported version of SQL is MSSQL Server 2019 and 2022.

Impact:

2024.1

CRITICAL

Python Upgrade: Embedded Python upgrades from 3.8.16 to 3.10.13

Impact:

The following error message appears if an incompatible version of a Connector is used in Designer: " Version 3.8 was not found in our alteryx distribution. Please select another version. Internal Error - Deadlock detected."

Task:

  • All Connector Tools must be replaced with a new version.

  • Users should retest Python in workflows. Engine still uses Python Version 3, so there should be little impact on scripts.

2024.1

CRITICAL

MongoDB Datetime Field Change (Service Timestamps Moved to UTC Format in Server Databases)

Impact: We moved all datetime fields to UTC to improve handling of time zone and daylight savings time changes. For more information, go to Server 2024.1 Release Notes.

  • All Server APIs with a timestamp element are affected.

  • If you upgrade from an older version to 2024.1, the timestamps of existing assets will be converted to the new UTC standard when AlteryxService starts.

Task: Review how datetime fields are handled in applications that access MongoDB or the API. They might need to be adjusted to expect the datetime in UTC.

2024.1

DCM Dev/Prod Server Management: Prod Server can redirect Dev DCM to Prod Connections

Impact: DCM Connections and DCM Connection Handling added to Admin menu. For more information, visit the following help pages:

Task: Add DCM redirections to Prod Server to allow workflows migrated from Dev to access Prod data sources with no changes in the workflow.

2024.1

DCM Administration: User Permission Granularity

Impact: New DCM permissions added. For more information, go to the User Roles and Permissions help page.

2024.1

DCM Administration: DCM Generic External Vault added

Impact: You can configure a generic vault that can retrieve secrets from any vault with a programmatic interface using basic authentication.

2024.1

Administration Change: DCM Concurrent Sharing

Impact: You can share the same DCM Connection for Collaboration and, separately, for Execution. Previously you could only choose 1 sharing option. For more information, go to Data Connection Manager: Server UI.

2024.1

Insights End of Life

Impact: Insights no longer available in Alteryx Server. Go to our FAQ page for more information.