Below are some important notes on upgrading to Confluence 3.5. For details of the new features and improvements in this release, please read the Confluence 3.5 release notes.
On this page:
リリース ノートで説明されているように、このリリースには新しい「自動ウォッチ」機能が含まれています。自動ウォッチをオンにすると、追加または更新したページで誰かが編集またはコメントするたびに、メール通知が送信されます。
Note that autowatch is enabled by default for all new and existing users on upgrade. We recommend that you let all Confluence users know that autowatch will be turned on for their usernames when you upgrade to Confluence 3.5. People can turn autowatch off by editing the email settings in their user profile.
このリリースでは、プロファイル画像の新しいセットを提供します。Confluence 3.5 にアップグレードすると、古いセットは選択できなくなります。すでに古い写真の中から選択しているユーザーは、その写真を引き続き使用できます。後で新しい写真を選択したり、自分の写真をアップロードしたりすると、元の写真には戻せません。
Confluence 3.5 では、「チーム ラベル」という用語を、よりわかりやすい用語「スペース カテゴリ」に変更しました。これらは、論理的に関連するスペースをグループ化するために、スペースに適用できるキーワードです。
Confluence 3.5 では、スペースのリストを表示し、スペース カテゴリ別にグループ化して提供する、新しいスペース ディレクトリも導入されています。
If your Confluence site has a number of team labels (now called space categories) already applied to the spaces, you may want to tidy up the categories to optimise your space directory.
詳細情報:
As mentioned in the release notes, the Atlassian Support Tools plugin is now shipped with Confluence. If you installed the earlier version of the plugin, you will need to uninstall it before upgrading Confluence.
Confluence がユーザーとグループを保存、アクセス、管理する方法は、Confluence 3.5 ではまったく異なります。リリース ノートで説明されているように、多くの改善点があります。Confluence 3.5 にアップグレードするときに、アップグレード プロセスでは、次の処理によってデータが自動的に移行されます。
次のセクションでは、サポートされている各構成タイプのアップグレードに関する考慮事項について説明します。
現在、Confluence インストールが Confluence データベース内のユーザーとグループを管理している場合は、アップグレード時にアクションは不要です。これは、ユーザー管理用 Crowd、Jira、LDAP、またはカスタム ディレクトリに接続されていない Confluence サイトに適用されます。
現在、Confluence が認証とユーザー管理のために LDAP サーバーに接続する標準的な方法を使用している場合は、アップグレード プロセスによって設定が移行されます。
To ensure that the upgrade process can migrate your configuration, please follow the Confluence upgrade guide. In particular, make sure that you:
次のファイルを古い Confluence インストールから新しいインストールにコピーします。
<Installation-Directory>/confluence/WEB-INF/classes/atlassian-user.xml <Installation-Directory>/confluence/WEB-INF/classes/osuser.xml |
アップグレードの完了後、次の手順に従ってください。
If you are using a legacy LDAP configuration (such as OSUser with LDAP authentication only), you'll need to reconfigure your LDAP support as covered on Connecting to an LDAP Directory and Connecting to an Internal Directory with LDAP Authentication. In case you encounter an issue, please refer to Upgrade to Confluence 3.5 with OSUser LDAP authentication fails for more details.
Jira データベースへの JDBC 接続を介して、すでに Jira を使用して Confluence ユーザーを管理している場合は、Confluence をバージョン 3.5 にアップグレードしてから、Jira をバージョン 4.3 にアップグレードする必要があります。
Jira 4.3 は大きく異なるデータベース スキーマを持ち、新しい REST インターフェイスを公開します。これによって、Confluence は継続して Jira ユーザー管理を利用します。Jira 4.3 にアップグレードしてから Confluence 3.5 にアップグレードする場合、Confluence 3.5にアップグレードすると Confluence ユーザーはログインできなくなります。
Confluence 3.5 does not ship with an OSUser migrator, and it will not recognise the OSUser definition in your atlassian-user.xml file. When upgrading Confluence:
atlassian-user.xml と osuser.xml を、Confluence 3.5 インストール ディレクトリにコピーしないでください。server.xml ファイルを Confluence 3.5 インストール ディレクトリに必ずコピーしてください。アップグレードの完了後、次の手順に従ってください。
If you are using Confluence with Atlassian Crowd for user management and SSO:
次のファイルを古い Confluence インストールから新しいインストールにコピーします。
<Installation-Directory>/confluence/WEB-INF/classes/atlassian-user.xml |
WEB-INF/lib/ ディレクトリにコピーする必要はなくなりました。SSO ($CONFLUENCE$/WEB-INF/classes/seraph-config.xml で定義されている) 向け com.atlassian.crowd.integration.seraph.v22.ConfluenceAuthenticator を使用している場合は、com.atlassian.confluence.user.ConfluenceCrowdSSOAuthenticator ではなく新しいバージョンを代用してください。具体的には、次を変更してください。
<authenticator class="com.atlassian.crowd.integration.seraph.v22.ConfluenceAuthenticator"/> |
これに
<authenticator class="com.atlassian.confluence.user.ConfluenceCrowdSSOAuthenticator"/> |
See Connecting to Crowd or Jira for User Management.
seraph-config.xml で定義されているカスタム認証機能は影響を受けず、以前のバージョンの Confluence と同じように機能するはずです。
カスタム ディレクトリ タイプは使用不可で、Confluence 3.5 以降ではサポートされていません。OSUser または Atlassian-User で定義されているカスタム プロバイダーがあり、ユーザーおよびグループ用に独自のストレージを定義している場合、アップグレード手順により Confluence を起動できなくなります。
次のソリューションが役立つかどうかを検討してください。
If you need to keep the custom directory connection, please consider whether Atlassian Crowd meets your requirements. See the documentation on developing a custom directory connector for Crowd.
Confluence 3.5 には、信頼関係を管理するユニファイド アプリケーション リンク (UAL) プラグインが含まれています。信頼済みアプリや OAuth などの信頼関係の認証が、管理コンソールのアプリケーション リンクを介して設定されるようになりました。最初に [アプリケーション リンク] 画面に移動すると、既存の信頼済みアプリと OAuth の信頼関係をアプリケーション リンクにアップグレードするように指示されます。
リンクをアップグレードする方法については、「アプリケーション リンクのアップグレード」を参照してください。
アップグレード ダイアログには既知の問題があることに注意してください。これは、同じリモート サーバーに 2 つの異なるタイプの認証 (たとえば、信頼済みアプリと OAuth など) を設定している場合に影響します。[アプリケーション リンク] 画面に表示されるアップグレード メッセージにより、2 つのアプリケーション リンクをアップグレードするように求められます。ただし、実際には 2 つの認証タイプが設定された 1 つのアプリケーション リンクのみが必要です。つまり、1 つのアプリケーション リンクをアップグレードし、そのアップグレードされたリンクで不足している認証タイプを設定します。
Confluence 検索エンジンを Lucene 2.2.0 から 2.9.3 にアップグレードしました。そのため、アップグレード時にはインデックスの再作成を強くお勧めします。アップグレード後、検索は再インデックスなしでも引き続き機能しますが、ログに例外が表示され、機能が低下します。
Confluence 3.5 にアップグレードする際に、アップグレード タスクが自動で実行されてインデックスが再構築されます。再構築タスク中、アップグレード プロセスでは、アップグレード タスクを実行するために、ディスク上のインデックスのサイズの 3 倍のスペースが必要になります。このスペースは、アップグレード プロセスが終了すると解放されます。
後でインデックスを再構築したい場合は、アップグレード後の起動時に、次の引数を Confluence に渡すことができます。
-Dconfluence.skip.reindex=true |
初期起動ではアップグレード タスクの前にウォーミング クエリが実行されるため、ログ中に ConfluenceSearcherInitialisation からのエラー メッセージが表示されます。これは問題ではありません。
We have removed the following system property: confluence.import.use-legacy-importer. Specifying this property will no longer have any effect in Confluence. See Recognized System Properties. (See the Confluence 3.3 documentation for the behaviour in earlier versions of Confluence.)
Confluence インストールが MySQL データベースに接続されている場合は、このデータベースが「READ-COMMITTED」トランザクション分離レベルを使用していることを確認してください。MySQL のデフォルトのトランザクション分離モードについて次の点に注意してください。
See the last step of the MySQL server installation procedure for details.
このセクションでは、Confluence 4.0 (Confluence の将来のリリース) で廃止が予定されている Confluence 3.5 の機能に関する高度な警告を提供します。
Confluence 4.0 では、グローバル スペースを個人用スペースに変換する機能をサポートしなくなります。弊社の調査により、この機能はほとんど使用されていないことがわかっています。したがって、可能であれば、Confluence を簡素化するという、現在進行中のミッションの一環として、この機能を削除することにしました。
In Confluence 4.0, the 'Mail Page' plugin will no longer be bundled with Confluence. This means that the 'Mail Page' feature for e-mailing a page will not be available in Confluence (out of the box) and the Share button will be the recommended method for e-mailing pages to others.
以前お知らせしたように、このリリースから、以下はサポートされなくなります。
Please see End of Support Announcements for Confluence.
Confluence 4.0 では、次のデータベースとブラウザーのサポートを終了する予定です。
Please see End of Support Announcements for Confluence.
次のサポートを提供するようになりました。
このセクションはプラグイン開発者向けです。前述のように、Confluence 検索エンジンを Lucene 2.2.0 から 2.9.3 にアップグレードしました。いくつかの Lucene メソッドが非推奨になりました。これらのメソッドは、プラグインをコンパイルするときにリストされます。Lucene のドキュメントを参照し、できるだけ早くこれらのメソッドを置き換えることをお勧めします。Confluence が Lucene 3 にアップグレードされた時点で利用できなくなります。このさらなるアップグレードのスケジュールはまだ決まっていませんが、いずれ実施する計画を立てています。
jQuery is the supported JavaScript library for plugin developers.
We first announced the deprecation of other JavaScript libraries with Confluence 2.8. Please note that we have now removed the following libraries from Confluence:
Unix/Linux ベースのオペレーティング システム上の X11 依存関係/ライブラリは、Confluence 3.5 以降では不要になりました。したがって、Confluence 3.5 アップグレードまたは Confluence 3.5 以降の新しいインスタンスをインストールする際に、これらのライブラリをインストールする必要はありません。
As always, please test your upgrades in your test environment before rolling into production. |
すでに Confluence のいずれかのバージョンを実行している場合、以下の手順に従って最新バージョンにアップグレードしてください。