Rescale でジョブを実行する、またはワークステーションを起動すると、プラットフォームはそのコンピューティングセッションにシステムレベルのユーザーネームを割り当てます。デフォルトでは、これは各ジョブに紐づく一意の自動生成された識別子です。カスタムユーザーネームは、これを、ジョブ、ワークステーション、ストレージデバイスを含む、起動するすべてのコンピューティングリソースにわたって適用される、一貫性があり人が判別しやすいユーザーネームに置き換えます。
オーガニゼーションがカスタムユーザーネームを有効にする主な理由は、ライセンスのチェックアウト追跡を意味のあるものにするためです。つまり、ライセンスログに、不透明なジョブ ID ではなく、チェックアウトの責任を持つ実際のユーザーが記録されるようにするためです。
カスタムユーザーネームポリシーの仕組み
カスタムユーザーネームポリシーは、次の 2 つのレベルで設定できます。
ポリシーレベル | 適用範囲 | サポートされるモード | フォールバック |
オーガニゼーションレベル | すべてのワークスペースにわたるユーザー ID に適用 | メールアドレスから、SSO IdP 応答から、カスタム | カスタムモードを使用する場合、フォールバックなし |
ワークスペースレベル | 特定のワークスペース内の特定のユーザーに適用 | カスタムのみ | オーガニゼーションレベルポリシーにフォールバック可能 |
オーガニゼーションレベル
メールアドレスから — ユーザーネームは、メールアドレスのローカル部から生成されます。たとえば、mailto:[email protected] は johndoe になります。ハイフンおよび英数字はそのまま保持され、それ以外のすべての文字（ピリオドなど）はアンダースコアに変換されます。そのため、user.lastname は user_lastname になります。
SSO IdP 応答から — ユーザーネームは、オーガニゼーションのシングルサインオン（SSO）ID プロバイダーから返される属性から取得されます。既存のユーザーは、新しいユーザーネームを有効にするために、SSO からログアウトして再度ログインする必要がある場合があります。すべてのユーザーは一意のユーザーネームを持つ必要があります。重複があると失敗します。
カスタム — ユーザーネームは、各ユーザーに対して手動で指定されます。このモードを選択した場合、オーガニゼーション内のすべてのユーザーにユーザーネームを指定する必要があります。ユーザーネームがない場合のデフォルト値やフォールバックはありません。
ワークスペースレベルのポリシー
ワークスペースレベルのポリシーは、カスタムモードのみをサポートします。これは、オーガニゼーションレベルのポリシーに加えてユーザー単位の例外を設定する場合に便利です（たとえば、ほとんどのユーザーではメールアドレスからユーザーネームを生成し、一部のユーザーについては別のユーザーネームを手動で指定する場合など）。両方のレベルが存在する場合、そのユーザーについてはワークスペースレベルのエントリが優先されます。
ユーザーネームの検証ルール
無効なユーザーネームは、コンピューティングクラスターがブートストラップフェーズで失敗する原因になります。ルールはオペレーティングシステムによって異なります。
Linux
文字（A–Z、a–z）またはアンダースコア（_）で始まる必要があります。
すべての文字は、文字、数字（0–9）、ハイフン（-）、またはアンダースコア（_）である必要があります。任意のドル記号（$）は、最後の文字としてのみ使用できます。
長さは 32 文字を超えることはできません。
Windows
長さは 20 文字を超えることはできません。
予約語（例：NONE）は使用できません。
注：オペレーティングシステムに応じて異なるカスタムユーザーネームを使用することはサポートされていません。同じユーザーネームが、クラスターが Linux で実行されるか Windows で実行されるかにかかわらず適用されます。
表示される可能性のあるログメッセージとエラー
エラー 1：ジョブがキューで停止する — カスタムユーザーネームがない
症状：ジョブが開始されず、無期限にキューに残ります。
ログメッセージ（ジョブログに表示）：
A custom username was expected for your account but none exists, will block launch until one is found. Please contact your site admin for assistance.
原因：オーガニゼーションでカスタムユーザーネームポリシーが設定されていますが、アカウントにユーザーネームが定義されていません。SSO ID プロバイダーがユーザーネームフィールドの値を返さない場合にも、この問題が発生することがあります。
重要：これは致命的なエラーではありません。ユーザーネームが追加されると、ジョブは自動的にキューから進行します。キャンセルして再送信する必要はありません。
エラー 2：SSO ログイン失敗 — ユーザーネームがすでに存在する
症状：SSO 経由でログインできず、エラーページが表示されます。
ユーザーに表示されるエラー：
Username xxxxxxx already defined in this organization
SSO ログメッセージ：
ACS warning Username 'jdoe' already exists for workspace
ACS info Cannot create a new User
ACS info User not authenticated
ACS info Returning error 'You cannot log into your account at this time.
Your Organization Administrator has been notified...'
代替ログ：
ACS error Failed to add new user email [email protected] workspace [workspace-id]
原因：プラットフォームが割り当てようとしているユーザーネーム（メールアドレスまたは SSO 属性から生成されたもの）がすでに使用されています。通常は、以前の登録で残ったアカウント、または削除済みユーザーが原因です。
警告：無効なユーザーネーム形式
症状：ジョブログに警告が表示されます。ジョブの開始が許可される場合がありますが、クラスターがブートストラップ中に失敗する可能性があり、ワークロード自体が正しく実行されない可能性もあります。
原因：設定されたカスタムユーザーネームが OS レベルの検証ルールに違反しています。たとえば、数字で始まる、サポートされていない文字を含む、文字数制限を超えている、などです。結果は予測できず、クラスターが正常に開始される保証はありません。
トラブルシューティング手順
ジョブがキューで停止する（ユーザーネームがない）
この問題を解決するには、オーガニゼーション管理者または Rescale Support による対応が必要です。エンドユーザー自身はカスタムユーザーネームを設定できません。
解決プロセス：
オーガニゼーション管理者に連絡するか、Rescale Support にお問い合わせください。
管理者または Rescale Support が、カスタムユーザーネームポリシー設定で、対象アカウントに不足しているユーザーネームを追加します。
ユーザーネームが追加されると、ジョブは自動的にキューから進行します。ユーザー側で追加の操作は必要ありません。
SSO ログイン失敗（ユーザーネームの重複）
この問題はアカウントレベルの設定に関係するため、調査と解決には Rescale Support による対応も必要です。
解決プロセス：
Rescale Support に連絡し、エラーメッセージに表示されているユーザーネームを提供してください。
Support が重複しているユーザーネームのエントリを特定し、それが非アクティブまたは削除済みのアカウントに関連付けられている場合は削除します。
解決後、Rescale プラットフォームで再度サインアップまたはログインするよう案内されます。
Support が重複しているエントリを削除する前に、ご自身で再登録を試みないでください。さらに問題が発生する可能性があります。
無効なユーザーネーム形式（ジョブがブートストラップで失敗する）
解決プロセス：
問題の原因となっているユーザーネームをジョブログで確認します。
オーガニゼーション管理者または Rescale Support に連絡し、ログに表示されているユーザーネームを共有します。
管理者が、OS 固有のルールに準拠するようにユーザーネームを更新します（Linux：32 文字以下、文字または _ で始まる必要あり。Windows：20 文字以下、予約語は使用不可）。
よくある質問
Linux クラスターと Windows クラスターで異なるユーザーネームを使用できますか？
いいえ。オペレーティングシステムに応じて異なるカスタムユーザーネームを使用することはサポートされていません。同じユーザーネームがすべてのクラスタータイプに適用されます。
特定のワークスペースで自分のユーザーネームを上書きできますか？
はい。ワークスペースレベルのカスタムユーザーネームポリシーは、個々のユーザーに対してオーガニゼーションレベルのポリシーを上書きできます。これは、ほとんどのユーザーはメールまたは SSO からユーザーネームを生成するが、特定のユーザーについては特定のワークスペースで別のユーザーネームが必要な場合に便利です。
ユーザーネームエラーでジョブがキューに停止しています。
キャンセルして再送信する必要がありますか？ いいえ。このエラーは致命的ではありません。オーガニゼーション管理者または Rescale Support が不足しているユーザーネームを追加すると、ユーザー側で何も操作しなくてもジョブは自動的に開始されます。
カスタムユーザーネームを設定または変更できるのは誰ですか？
カスタムユーザーネームを設定できるのは、Rescale のオーガニゼーション管理者または Rescale Support のみです。ユーザーネームがない、または正しくないと思われる場合は、オーガニゼーション管理者に連絡するか、https://rescale.com/support/ からサポートチケットを作成してください。