アップデート方法
本CMSのアップデート方法について
使用しているバージョンを確認
現在使用しているバージョンを確認します.
本CMSのコンテンツ表示ページ下部にバージョンが書かれています.
- ex)
Powered by ContentsPlanet 2020.08.31 © 2016-2020 ContentsPlanet Development Team
上の例の場合, バージョンは,
2020.08.31です.
アップデートしたいバージョンを確認
アップデート
アップデート方法は, 導入時にGitを用いたか, FTPなどで直接ファイルをアップデートしたかで, 異なります.
Git を用いた方法
1.サーバにsshログイン
2.コマンド
本CMSが存在するディレクトリに移動します.
cd ~/www/wiki
最新版を取得します．
git fetch
アップデートしたいバージョンとマージします.
git merge <version-tag-name>
version-tag-nameは, 各バージョンと紐づいているタグ名です. Githubのリリースページ や, git tagコマンドで確認できます.
競合が発生した場合は, 解決してください.
ファイルを直接アップロードした場合
1.フォルダを置き換えます
通常
何もカスタマイズしていないときは, 以下のフォルダ, ファイル以外を置き換えます.
- ContentsPlanet
- Cache
- Home
ContentsPlanet.php
最後にシステム設定ファイルContentsPlanet.phpを, 最新版と差分を確認しつつ統合します.
カスタマイズした場合
通常と同様に, アップデート対象のフォルダを置き換えますが, カスタマイズしたファイル以外を置き換え, カスタマイズしたものは, 差分を確認しつつ統合します.
カスタマイズされうるファイルとして以下があります.
- ContentsPlanet
- Client
- Common
CommonHead.htmlEndpointCommonHead.html
- Common
ContentsPlanet.php
- Client
アップデート後のトラブル
アップデート後に何かトラブルが起きたとき, 多くは古いキャッシュやメタデータの互換性が問題です.
以下のファイルを削除してください.
- ContentsPlanet
.htaccess← 削除(カスタマイズしている場合は バックアップ → 削除 → 自動生成 → 書き換え)- Cache
.htaccessこれは消さない キャッシュファイルが第三者に見られる可能性があります.~.cache← 削除
- Home
- Master
- Contents
.metadata~← 削除.index~← 削除
- <他ユーザ>
- Contents
.metadata~← 削除.index~← 削除
- Master
- Frontend
- Module
- …
Cache ファイルには, コンテンツのパース結果や, メタ情報, のほかに, 変更履歴も含まれています.
変更履歴を残したい場合は, history-から始まるキャッシュファイルは残しておきます.
ContentsPlanet/.htaccessを削除した場合, 再度.htaccessを自動生成する必要があるので, システムルートディレクトリにアクセスします.
注釈
- ^ "Calendar Versioning". CalVer. accessed at 2020-08-31.