Confluenceのバージョンアップ (5.7)


Confluenceの5.7がリリースされました。
クラウド版で利用していたら、このへんの作業は気にしないでいいのかもしれませんが、今回はスターターライセンスで運用している環境のバージョンアップをしましたので、メモです。

エキスパートな方向けではありませんので、ご容赦下さい。
また、Atlassianから公開されている、一般的な範囲での情報のみ載せます。

# バックアップをしておく

- DBのダンプ
- Confluene home とConfluenceバイナリがインストールされているディレクトリをバックアップ（Copy)
 - /var/atlassian/application-data/confluence and /opt/atlassian/confluence/ 以下がデフォルト。 
- XML形式でのバックアップも取っておく。（綺麗な環境にインポート可能です）

# インストール用のバイナリを起動

Atlassianから提供されている、最新のインストーラーを展開し、実行します。
単純なログですが、こんな感じのメッセージが出ます。

※途中で、デフォルトから変更しているファイルについては、インストーラー側から報告が出て来ます。できればちゃんと控えておいて下さい。

```
% sh atlassian-confluence-5.7-x64.bin

Unpacking JRE ...
Starting Installer ...

This will install Confluence 5.7 on your computer.
OK [o, Enter], Cancel [c]

Choose the appropriate installation or upgrade option.
Please choose one of the following:
Express Install (uses default settings) [1], Custom Install (recommended for advanced users) [2], Upgrade an existing Confluence installation [3, Enter]
2

Where should Confluence 5.7 be installed?

 # .... 中略 ....

Checking for local modifications.

List of modifications made within Confluence directories.

The following provides a list of file modifications within the confluence
directory.

Modified files:
	bin/setenv.sh
	conf/server.xml
Removed files:
    ......
	
[Enter]


Checking if your instance of Confluence is running
Upgrade Check List
Back up your external database
We strongly recommend you back up your Confluence database if you have not
already done so.

Please refer to the following URL for back up guidelines:
http://docs.atlassian.com/confluence/docs-57/Production+Backup+Strategy

Check plugin compatibility
Check that your non-bundled plugins are compatible with Confluence 5.7.

For more information see our documentation at the following URL:
http://docs.atlassian.com/confluence/docs-57/Installing+and+Configuring+Plugins+using+the+Universal+Plugin+Manager


Please ensure you have read the above checklist before upgrading.
Your existing Confluence installation is about to be upgraded! Do you want to proceed?
Upgrade [u, Enter], Exit [e]


Your instance of Confluence is currently being upgraded.
Checking if Confluence has been shutdown...
Backing up the Confluence installation directory
                                                                           
Backing up the Confluence home directory

#.... ちょっと時間かかります ....	

Extracting files ...
                                                                           

# 起動の準備、自動起動まで勝手にすすみます
Please wait a few moments while Confluence starts up.
Launching Confluence ...
Installation of Confluence 5.7 is complete
Your installation of Confluence 5.7 is now ready and can be accessed via
your browser.
Custom modifications
Your previous Confluence installation contains customisations (eg
server.xml) that must be manually transferred. Refer to our documentation
more information:
http://docs.atlassian.com/confluence/docs-57/Upgrading+Confluence#UpgradingConfluence-custommodifications
Confluence 5.7 can be accessed at http://localhost:9090

Confluence 5.7 may take several minutes to load on first start up.
Finishing installation ...

```

ちなみに、この作業はいつもコマンドラインで実行しているんですが、X serverを利用してGUIでも実施できるんですね。（確認はしません）

# 自動起動後の注意点

上記で問題なければアップグレード完了ですが、インストールの途中でメッセージが出た通り、カスタマイズしているファイルに関しては **上書き** されてしまいます。

このため、バックアップや設定のメモなどから、設定ファイルを修正しないといけません。
たとえば、Confluenceの起動用ポート、ContextPath、起動時のJVMのパラメータなどを書き換えている場合は、注意が必要です。「起動した！」と喜んでアクセスしても、ポートがデフォルトポート(8090)になっていますので、Reverse proxy側と繋がらない場合があります。

この件については、下記に対応方法が。

# パラメータ指定をして自動インストール



**response.varfile** という感じで、設定を指定して、インストーラ起動後から一気にダイアログなしでインストールしてしまうこともできるようですね。

- [Performing an Unattended Installation]
(https://confluence.atlassian.com/display/DOC/Installing+Confluence+on+Linux#InstallingConfluenceonLinux-DownloadandRuntheConfluence'LinuxInstaller'inUnattendedMode)

DockerのConfluence入りイメージなんかは、この仕組みを使っているものもあります。
ContextPathや自動起動のOffが指定きるかは確認していないので、次回試してみようと思います。