変更の影響とアップグレード

ccppmop1581
HID_HID_release_info_change_impact_od
この
変更の影響とアップグレード
のページでは、以前のリリースから
Clarity
15.8.1 にアップグレードするお客様を対象として、大幅な変更、必要なアクション、既知の問題、および推奨オプションについて説明します。
Clarity
のアップグレードを計画し、ビジネス ニーズに合うオプションを決定します。 チームもこの情報を活用して、新しい機能の採用、オンボーディング、およびトレーニングの取り組みを計画できます。
たとえば、
Clarity
リリース 15.3 から 15.8 にアップグレードするとします。 その場合は、アップグレードの前後に、リリース 15.4、15.4.1、15.5、15.5.1、15.6、15.6.1、15.7、および 15.7.1 の変更点を確認してください。 各リリースの「
変更の影響とアップグレード
」ページに切り替えるには、このページの上部にある[
バージョン
]メニューをクリックします。 特に、PDF ファイルをダウンロードした場合は、更新されたコンテンツを頻繁に確認してください。 このドキュメントの英語版は、新しい例、説明、修正、パッチ情報などの新情報に基づいて定期的に更新されます。
Clarity
リリース 15.8.1 へのアップグレードを準備するために、サポートされているアップグレード パス、機能、拡張機能、および必要なアップグレード アクションを確認してください。 以下の情報は、このリリースで導入された新しい変更点がアップグレード体験にどのように影響するかをまとめたものです。
Clarity
SaaS による Google Cloud Platform での Jaspersoft 7.1.3 のサポート
GCP 上の
Clarity
SaaS のお客様は、すぐに Jaspersoft 7.1.3 にアップグレードされます。 Jaspersoft Studio 7.1 と既存の Studio および SOW ソリューション アダプタを引き続き使用できます。 詳細については、「Install Jaspersoft Studio Professional 7.1 and CA JDBC Adapter」を参照してください。
Clarity
GCP SaaS のお客様のみ
PostgreSQL に移行されたドメインでは、ドメイン デザイナで表示または編集するときにエラーが表示されます。 この KB 記事を参照して、この問題を解決してください。
また、Jaspersoft Studio と Jaspersoft サーバ間の接続の失敗に関するこの KB 記事も確認してください。
Clarity
は、近日中にオンプレミス ユーザ向けの Jaspersoft 7.1.3 のサポートを発表します。
Clarity
15.7 以降、OracleJDK は AdoptOpenJDK に置き換えられます
Java イメージ
Clarity
では、
2019 年 8 月 19 日
以降、Oracle Java に関連する製品の更新を停止します。 これにより、弊社の開発チームは将来の製品リリースの価値を高める取り組みに専念できます。Broadcom 傘下の CA Technologies (CA)は、自社の製品を引き続きサポートし、CA Technologies とそのお客様との間のライセンス契約に定められた契約条件を遵守します。
既存のお客様は、本番環境および本番以外の環境で Oracle Java コンポーネントを含むリリースを引き続き実行し、使用することができます
。 ただし、今後発生する可能性のある Java のセキュリティおよび脆弱性の問題に対処するには、サービス パックのインストールや、AdoptOpenJDK をサポートする
Clarity
の新しいリリースへのアップグレードが必要になる場合があります。 この変更は、Java 8 を引き続きサポートする Jaspersoft には影響しません。
2
Clarity
PPM は
Clarity
Clarity
PPM は、
Clarity
というブランド名に変更されました。 ログイン画面および新規ユーザ エクスペリエンスで、
Clarity
の新しいロゴが表示されます。 新しいブランドを反映するために、ドキュメントが更新されました。
Clarity
は新規ユーザ エクスペリエンスを表し、
クラシック PPM
クラシック PPM
Studio を表します。
Clarity
アップグレード アクション
Clarity
15.8.1 にアップグレードすると、
Clarity
の新しいロゴが表示されます。
以下のビデオでは、このリリースで Clarity ロゴに追加された拡張機能について説明します。

このビデオは、ドキュメントを PDF 形式でダウンロードした場合には利用できません。 こちらをクリックして、YouTube でビデオをご覧ください。
カスタム マスタ オブジェクト、サブオブジェクト、およびカスタム仮想属性が
Clarity
で使用可能に
クラシック PPM
でカスタム マスタ オブジェクトおよびカスタム サブオブジェクトに対して API を有効にして、それらを
Clarity
で使用できるようになりました。 ここで、ユーザが
Clarity
を使用して製品ライフサイクルを管理するシナリオを考えてみましょう。 ユーザは、すべての製品の NPS (Net Promoter Score)をキャプチャして、そのデータを
Clarity
に保存することを望んでいます。 また、サポート プロセスおよびサービス プロセスに関する特定の質問をお客様にしたいと考えています。 ただし、このデータは NPS スコアとは別個に保存する必要があります。 ユーザは NPS というカスタム オブジェクト マスタ オブジェクトを
クラシック PPM
で作成し、そのオブジェクトで API を有効にすることで、それを
Clarity
で使用できるようにします。 その後、2 つのサブオブジェクト(Services および Support)を作成し、それらで API を有効にすることができます。 これにより、
Clarity
を使用して、NPS データおよび関連付けられているサービスおよびサポート調査の詳細を保存できるようになります。
Clarity でカスタム マスタ オブジェクトおよびカスタム サブオブジェクトで API を有効にする
XOG を使用して、
クラシック PPM
の標準およびカスタム仮想属性で API を有効にすることもできます。 カスタム仮想属性は、サブオブジェクトに対してのみ定義されます。 仮想属性は、マスタ オブジェクトの特定の属性にリンクされる、サブオブジェクトの読み取り専用属性です。
クラシック PPM
を使用して、標準およびカスタム仮想属性で API を有効にすることはできません。
アップグレード アクション
Clarity
15.8.1 にアップグレードすると、既存のカスタム マスタ オブジェクトおよびカスタム サブオブジェクトで API を有効にできるようになります。 その後、
Clarity
でそれらを操作できます。 XOG を使用して、標準およびカスタム仮想属性で API を有効にすることもできます。
以下のビデオでは、このリリースでカスタム オブジェクトおよびサブオブジェクトに追加された拡張機能について説明します。

このビデオは、ドキュメントを PDF 形式でダウンロードした場合には利用できません。 こちらをクリックして、YouTube でビデオをご覧ください。
会計管理の拡張機能
会計モジュールを使用して、プロジェクト、カスタム投資、およびアイデアで利益計画を作成できます。 その後、コスト計画を利益計画に関連付けて、投資の利益または投資に対する NPV (Net Present Value、正味現在価値)を見積もることができます。
Clarity の会計モジュールを使用して、投資オブジェクトで利益計画を作成する
利益計画には、無制限のコスト計画を関連付けることができますが、コスト計画には、1 つの利益計画しか関連付けることができません。 会計モジュールを使用して、新規の利益計画を作成したり、既存の計画を更新したりできます。 コスト計画と関連付けられている利益計画を削除することはできません。
保存されたビューは、さまざまな投資タイプの会計モジュール間で共有されることに注意してください。 たとえば、カスタム投資の[予算計画]グリッドにビューを保存すると、同じビューをアイデアおよびプロジェクトの[予算計画]グリッドで表示できます。
アップグレード アクション
Clarity
15.8.1 にアップグレードすると、
クラシック PPM
で使用可能だった既存の利益計画を
Clarity
内で関連付けることができます。 また、
Clarity
で新しい利益計画を直接作成することもできます。
以下のビデオでは、プロジェクト、カスタム投資、およびアイデアで会計モジュールに追加された拡張機能について説明します。


このビデオは、ドキュメントを PDF 形式でダウンロードした場合には利用できません。 こちらこちらをクリックして、YouTube でビデオをご覧ください。
共通検索コンポーネント
ボード、グリッド、およびタイムライン レイアウトに用意されている検索バーを使用して、名前または ID に基づいて値をフィルタできます。 投資内で特定のタスクを検索する例を考えてみます。 検索バーにその名前の最初の数文字を入力して、それを検索して編集することができます。
Clarity の共通検索コンポーネント
ビューを保存した場合、検索値は保持されません。 また、別の場所に移動してワークスペースに戻ると、検索バーがクリアされます。
Clarity
では、使用可能な従来のフィルタと共に検索バーを使用できます。 フィルタを使用して開始されていないすべてのタスクを識別してから、検索バーを使用して特定のタスクを検索する例を考えてみます。
Clarity
では、フィルタおよび検索バーの条件に一致する結果のみが表示されます。
検索バーは、ロードマップ、スタッフ モジュール、および割り当てモジュールでは使用できません。
詳細については、「共通コンポーネント」を参照してください。
アップグレード アクション
: 影響はありません。
Clarity
15.8.1 にアップグレードすると、ボード、グリッド、およびタイムライン レイアウトで新しい検索バーが表示されます。
カスタム ドロップダウンの拡張機能
Clarity
15.8.1 以降では、静的値のルックアップのドロップダウン リストに、リスト全体をスクロールする代わりに、属性をすばやく検索できる検索オプションが含まれています。 属性の名前が長すぎる場合、
Clarity
では名前を省略して表示します。 検索機能は、静的値のルックアップが適用されるすべての場所で使用できます。
検索可能なドロップダウン リスト
アップグレード アクション
: 影響はありません。
Clarity
15.8.1 にアップグレードすると、静的値のルックアップで新しい検索バーが表示されます。
Excel にエクスポートするときのハイパーリンク長の拡張(
クラシック PPM
クラシック PPM
の[Excel にエクスポート]機能が拡張され、最大 2085 文字のリンクがサポートされるようになりました。 以前のリリースでは、[Excel にエクスポート]機能を使用する場合、URL が 255 文字を超える場合は常に Microsoft Excel ファイルからハイパーリンクが削除されました。
Clarity
15.8.1 以降では、URL の長さの制限が 255 から 2085 文字に増加しました。
アップグレード アクション
: 影響はありません。
Clarity
15.8.1 にアップグレードし、[Excel にエクスポート]機能を使用すると、Microsoft Excel ファイルに関連リンクが表示されます。
以下のビデオでは、このリリースで UI に追加されたさまざまな拡張機能について説明します。

このビデオは、ドキュメントを PDF 形式でダウンロードした場合には利用できません。 こちらをクリックして、YouTube でビデオをご覧ください。
カスタム投資でのフィールド レベル セキュリティのサポート
フィールド レベル セキュリティがカスタム投資で使用できるようになりました。 ポートフォリオ マネージャの Sid が、所属組織でカスタム投資項目の作成、編集、および管理を担当している例を考えてみましょう。 Sid は、組織の戦略を定義するためにカスタム投資を作成します。 予想予算計画属性をセキュリティで保護し、関連する利害関係者に編集権限を付与します。 関係者は、関連する戦略の予想予算計画を確認および更新できるようになります。
フィールド レベル セキュリティ
戦略が確定されたら、Sid は戦略をチームと共有します。 チーム内のすべてのリソースには、予想予算計画属性に対する表示アクセス権があります。
詳細については、「フィールド レベルのアクセスの保護」を参照してください。
アップグレード アクション
Clarity
15.8.1 にアップグレードすると、フィールド レベル セキュリティを使用して、カスタム投資と関連付けられている属性をセキュリティで保護できます。
以下のビデオでは、このリリースでフィールド レベル セキュリティに追加されたさまざまな拡張機能について説明します。

このビデオは、ドキュメントを PDF 形式でダウンロードした場合には利用できません。 こちらをクリックして、YouTube でビデオをご覧ください。
ヘッダおよびログイン ロゴのカスタマイズ
Clarity
のヘッダ ロゴおよびログイン ロゴをカスタマイズして、組織のブランディングを反映できるようになりました。 また、開発、QA、本番など、さまざまな環境を区別するために使用することもできます。 詳細については、「Clarity: システム設定
ロゴを更新するための管理者権限を持っている必要があります
」を参照してください。
Clarity
アップグレード アクション
Clarity
15.8.1 にアップグレードすると、
Clarity
の[システム設定]セクションでロゴをカスタマイズして、組織のブランディングを反映させることができます。
以下のビデオでは、このリリースで UI に追加されたさまざまな拡張機能について説明します。

このビデオは、ドキュメントを PDF 形式でダウンロードした場合には利用できません。 こちらをクリックして、YouTube でビデオをご覧ください。
SAML 2.0 をサポートするための
Clarity
の設定(オンプレミスのみ)
Clarity
15.8.1 以降のリリースでは、オンプレミスのお客様は、SAML 2.0 をサポートしている IDP によって発行された認証情報を使用して
Clarity
にログインできます。 SAML ベースの SSO ログインを使用する主な利点は以下のとおりです。
  • ネットワークと環境の間のシームレスな統合: すべてのユーザは、所属組織のイントラネットと
    Clarity
    の間を容易に移動できます。
  • 簡素化されたパスワード管理: 既存のユーザ管理システムでパスワード管理が処理されるため、
    Clarity
    とは別個にユーザ パスワードを管理する必要がありません。
詳細については、「SAML 2.0 をサポートするための Clarity の設定」を参照してください。
複数選択グリッドを使用したスタッフの投資への追加
Clarity
の新しい[スタッフの追加]ボタンを使用すると、リソース、ロール、およびチームを投資に追加できます。 [スタッフの追加]ボタンをクリックした後、リソース、ロール、チームのいずれを追加するかを選択できます。 リソースを選択すると、
Clarity
によって、利用可能なすべてのリソースのリストが汎用の複数選択グリッドにロードされます。 検索およびフィルタのオプションを使用すると、関連するリソースを迅速に識別して投資に追加できます。
Clarity で複数選択グリッドを使用してスタッフを投資に追加する
詳細については、「Clarity: プロジェクト チームへのスタッフ割り当て」を参照してください。
アップグレード アクション
: 影響はありません。
Clarity
15.8.1 にアップグレードすると、新しい[スタッフの追加]ボタンを使用してリソース、ロール、およびチームを投資に追加できます。
以下のビデオでは、このリリースでスタッフ割り当てに追加されたさまざまな拡張機能について説明します。

このビデオは、ドキュメントを PDF 形式でダウンロードした場合には利用できません。 こちらをクリックして、YouTube でビデオをご覧ください。
日単位での工数の表示
Clarity
を設定して、工数を日単位で表示できるようになりました。 以前のバージョンの
Clarity
では、工数は FTE または時間単位のみで表示できました。 [一般設定]を使用して、工数が日単位で表示されるように設定できるようになりました。 これは、
Clarity
のプロジェクトおよびカスタム投資でスタッフ割り当てモジュールと割り当てモジュールを使用する際に非常に役立ちます。 この設定は、以下の領域に影響しません。
  • スタッフ割り当てワークスペース
  • タイムシート
  • 会計
  • ロードマップ
Clarity で作業工数を日単位で表示する
アップグレード アクション
: 影響はありません。
Clarity
15.8.1 にアップグレードすると、工数を日単位で表示するように
Clarity
を設定できます。
スタッフ割り当てワークスペースからの警告メッセージの削除(ミックス予約が有効)
Clarity
15.8.1 以降のリリースでは、スタッフ割り当てワークスペースに、ミックス予約が有効になっているためページが読み取り専用モードで使用可能であることを示す警告メッセージが表示されません。 ミックス予約を有効にしている場合、スタッフ割り当てワークスペースは引き続き読み取り専用モードになります。
Clarity
詳細については、「Clarity: スタッフ投資へのリソースとロールの要求」を参照してください。
アップグレード アクション
: 影響はありません。
Clarity
15.8.1 にアップグレードすると、スタッフ割り当てワークスペースにアクセスしたときに警告メッセージが表示されなくなります。 これは、
クラシック PPM
でミックス予約を有効にしている場合に適用されます。
スタッフ割り当てワークスペースでのカスタム投資のサポート
スタッフ割り当てワークスペースを使用して、カスタム投資のロールの割り当て、リソースの要求、およびスタッフ割り当てを計画できます。
Clarity
の以前のリリースでは、スタッフ配置ワークスペースはプロジェクトおよびアイデアに対してのみ使用できました。
Clarity のスタッフ割り当てワークスペースでのカスタム投資のサポート
詳細については、「Clarity: スタッフ投資へのリソースとロールの要求」を参照してください。
アップグレード アクション
Clarity
15.8.1 にアップグレードすると、スタッフ割り当てワークスペースを使用してカスタム投資にスタッフを割り当てることができます。 これは、
Clarity
の以前のリリースではサポートされていませんでした。
以下のビデオでは、このリリースでスタッフ割り当てに追加されたさまざまな拡張機能について説明します。

このビデオは、ドキュメントを PDF 形式でダウンロードした場合には利用できません。 こちらをクリックして、YouTube でビデオをご覧ください。
ロードマップのインポート機能の向上
Clarity
からインポート]オプションで、対応するグリッドが選択チェックボックスと共に表示されるようになりました。
Clarity
リリース 15.8 までは、インポート オプションを使用すると、特定の投資オブジェクトを検索できます。
Clarity
15.8.1 以降では、それぞれのグリッドからプロジェクト、アイデア、またはカスタムの投資アイテムを選択できます。 選択グリッドでは、個別の行項目を選択できます。 また、すべての行を選択または選択解除することもできます。
Clarity のスタッフ割り当てワークスペースでのカスタム投資のサポート
詳細については、「Clarity: ロードマップでのトップダウンの計画」を参照してください。
アップグレード アクション
: 影響はありません。
Clarity
に 15.8.1 にアップグレードすると、拡張インポート機能を使用して、投資をロードマップにインポートできます。
以下のビデオでは、このリリースでロードマップに追加されたさまざまな拡張機能について説明します。

このビデオは、ドキュメントを PDF 形式でダウンロードした場合には利用できません。 こちらをクリックして、YouTube でビデオをご覧ください。
Internet Explorer 11 で
Clarity
機能がサポートされない
クラシック PPM
では IE 11 のサポートは継続されますが、
Clarity
では古いブラウザ技術(IE 11 を含む)との下位互換性を拡張できません。
これは
Clarity
の既知の問題ではありません。 これは IE 11 の既知の問題です。 Microsoft は、新しいブラウザである Microsoft Edge に投資しました。
ユーザがサポートの要件を無視し、
Clarity
で IE 11 を使用しようとすると、以下の問題が発生する可能性があります。
  • 機能障害やメモリ リーク(Microsoft から修正が提供される予定はありません)
  • 新しい REST API 機能に対するブラウザ フレームワーク サポートの欠如
  • HTML 5 と新しい Angular コンポーネントによる表示の不具合とパフォーマンスの低下
  • 他のサイトへのリンクが動作を停止するか、ブラウザを更新する必要があることを示すメッセージを表示する
たとえば、IE 11 を使用している場合、ロードマップ タイムラインが機能しなくなったり、スタッフ配置ページにリソースがすべてロードされなくなったりする可能性があります。そのほかにも、問題が
不規則
に発生すると思っていたところ、サポートされていない古いブラウザ技術を使用して、豊富なドラッグ アンド ドロップ機能を備えた新しい Web アプリケーション インターフェースにアクセスしていることに気付くことがあります。 最新のユーザ エクスペリエンス ページを
Clarity
で最適に表示するには、Edge、Firefox、Chrome などの新しいブラウザに切り替えてください。
セキュリティ ライセンスおよび MD5 のパッケージが有効になるまで Oracle 上でアップグレードできない
  1. データベース管理者または Oracle に問い合わせて、DBMS_CRYPTO を使用している場合にのみ必要な高度なセキュリティ ライセンス(OAS)を取得します。
  2. dbms_obfuscation_toolkit.md5 (Oracle インストールに含まれています)に対する明示的な権限を有効化して付与します。
  3. アップグレードを開始します。
言語のサポート廃止による既知の問題
このリリースでは、以下の言語はサポートされなくなりました。
カタロニア語
チェコ語
デンマーク語
終了
ハンガリー語
オランダ語
ノルウェー語
ポーランド語
ロシア語
スウェーデン語
トルコ語
中国語(簡体字)
中国語(繁体字)
韓国語
その結果、翻訳されたテキストではなく raw テキスト ラベルまたは英語のテキストがユーザ インターフェースに表示される場合があります。
回避策
: お使いの
Clarity
アカウント設定を、「リリース ノート」に記載されているいずれかのサポート対象言語に切り替えます。
[合計]列が存在しない場合、CSV にエクスポートすると[期間ごとのメトリック]データが表示されない
プロジェクトの[スタッフ]および[割り当て]グリッドで、ETC、ETC コスト、実績値、および実コストに[合計]および[期間ごとのメトリック]列を使用します。
  • グリッド上に[合計]列と[期間ごとのメトリック]列が設定されている場合、CSV ファイルへのエクスポート機能は期待どおりに動作します。
  • グリッド上に[合計]列が設定されていない場合、エクスポートは期待どおりに動作しません([期間ごとのメトリック]列はすべて空白になります)。
回避策
: グリッドで[列パネル]をクリックし、[CSV にエクスポート]を使用する前に[合計]列をグリッド レイアウトに追加します。
Jaspersoft 7.1 の新規インストールに関する既知の問題
オンプレミス環境では、Jaspersoft 7.1.0 を Oracle 11g R2 または 12c 上で新規インストールするときに、インストール ログに以下の「
Failed to execute: create index
」エントリが記録される場合があります。
[exec] [exec] init-js-db-pro:
[exec] [exec] [echo] For JDBC driver the artifactId and version properties are set:
[exec] [exec] [echo] maven.jdbc.artifactId=ojdbc8
[exec] [exec] [echo] maven.jdbc.version=12.2.0.1.0
[exec] [exec] [echo] Specified JDBC driver jar exists
[exec] [exec] [advanced-sql] Executing resource: /fs0/clarity1/install_cd/ca_ppm_jaspersoft_7.1.0/buildomatic/install_resources/sql/oracle/js-pro-create.ddl
[exec] [exec] [advanced-sql] 0 rows affected
[exec] [exec] [advanced-sql]
Failed to execute: create index
idx46_jiresfldr_hidden_idx on JIResourceFolder(hidden)
[exec] [exec] [advanced-sql] java.sql.SQLException: ORA-01408: such column list already indexed
[exec] [exec] [advanced-sql] 0 rows affected
[exec] [exec] [advanced-sql] Executing resource: /fs0/clarity1/install_cd/ca_ppm_jaspersoft_7.1.0/buildomatic/install_resources/sql/oracle/quartz.ddl
このエントリは無視してもかまいません。 この警告は、重複インデックス作成シナリオについて警告するために表示されるものですが、有効な警告ではありません。
  • この警告はインストールに影響を与えず、Jaspersoft 7.1 の機能に影響しません。
  • CA エンジニアリング チームは、警告の報告後でもすべての DDL コマンドが正常に実行されることを確認済みです。
  • この警告は、新規 Oracle インストールでのみ表示されます。Microsoft SQL Server のサポート対象バージョンでは発生しません
アップグレード後のキャンセル済みジョブの確認
アップグレードが完了した後、「キャンセル済み」状態の
Clarity
ジョブを確認してください。 特に、以前に繰り返しジョブであったキャンセル済みのジョブに注意します。 場合によっては、アップグレード後にジョブ パラメータが変更され、ジョブが「キャンセル済み」状態に移行することがあります。 キャンセル済みのジョブを事前に確認しなかった場合、それらのジョブに気付くのは、ビジネス部門からエスカレーションを受け取った後になるでしょう。
インストールおよびアップグレードの依存関係
このリリースのインストールおよびアップグレード スクリプトでは、以下の依存関係がリストに示された時系列で取り込まれます。
インストール/アップグレードするコンポーネント
必要なコンポーネント
クラシック PPM
のアップグレード
  • データ ウェアハウスが設定済み
  • データ ウェアハウスのロード ジョブの完了
Clarity
  • PMO アクセラレータ アドインがインストールされている
PMO または APM アドインのインストール
  • データ ウェアハウスが設定済み
リリース
15.8.1
でサポートされているアップグレード パス
表を参照して、
Clarity
の最新バージョンにアップグレードできる最小のサポート対象リリースを確認してください。
Clarity のバージョン
直接アップグレードでサポートされている最小バージョン
15.8.1
15.6.1
15.8.0
15.3
15.7.1
15.3
15.7.0
15.2
15.6.1
15.0
15.6.0
15.0
15.5.1
14.3
15.5.0
14.3
15.4.1
14.1
15.4.0
13.2
15.3
13.2
15.2
13.2
15.1
13.2
  • リリース 14.3 以前を使用している場合、それらのリリースはサポートされていません。 最初にリリース 15.4 にアップグレードしてから、
    15.8.1
    にアップグレードします。
  • リリース 14.2 (Jaspersoft 5.6.1 を含む)またはリリース 14.3 (Jaspersoft 6.1.0 を含む)からリリース
    15.8.1
    直接
    アップグレードすることはできません。 Jaspersoft 6.4.2 または 7.1 のアップグレードは、これらの設定をサポートしていません。
    間接
    アップグレードは引き続きサポートされます。 たとえば、最初に 14.3 と Jaspersoft 6.4.2 にアップグレードします。 次に、15.8 にアップグレードし、Jaspersoft 7.1 にアップグレードします。
  • Jaspersoft のレポート環境を設定していなくても、旧リリースからアップグレードできます。 データ ウェアハウスが必要ですが、レポートの作成は必須ではありません。 14.x からアップグレードして、レポート環境の新規インストールを実行することもできます。
  • 13.x 以前のリリースからアップグレードするには、多くの場合、最初に 14.3 または 14.4 にアップグレードして拡張レポート コンポーネントをスキップする方法が役立ちます。 この方法により、アップグレード手順が失敗した場合のトラブルシューティングおよび再開プロセスが簡素化されます。 次に、14.x から、15.6 にアップグレードして拡張レポート用に Jaspersoft 7.1 をインストールできます。
インストールを最新リリースに更新するために必要な増分アップグレード ステップの数がインストーラで検出されます。 必要なステップが複数である場合は、各ステップで自動バックアップを保存するかどうかを指定するように求められます。 たとえば、15.4 から 15.5、15.5 から 15.5.1、15.5.1 から 15.6、15.6 から 15.6.1、15.6.1 から 15.7、15.7 から 15.7.1、15.7.1 から 15.8、および 15.8 から 15.8.1 です。
ベース バージョンにパッチをインストールした場合は、サポートされている最新累積パッチを適用してあることを確認してから、アップグレードします。 アップグレードの前および後のパッチ メンテナンスは、トラブルシューティング、セキュリティの修正、および一般的なシステムの稼働状況のために重要です。
以下の手順に従います。
  1. Clarity
    Jaspersoft の累積パッチ
    」ページを参照してください。
  2. ヘルプ ページの右上にある
    [バージョン]
    メニューから現在のリリースを選択します。
    たとえば、15.1 を選択し、15.1.0.9 パッチがインストール済みであることを確認します。または、15.3 を選択し、15.3.0.5 パッチがインストール済みであることを確認します。その後に 15.8 へのアップグレードを開始します。 アップグレード後に、最新の 15.8 パッチをインストールします。
サポートされていないパッチ レベルから直接アップグレードしようとすると、問題が発生する可能性があります。 良い状態で使用するには、サポートされているアップグレードパスに沿ってください。 詳細については、CA サポートにお問い合わせください。 「
Clarity
コミュニティ
」にアクセスして、具体的な質問について他のコミュニティ メンバと協力して取り組むこともできます。
プレアップグレード: インストール チェッカーの実行(オンプレミスのみ)
インストール チェッカー(checkinstall)ユーティリティは、インストールまたはアップグレードを評価します。 このユーティリティは、インストールまたはアップグレードの開始時点、およびアップグレードの試みの最後に自動的に実行されます。 手動で実行することもできます。 このユーティリティは <インストール ルート>/checkinstall/check-logs ディレクトリで、レポート結果ファイル(precheck-results.html)を作成します。
アップグレード アクション
: 最適な結果を得るには、フル インストールおよびアップグレード プロセスを開始する前に、インストール チェッカーを実行します。 続行する前に慎重に評価し、警告を解決します。
以下の手順に従います。
  1. Clarity
    インストーラを
    Clarity
    アプリケーション サーバに解凍します。
  2. コマンド プロンプトを開き、インストーラを解凍したディレクトリにある checkinstall ディレクトリに移動します。
  3. checkinstall コマンドを実行します。
    UNIX:
    sh checkinstall.sh
    Windows
    checkinstall.bat
    オペレータのユーザ名と電子メール アドレスの入力が求められます。 この情報は、アップグレードまたはインストールしているユーザと、ユーザの電子メールを参照します。 この情報は、インストール ログのレコードとして格納されます。
  4. 結果を確認します。
    結果には、警告およびエラーが含まれ、それまでに行ったカスタマイズがあればそれも含まれます。 カスタマイズを確認し、必要に応じてアップグレードの調整を行います。
サードパーティの JAR ファイルをインストーラからアクセス可能にする(オンプレミスのみ)
一部のサードパーティ ライブラリの JAR ファイル(現時点では jgroups-all.jar および xinclude.jar)に対するライセンス上の制約のため、JAR ファイルの配布方法が変更されました。 これらの JAR ファイルは、インストール メディアの
Clarity
イメージとは別に配布されます。 install.jar イメージには、これらの JAR ファイルは含まれていません。 install.jarに含まれる以前のバージョンのすべてのインストールパッケージは、JARファイルも除外します。
Clarity
の各リリースでは、サードパーティ ライブラリ JAR ファイルを含む JAR ファイルがインストール メディアのフォルダにバンドルされています。 リリース 15.x の場合、.jar ファイルは
thirdparty.libs.15.x.0.jar
という名前です。
アップグレード アクション
thirdparty.libs.15.x.0.jar
ファイルをインストール メディアから取得します。 ファイルシステム内の場所にファイルを置き、インストーラがアクセスできるようにします。
ヒント
: インストーラで JAR ファイルの場所の入力を求められないようにするには、JAR ファイルをインストールのルート ディレクトリに配置します。 ファイルを別のディレクトリに置くと、インストーラはファイルの場所の入力を求めます。
大規模データ セットのアップグレード(オンプレミスのみ)
Clarity
のアップグレードが大量のデータを処理する場合は、アップグレードで使用される既定メモリ設定を上書きすることを推奨します。
このリリース用の既定のメモリ設定を上書きすることができます。
memory.properties
ファイルを作成し、$cappm/config ディレクトリ内に配置します。 そのファイルに必要なメモリ値を設定します。
アップグレードで使用される既定値は次のとおりです。
defaultScriptMaxMem=1024m defaultScriptPermGenMem=128m
memory.properties
ファイル内のサンプル設定を以下に示します。
defaultScriptMaxMem=2560m defaultScriptPermGenMem=512m
MS SQL Server データベース互換性レベル
このリリースで SQL Server 2016 を使用している場合は、SQL Server Management Studio から互換性レベルを 130 に設定するか、以下のコマンドを使用します。
EXEC SP_DBCMPTLEVEL <database>, 130
カスタムプロセス、スクリプト、およびその他のカスタマイズ
Clarity
は、サポートされていないカスタマイズされたコンテンツはアップグレードできません。 カスタマイズを無効にする必要があり、製品の機能の変更に対応するには、再設計して再実装する必要があります。
アップグレード後、カスタマイズを無効にしないと、カスタマイズによってエラーが発生したり、期待どおりに動作しなくなったりする可能性があります。
以下の手順に従います。
  1. カスタムコンテンツを特定します。 たとえば、以前のリリースのタイムシート・ステータス属性を変更したカスタムGELスクリプトを使用して、1つ以上のカスタム・プロセスがあります。
  2. カスタマイズを確認し、アップグレードスクリプトがカスタムコンテンツをサポートしていない可能性があることを認識します。 カスタムコンテンツがアップグレードされても、期待どおりに機能しなくなる可能性があります。 たとえば、カスタムプロセスは、新しいリリースで変更されたオブジェクトまたは属性を参照します。
  3. オンプレミスの管理者であるcheckinstallスクリプトは、アップグレード前に検出されたカスタマイズの警告を表示します。 アップグレード エクスペリエンスに悪影響を及ぼす可能性があるカスタマイズのタイプを把握するため、以下の警告または参照ログを確認できます。 例:
    WARNING: Possible schema customizations have been found. Any customizations to the system are the responsibility of the customer to maintain and are not supported. To upgrade, all customizations must be reviewed, changed, or removed as needed before the upgrade. After a successful upgrade, the customizations may be added back to the system. The possible customizations found are listed in the following log files:
    check‐logs/database_customization_triggers.txt check‐logs/database_customization_indexes.txt check‐logs/database_customization_tables.txt checklogs/database_customization_constraints.txt
  4. SaaS 管理者には、これらの警告または参照されたログは表示されません。 これらのサンプル メッセージは、アップグレード体験に悪影響を与える可能性のあるカスタマイズのタイプについての情報を提供します。
  5. オンプレミスまたは SaaS 環境では、アップグレードの前にカスタマイズをオフにします。 アップグレード後、カスタマイズを再導入し、
    クラシック PPM
    インターフェースでテストします。 必要に応じて、
    Clarity
    のカスタマイズ動作の影響を確認します。
  6. データベースオブジェクトに加えて、属性値も評価します。 Oracle および Microsoft SQL および データ ウェアハウスの変更を確認します(英語版のドキュメントの「リファレンス」を参照)。 いずれかのカスタマイズが削除された属性、変更された属性、または新しい属性に依存しているかどうかを確認します。
一部のお客様の環境では、レガシー カスタム コンテンツでエラーが発生しています。 カスタム プロセス、スクリプト、またはその他のレガシー カスタム コンテンツを無効にすると、
Clarity
によって、エンド ユーザに実質的な損失を与えずに機能が提供されました。 完全な COTS/SaaS ソリューションの
Clarity
機能の価値と、サポートされていない独自のカスタマイズを開発する価値を比較して分析することをお勧めします。
プレおよびポストアップグレード: ファイル ディレクトリ カスタマイズの保持(オンプレミスのみ)
アップグレード中、ターゲット インストール ディレクトリを指定するよう求められます。 新しいアップグレード前およびアップグレード後手順では、ant ベースのスクリプトを使用して、
Clarity
ディレクトリに、またはこのディレクトリからファイルをコピーできます。 ant スクリプトを使用して
Clarity
ディレクトリ内のカスタマイズの保持および復元を自動化します。
テンプレートは、インストーラ ルート ディレクトリ(install.bat ファイルと同じレベル)内にあるリリース固有のアップグレード フォルダに用意されています。 テンプレートは、
preprocess-upgrade.xml
および
postprocess-upgrade.xml
です。
preprocess-upgrade.xml スクリプトの例
<project name="content" default="upgrade" basedir="."> <target name="upgrade"> <echo>Preserving customer specified files prior to upgrade from install.dir = ${install.dir}</echo> <if fileexists="${install.dir}" not="true"> <fail>Install dir not specified = ${install.dir}</fail> </if> <delete dir="upgrade_temp"/> <mkdir dir="upgrade_temp" /> <!-- Uncomment the copy below and list the files to be included for preservation --> <!--<copy todir="upgrade_temp"> <fileset dir="${install.dir}" > <include name="myfiles/my*.*"/> <include name="abb/*01.jar"/> <include name="a*01.jar"/> </fileset> </copy>--> </target> </project>
postprocess-upgrade.xml スクリプトの例
<project name="content" default="upgrade" basedir="."> <target name="upgrade"> <echo>Restoring customer specified files after upgrade to install.dir = ${install.target.dir}</echo> <if fileexists="${install.target.dir}" not="true"> <fail>Install dir not specified = ${install.target.dir}</fail> </if> <!-- Uncomment the copy task below and list the files to be restored that were preserved in the preprocess-upgrade.xml script.--> <!--<copy todir="${install.target.dir}"> <fileset dir="upgrade_temp" > <include name="myfiles/my*.*"/> <include name="abb/*01.jar"/> <include name="a*01.jar"/> </fileset> </copy>--> </target> </project>
ポストアップグレードまたはポストインストール: Oracle 12c パフォーマンスの最適化(オンプレミスのみ)
Oracle 12c R1 または R2 をローカルにインストールしている場合は、構造化クエリで ORDERED ヒントを使用すると、Oracle 12c に関するリグレッションの問題が検出される可能性があります。 オプティマイザが 12.2.0.1 に設定されている場合、12c R2 の Oracle のバグによってパフォーマンスが低下する可能性があります。
  • Oracle 12c R1 (12.1.0.2)を使用するシステムでは、それ以上のアクションは必要ありません。
  • Oracle 12c R2 (12.2.0.1)を使用しているシステムでは、オプティマイザを 12.1.0.2 に設定することでパフォーマンスを最適化できます。 このオプションのローカル修正を適用することをお勧めします。
以下の手順に従います。
  1. Oracle のコマンド プロンプトで、以下の行を入力します。
    sqlplus / as sysdba ALTER SYSTEM SET "_fix_control" = '17800514:0'; Exit;
  2. 以下のコマンドを実行します。
    ALTER SYSTEM SET OPTIMIZER_FEATURES_ENABLE= '12.1.0.2' SCOPE=BOTH;
  3. Oracle 12c R2 初期化ファイル パラメータが以下の例に似ていることを確認します。
    *._fix_control='17800514:0' *._optimizer_multi_table_outerjoin=FALSE *.audit_file_dest='/fs0/oracle/12201/12c/admin/niku/adump' *.audit_trail='DB' *.cluster_database=FALSE *.compatible='12.2.0.1' *.control_files='/fs0/oracle/12201/12c/oradata/niku/CONTROL01.CTL','/fs0/oracle/12201/12c/oradata/niku/CONTROL02.CTL' *.cursor_sharing='FORCE' *.db_block_size=8192 *.db_name='niku' *.diagnostic_dest='/fs0/oracle/12201/12c/admin/niku/udump' *.dispatchers='(PROTOCOL=TCP) (SERVICE=nikuXDB)' *.local_listener='LISTENER_NIKU' *.nls_comp='BINARY' *.nls_date_format='YYYY-MM-DD HH24:MI:SS' *.nls_language='AMERICAN' *.nls_sort='BINARY' *.nls_territory='AMERICA' *.open_cursors=1000 *.optimizer_adaptive_plans=false *.optimizer_adaptive_reporting_only=TRUE *.optimizer_adaptive_statistics=FALSE *.optimizer_features_enable='12.2.0.1' *.optimizer_inmemory_aware=FALSE *.pga_aggregate_target=4G *.processes=1000 *.remote_login_passwordfile='EXCLUSIVE' *.session_cached_cursors=1000 *.sessions=1536 *.sga_target=80G *.streams_pool_size=536870912 *.trace_enabled=TRUE *.undo_tablespace='UNDOTBS1'