Software Development Memo - 利用者の投稿記録 [ja]

Software Development Memo:プライバシー・ポリシー

2025-09-26T09:52:28Z

Admin: ページの白紙化

メインページ

2021-05-10T06:01:32Z

Admin:

ここは、ソフトウェア開発に関する個人的なメモを残すサイトです。

2011年2月17日より、サイト名を「Open Source Memo」から「Software Development Memo」に変更しました。

== リンク ==
*[http://twitter.com/#!/pandakojirou Twitter]
*[http://www.sdmemo.com/blog/ Software Development Memo – blog版]

== ページ全体の更新履歴 ==

個別コンテンツの更新履歴は、メニューの [[特別:最近の更新]] を参照下さい。

----

管理用 : [[特別:Upload]], [[MediaWiki:Sidebar]], [[Sandbox]], [[:Category:下書き]]

メインページ

2020-08-30T14:57:44Z

Admin:

ここは、ソフトウェア開発に関する個人的なメモを残すサイトです。

2011年2月17日より、サイト名を「Open Source Memo」から「Software Development Memo」に変更しました。

== リンク ==
*[http://twitter.com/#!/pandakojirou Twitter]
*[http://www.sdmemo.com/blog/ Open Source Memo – blog版]

== ページ全体の更新履歴 ==

個別コンテンツの更新履歴は、メニューの [[特別:最近の更新]] を参照下さい。

----

管理用 : [[特別:Upload]], [[MediaWiki:Sidebar]], [[Sandbox]], [[:Category:下書き]]

MediaWikiのアップグレード手順

2016-08-29T13:44:39Z

Admin: /* 更新履歴 */

[[Category:導入手順]][[Category:CMS]]
バージョン1.15.1へのアップグレード手順を示します。

== 手順 ==

=== DBとWebのデータをバックアップする ===
DBバックアップコマンド例

mysqldump -u <MYSQL_USER> -p <DB_NAME> > <DUMP_NAME>

=== Apacheを終了する ===
終了は必須ではありませんが、トラブル防止のために実施しました。

=== 新たなMediaWikiのアーカイブファイルを既存ディレクトリに上書きする ===
コマンド例

tar zxvf mediawiki-1.15.1.tar.gz -C <APACHE_HOME>/htdocs/ --strip-components=1

=== AdminSettings.phpをコマンドラインから実行する（1.15.1 の場合） ===

'''注意 : 最新バージョンでは、既に使用できません'''

AdminSettings.phpは、ブラウザから実行できません。

コマンド例（maintenanceディレクトリに移動してください）
$ php update.php --aconf ../AdminSettings.php

エラーメッセージが出る場合は、AdminSettings.phpの設定が不適切であるかもしれません。

=== update.phpをコマンドラインから実行する（1.23.5 の場合） ===

ver 1.16.0 -> 1.23.5 にアップグレードを行いましたが、以前とアップグレード用ファイルが変更されていました。

cd /usr/local/apache2/htdocs/w/
php maintenance/update.php

関係ないですが、ページ編集時、Draft extention がエラーとなってしまい、処理続行できなかったので、コメントアウトしました。アップグレードが必要かも。

=== Apacheを起動する ===

== 補足 ==

=== ver 1.16.0 -> 1.23.5 にアップグレード時の注意事項 ===

公式サイトに記載はありますが、念のため備忘として残します。

==== Profilerのエラー ====

【事象】

ページアクセス時、下記のエラーが出る。操作一切不可。

Fatal error: Cannot redeclare wfProfileIn() (previously declared in /usr/local/apache2/htdocs/w/includes/profiler/Profiler.php:33) in /usr/local/apache2/htdocs/w/includes/ProfilerStub.php on line 24

【対処】

ファイルを移動。

/usr/local/apache2/htdocs/w/
mv StartProfiler.php StartProfiler.orig.php

Profilerが何なのかは知りません。

==== skinのエラー ====

【事象】

画面上部に、常に下記の Warning が出る。

Warning: A skin using autodiscovery mechanism, MySkin, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

Warning: A skin using autodiscovery mechanism, Simple, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

Warning: A skin using autodiscovery mechanism, Chick, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

Warning: A skin using autodiscovery mechanism, KindofBlue, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

Warning: A skin using autodiscovery mechanism, Standard, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

Warning: A skin using autodiscovery mechanism, Nostalgia, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

【対処】

現状の skins フォルダを消して、新規の skins フォルダを上書き。

当サイトは、スキンは vector しか使用していないので、これで問題なし。skin の仕様変更があったようだが、詳細は知らない。

==== 「特別:最近の更新」にアクセスできない ====

ver 1.16.0 -> 1.23.5 にアップグレード後、[[特別:最近の更新]] を開こうとすると、画面が真っ白となり、apache の error_log に

Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate 2147483648 bytes) in /usr/local/apache2/htdocs/w/includes/User.php on line 2439

のようなログが表示される。php のメモリ割り当てが少ないのかと思い、php.ini の「memory_limit = 128M」を徐々に上げていったが、解決しなかった。

試しに、php のバージョンを 5.3 系の最新版である、5.3.29 に挙げてみたらエラーが解消された。根本原因は謎。（エラー発生時は、5.3.6 を使用していた）

=== ver 1.23.5 -> 1.27.1 にアップグレード時の注意事項 ===

==== php 5.5 が必須 ====

php 5.3 では動作しなくなっていました。また、mbstring と mcrypt も必要になっていました。libmcrypt も yum 経由で追加しています。

yum install libmcrypt
yum install libmcrypt-devel

tar zxf php-5.5.38.tar.gz
cd php-5.5.38
./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-mysql --enable-mbstring --with-mcrypt
make
su
make install

mbstring が無いと、update.php 実行時にエラーになります。

php maintenance/update.php

Error: Missing one or more required components of PHP.
You are missing a required extension to PHP that MediaWiki needs.
Please install:
* mbstring <https://secure.php.net/mbstring>

mcrypt が無いと、MediaWiki ログイン時、画面に以下エラーが表示されます。

Exception encountered, of type "BadMethodCallException"

mcrypt インストールの代わりに、LocalSettings.php に

$wgSessionInsecureSecrets = true;

を記述してもエラーは回避できるのですが、公式サイトによると非推奨とのことです。

参考 : https://www.mediawiki.org/wiki/Manual:$wgSessionInsecureSecrets/ja

==== スキン読み込み ====

MediaWiki 1.24 以降は、スキン自動読み込みが無効になったようです。LocalSettings.php に

wfLoadSkin( 'Vector' );

を追加しました。

== 参考 ==
*http://www.mediawiki.org/wiki/Manual:Upgrading_MediaWiki

== 更新履歴 ==
*2016/08/29
**ver 1.27.1 へのアップグレードの記述を追記
*2014/10/13
**ver 1.23.5 へのアップグレードの記述を追記
*2010/01/10
**ページ作成

MediaWikiのアップグレード手順

2016-08-29T13:44:02Z

Admin: /* 補足 */

[[Category:導入手順]][[Category:CMS]]
バージョン1.15.1へのアップグレード手順を示します。

== 手順 ==

=== DBとWebのデータをバックアップする ===
DBバックアップコマンド例

mysqldump -u <MYSQL_USER> -p <DB_NAME> > <DUMP_NAME>

=== Apacheを終了する ===
終了は必須ではありませんが、トラブル防止のために実施しました。

=== 新たなMediaWikiのアーカイブファイルを既存ディレクトリに上書きする ===
コマンド例

tar zxvf mediawiki-1.15.1.tar.gz -C <APACHE_HOME>/htdocs/ --strip-components=1

=== AdminSettings.phpをコマンドラインから実行する（1.15.1 の場合） ===

'''注意 : 最新バージョンでは、既に使用できません'''

AdminSettings.phpは、ブラウザから実行できません。

コマンド例（maintenanceディレクトリに移動してください）
$ php update.php --aconf ../AdminSettings.php

エラーメッセージが出る場合は、AdminSettings.phpの設定が不適切であるかもしれません。

=== update.phpをコマンドラインから実行する（1.23.5 の場合） ===

ver 1.16.0 -> 1.23.5 にアップグレードを行いましたが、以前とアップグレード用ファイルが変更されていました。

cd /usr/local/apache2/htdocs/w/
php maintenance/update.php

関係ないですが、ページ編集時、Draft extention がエラーとなってしまい、処理続行できなかったので、コメントアウトしました。アップグレードが必要かも。

=== Apacheを起動する ===

== 補足 ==

=== ver 1.16.0 -> 1.23.5 にアップグレード時の注意事項 ===

公式サイトに記載はありますが、念のため備忘として残します。

==== Profilerのエラー ====

【事象】

ページアクセス時、下記のエラーが出る。操作一切不可。

Fatal error: Cannot redeclare wfProfileIn() (previously declared in /usr/local/apache2/htdocs/w/includes/profiler/Profiler.php:33) in /usr/local/apache2/htdocs/w/includes/ProfilerStub.php on line 24

【対処】

ファイルを移動。

/usr/local/apache2/htdocs/w/
mv StartProfiler.php StartProfiler.orig.php

Profilerが何なのかは知りません。

==== skinのエラー ====

【事象】

画面上部に、常に下記の Warning が出る。

Warning: A skin using autodiscovery mechanism, MySkin, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

Warning: A skin using autodiscovery mechanism, Simple, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

Warning: A skin using autodiscovery mechanism, Chick, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

Warning: A skin using autodiscovery mechanism, KindofBlue, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

Warning: A skin using autodiscovery mechanism, Standard, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

Warning: A skin using autodiscovery mechanism, Nostalgia, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

【対処】

現状の skins フォルダを消して、新規の skins フォルダを上書き。

当サイトは、スキンは vector しか使用していないので、これで問題なし。skin の仕様変更があったようだが、詳細は知らない。

==== 「特別:最近の更新」にアクセスできない ====

ver 1.16.0 -> 1.23.5 にアップグレード後、[[特別:最近の更新]] を開こうとすると、画面が真っ白となり、apache の error_log に

Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate 2147483648 bytes) in /usr/local/apache2/htdocs/w/includes/User.php on line 2439

のようなログが表示される。php のメモリ割り当てが少ないのかと思い、php.ini の「memory_limit = 128M」を徐々に上げていったが、解決しなかった。

試しに、php のバージョンを 5.3 系の最新版である、5.3.29 に挙げてみたらエラーが解消された。根本原因は謎。（エラー発生時は、5.3.6 を使用していた）

=== ver 1.23.5 -> 1.27.1 にアップグレード時の注意事項 ===

==== php 5.5 が必須 ====

php 5.3 では動作しなくなっていました。また、mbstring と mcrypt も必要になっていました。libmcrypt も yum 経由で追加しています。

yum install libmcrypt
yum install libmcrypt-devel

tar zxf php-5.5.38.tar.gz
cd php-5.5.38
./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-mysql --enable-mbstring --with-mcrypt
make
su
make install

mbstring が無いと、update.php 実行時にエラーになります。

php maintenance/update.php

Error: Missing one or more required components of PHP.
You are missing a required extension to PHP that MediaWiki needs.
Please install:
* mbstring <https://secure.php.net/mbstring>

mcrypt が無いと、MediaWiki ログイン時、画面に以下エラーが表示されます。

Exception encountered, of type "BadMethodCallException"

mcrypt インストールの代わりに、LocalSettings.php に

$wgSessionInsecureSecrets = true;

を記述してもエラーは回避できるのですが、公式サイトによると非推奨とのことです。

参考 : https://www.mediawiki.org/wiki/Manual:$wgSessionInsecureSecrets/ja

==== スキン読み込み ====

MediaWiki 1.24 以降は、スキン自動読み込みが無効になったようです。LocalSettings.php に

wfLoadSkin( 'Vector' );

を追加しました。

== 参考 ==
*http://www.mediawiki.org/wiki/Manual:Upgrading_MediaWiki

== 更新履歴 ==
*2014/10/13
**ver 1.23.5 へのアップグレードの記述を追記
*2010/01/10
**ページ作成

MediaWikiのアップグレード手順

2016-08-29T13:31:31Z

Admin: /* AdminSettings.phpをコマンドラインから実行する（1.15.1 の場合） */

[[Category:導入手順]][[Category:CMS]]
バージョン1.15.1へのアップグレード手順を示します。

== 手順 ==

=== DBとWebのデータをバックアップする ===
DBバックアップコマンド例

mysqldump -u <MYSQL_USER> -p <DB_NAME> > <DUMP_NAME>

=== Apacheを終了する ===
終了は必須ではありませんが、トラブル防止のために実施しました。

=== 新たなMediaWikiのアーカイブファイルを既存ディレクトリに上書きする ===
コマンド例

tar zxvf mediawiki-1.15.1.tar.gz -C <APACHE_HOME>/htdocs/ --strip-components=1

=== AdminSettings.phpをコマンドラインから実行する（1.15.1 の場合） ===

'''注意 : 最新バージョンでは、既に使用できません'''

AdminSettings.phpは、ブラウザから実行できません。

コマンド例（maintenanceディレクトリに移動してください）
$ php update.php --aconf ../AdminSettings.php

エラーメッセージが出る場合は、AdminSettings.phpの設定が不適切であるかもしれません。

=== update.phpをコマンドラインから実行する（1.23.5 の場合） ===

ver 1.16.0 -> 1.23.5 にアップグレードを行いましたが、以前とアップグレード用ファイルが変更されていました。

cd /usr/local/apache2/htdocs/w/
php maintenance/update.php

関係ないですが、ページ編集時、Draft extention がエラーとなってしまい、処理続行できなかったので、コメントアウトしました。アップグレードが必要かも。

=== Apacheを起動する ===

== 補足 ==

=== ver 1.16.0 -> 1.23.5 にアップグレード時の注意事項 ===

公式サイトに記載はありますが、念のため備忘として残します。

==== Profilerのエラー ====

【事象】

ページアクセス時、下記のエラーが出る。操作一切不可。

Fatal error: Cannot redeclare wfProfileIn() (previously declared in /usr/local/apache2/htdocs/w/includes/profiler/Profiler.php:33) in /usr/local/apache2/htdocs/w/includes/ProfilerStub.php on line 24

【対処】

ファイルを移動。

/usr/local/apache2/htdocs/w/
mv StartProfiler.php StartProfiler.orig.php

Profilerが何なのかは知りません。

==== skinのエラー ====

【事象】

画面上部に、常に下記の Warning が出る。

Warning: A skin using autodiscovery mechanism, MySkin, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

Warning: A skin using autodiscovery mechanism, Simple, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

Warning: A skin using autodiscovery mechanism, Chick, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

Warning: A skin using autodiscovery mechanism, KindofBlue, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

Warning: A skin using autodiscovery mechanism, Standard, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

Warning: A skin using autodiscovery mechanism, Nostalgia, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

【対処】

現状の skins フォルダを消して、新規の skins フォルダを上書き。

当サイトは、スキンは vector しか使用していないので、これで問題なし。skin の仕様変更があったようだが、詳細は知らない。

==== 「特別:最近の更新」にアクセスできない ====

ver 1.16.0 -> 1.23.5 にアップグレード後、[[特別:最近の更新]] を開こうとすると、画面が真っ白となり、apache の error_log に

Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate 2147483648 bytes) in /usr/local/apache2/htdocs/w/includes/User.php on line 2439

のようなログが表示される。php のメモリ割り当てが少ないのかと思い、php.ini の「memory_limit = 128M」を徐々に上げていったが、解決しなかった。

試しに、php のバージョンを 5.3 系の最新版である、5.3.29 に挙げてみたらエラーが解消された。根本原因は謎。（エラー発生時は、5.3.6 を使用していた）

== 参考 ==
*http://www.mediawiki.org/wiki/Manual:Upgrading_MediaWiki

== 更新履歴 ==
*2014/10/13
**ver 1.23.5 へのアップグレードの記述を追記
*2010/01/10
**ページ作成

メインページ

2016-08-29T13:29:06Z

Admin: あえて表示する必要なしのため

メインページ

2014-12-31T01:47:52Z

Admin:

ここは、ソフトウェア開発に関する個人的なメモを残すサイトです。

2011年2月17日より、サイト名を「Open Source Memo」から「Software Development Memo」に変更しました。

== リンク ==
*[http://twitter.com/#!/pandakojirou Twitter]
*[http://www.osmemo.info/blog/ Open Source Memo – blog版 -（更新停止）]
*[http://www.osmemo.info/wiki_old/ 2009/03/01以前のアーカイブ]

== ページ全体の更新履歴 ==

個別コンテンツの更新履歴は、メニューの [[特別:最近の更新]] を参照下さい。

*2014/10/13
**MediaWiki のバージョンを 1.23.5 にアップグレード
**WordPress のバージョンを 4.0 にアップグレード（もう更新していませんが）
*2011/02/17
**サイト名を「Open Source Memo」から「Software Development Memo」に変更
**URLを「[http://www.osmemo.info/ http://www.osmemo.info/]」から「[http://www.sdmemo.com/ http://www.sdmemo.com/]」に変更
*2010/11/28
**MediaWikiのバージョンを1.16.0にアップグレード
**スキンをmonobookからvectorに変更
*2010/01/10
**MediaWikiのバージョンを1.15.1にアップグレード
*2009/12/13
**wikiのアドレスにShort URLを採用

----

管理用 : [[特別:Upload]], [[MediaWiki:Sidebar]], [[Sandbox]], [[:Category:下書き]]

WordPressの導入手順

2014-10-13T15:58:27Z

Admin: /* PHP */

[[Category:導入手順]][[CMS:導入手順]]
本ページでは、CMSソフトウェアである「WordPress」の導入手順を記述します。

== 環境 ==
* OS : CentOS 5.2
* Web Server : Apache 2.2.11
* Database : MySQL 5.1.30
* Other : PHP 5.2.12

WordPressのバージョンは「2.9.1-ja」です。

== インストール ==

MySQL, Apacheのインストール方法は[[MediaWiki/導入手順]]と同一です。

=== PHP ===

入手先 : http://www.php.net/

$ tar jxvf php-5.2.12.tar.bz2
$ cd php-5.2.12
$ ./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-mysql --with-curl --with-zlib
$ make
# make install
# cp php.ini-dist /usr/local/lib/php.ini

curlとzlibは、WordPressで使用するため有効としました。これらのライブラリは、プラグイン自動更新に必要となります。

=== WordPress ===

入手先 : http://ja.wordpress.org/

# unzip wordpress-2.9.1-ja.zip -d /usr/local/apache2/htdocs/
# cd /usr/local/apache2/htdocs/
# chown daemon.daemon wordpress -R

daemonはApacheを動作させるユーザ名とグループ名です。

== 設定 ==

MySQL, Apacheの設定は[[MediaWiki/導入手順]]と同一です。

=== WordPress ===
MediaWikiのページへWebブラウザを使用してアクセスし、初期設定を実行します。初期設定を行うためには、MySQLとApacheが起動している必要があります。初期設定の詳細は省略します。

== 起動 ==

MySQL, Apacheの起動方法は[[MediaWiki/導入手順]]と同一です。

== 更新履歴 ==

*2010/01/10
**ページ作成

MediaWikiの導入手順

2014-10-13T15:57:06Z

Admin: /* メモ */

[[Category:導入手順]][[Category:CMS]]
本ページでは、ウィキソフトウェアである「MediaWiki」の導入手順を記述します。

== 環境 ==
* OS : CentOS 5.2
* Web Server : Apache 2.2.11
* Database : MySQL 5.1.30
* Other : PHP 5.2.8

== インストール ==
=== MySQL ===

入手先 :http://www.mysql.com/

$ tar zxvf mysql-5.1.30.tar.gz
$ cd mysql-5.1.30
$ ./configure
$ make
# make install
# /usr/local/bin/mysql_install_db --user=<ユーザ名>
# /usr/local/bin/mysqld_safe --user=<ユーザ名> &
# /usr/local/bin/mysqladmin -u root password <パスワード>

=== Apache ===

入手先 : http://httpd.apache.org/

$ tar jxvf httpd-2.2.11.tar.bz2
$ cd httpd-2.2.11
$ ./configure
$ make
# make install

=== PHP ===

入手先 : http://www.php.net/

$ tar jxvf php-5.2.8.tar.bz2
$ cd php-5.2.8
$ ./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-mysql
$ make
# make install
# cp php.ini-dist /usr/local/lib/php.ini

=== MediaWiki ===

入手先 : http://www.mediawiki.org/wiki/MediaWiki

$ tar zxvf mediawiki-1.13.4.tar.gz
# mv mediawiki-1.13.4/* /usr/local/apache2/htdocs/

== 設定 ==

=== Apache ===
ApacheにてPHPの設定を行う。「httpd.conf」を下記のように編集します。
# DirectoryIndex index.html
DirectoryIndex index.html index.php index.php5

AddType application/x-httpd-php .php .phtml .php5
AddType application/x-httpd-php-source .phps

Alias /w/index.php /usr/local/apache2/htdocs/w/index.php
Alias /wiki /usr/local/apache2/htdocs/w/index.php
Alias /index.php /usr/local/apache2/htdocs/w/index.php

Memo: 2014/10/13 Alias 設定が抜けていたので追記しました。

下記設定は必須ではありませんが、セキュリティ上の理由から変更します。

<Directory "/usr/local/apache2/htdocs">
# Options Indexes FollowSymLinks
Options FollowSymLinks

=== MySQL ===
データベースアクセス用のアカウントに権限を付与する。

$ mysql -u root -p

mysql> grant all privileges on *.* to wikiuser@localhost identified by '<パスワード>' with grant option;

=== MediaWiki ===
MediaWikiの初期設定を行うため、下記コマンドを実行します。初期設定を行うためには、MySQLとApacheが起動している必要がああります。
# chmod a+w config

MediaWikiのページへWebブラウザを使用してアクセスし、初期設定を実行します。初期設定の詳細は省略します。初期設定が終了したら、「config/LocalSettings.php」ファイルを1階層上のディレクトリ（/usr/local/apache2/htdocs）に移動します。

設定完了後、「config」ディレクトリは不要であるため、削除します。

「LocalSettings.php」を必要に応じて修正します。下記は、ロゴを消去し、管理者以外の権限をWikiページ読み取り専用にする設定です。

<source lang="php">
$wgLogo = "";
$wgGroupPermissions['*']['createaccount'] = false;
$wgGroupPermissions['*']['edit'] = false;
$wgGroupPermissions['*']['createpage'] = false;
$wgGroupPermissions['*']['createtalk'] = false;
$wgGroupPermissions['*']['writeapi'] = false;
</source>

「$wgGroupPermissions」の仕様については、下記URLを参照してください。

''Manual:User rights : http://www.mediawiki.org/wiki/Manual:User_rights''

== 起動 ==

=== MySQL ===

# /usr/local/bin/mysqld_safe --user=<ユーザ名> &

=== Apache ===

/usr/local/apache2/bin/apachectl start

== トラブルシューティング ==

=== Apache起動時に「libphp5.so: undefined symbol: OnUpdateLong」が表示される ===

'''※PHP5.3.4のみ確認できたエラーです'''

<source lang="bash">
# bin/apachectl start
httpd: Syntax error on line 53 of /usr/local/apache2/conf/httpd.conf: Cannot load /usr/local/apache2/modules/libphp5.so into server: /usr/local/apache2/modules/libphp5.so: undefined symbol: OnUpdateLong
</source>

make clean後、再度configureからやり直したらエラーは消えました。原因は、configureが完了しないままmakeしたためである想定します。

== 付録 ==
PostgreSQLの導入手順を下記に示します。バージョン8.3.5では、日本語検索ができないという問題があります。（ただし、ソースコードの変更やDBファンクションの追加で対応可能という情報有り）

[[導入手順:MediaWiki/PostgreSQL]]

== メモ ==

=== MySQL 5.5系 ===

MySQL 5.5.8では、configureがcmakeに変更されています。

phpのconfigureを

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-mysql=/usr/local/mysql

とする必要有

== 参考 ==
*http://www.postgresql.org/ftp/source/v8.3.5/
*http://www.mediawiki.org/wiki/Download/ja
*MediaWiki / Daniel J. Barrett / ISBN : 978-0-596-51979-7

== 更新履歴 ==

*2009/02/22
**ページ作成
*2014/10/13
**Apache Alias 設定が抜けていたので追記しました。

MediaWikiのアップグレード手順

2014-10-13T14:41:59Z

Admin: /* 補足 */

[[Category:導入手順]][[Category:CMS]]
バージョン1.15.1へのアップグレード手順を示します。

== 手順 ==

=== DBとWebのデータをバックアップする ===
DBバックアップコマンド例

mysqldump -u <MYSQL_USER> -p <DB_NAME> > <DUMP_NAME>

=== Apacheを終了する ===
終了は必須ではありませんが、トラブル防止のために実施しました。

=== 新たなMediaWikiのアーカイブファイルを既存ディレクトリに上書きする ===
コマンド例

tar zxvf mediawiki-1.15.1.tar.gz -C <APACHE_HOME>/htdocs/ --strip-components=1

=== AdminSettings.phpをコマンドラインから実行する（1.15.1 の場合） ===
AdminSettings.phpは、ブラウザから実行できません。

コマンド例（maintenanceディレクトリに移動してください）
$ php update.php --aconf ../AdminSettings.php

エラーメッセージが出る場合は、AdminSettings.phpの設定が不適切であるかもしれません。

=== update.phpをコマンドラインから実行する（1.23.5 の場合） ===

ver 1.16.0 -> 1.23.5 にアップグレードを行いましたが、以前とアップグレード用ファイルが変更されていました。

cd /usr/local/apache2/htdocs/w/
php maintenance/update.php

関係ないですが、ページ編集時、Draft extention がエラーとなってしまい、処理続行できなかったので、コメントアウトしました。アップグレードが必要かも。

=== Apacheを起動する ===

== 補足 ==

=== ver 1.16.0 -> 1.23.5 にアップグレード時の注意事項 ===

公式サイトに記載はありますが、念のため備忘として残します。

==== Profilerのエラー ====

【事象】

ページアクセス時、下記のエラーが出る。操作一切不可。

Fatal error: Cannot redeclare wfProfileIn() (previously declared in /usr/local/apache2/htdocs/w/includes/profiler/Profiler.php:33) in /usr/local/apache2/htdocs/w/includes/ProfilerStub.php on line 24

【対処】

ファイルを移動。

/usr/local/apache2/htdocs/w/
mv StartProfiler.php StartProfiler.orig.php

Profilerが何なのかは知りません。

==== skinのエラー ====

【事象】

画面上部に、常に下記の Warning が出る。

Warning: A skin using autodiscovery mechanism, MySkin, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

Warning: A skin using autodiscovery mechanism, Simple, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

Warning: A skin using autodiscovery mechanism, Chick, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

Warning: A skin using autodiscovery mechanism, KindofBlue, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

Warning: A skin using autodiscovery mechanism, Standard, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

Warning: A skin using autodiscovery mechanism, Nostalgia, was found in your skins/ directory. The mechanism will be removed in MediaWiki 1.25 and the skin will no longer be recognized. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for information how to fix this. [Called from Skin::getSkinNames in /usr/local/apache2/htdocs/w/includes/Skin.php at line 74] in /usr/local/apache2/htdocs/w/includes/debug/Debug.php on line 303

【対処】

現状の skins フォルダを消して、新規の skins フォルダを上書き。

当サイトは、スキンは vector しか使用していないので、これで問題なし。skin の仕様変更があったようだが、詳細は知らない。

==== 「特別:最近の更新」にアクセスできない ====

ver 1.16.0 -> 1.23.5 にアップグレード後、[[特別:最近の更新]] を開こうとすると、画面が真っ白となり、apache の error_log に

Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate 2147483648 bytes) in /usr/local/apache2/htdocs/w/includes/User.php on line 2439

のようなログが表示される。php のメモリ割り当てが少ないのかと思い、php.ini の「memory_limit = 128M」を徐々に上げていったが、解決しなかった。

試しに、php のバージョンを 5.3 系の最新版である、5.3.29 に挙げてみたらエラーが解消された。根本原因は謎。（エラー発生時は、5.3.6 を使用していた）

== 参考 ==
*http://www.mediawiki.org/wiki/Manual:Upgrading_MediaWiki

== 更新履歴 ==
*2014/10/13
**ver 1.23.5 へのアップグレードの記述を追記
*2010/01/10
**ページ作成

メインページ

2014-10-13T09:52:43Z

Admin: /* 更新履歴 */

ここは、ソフトウェア開発に関する個人的なメモを残すサイトです。

2011年2月17日より、サイト名を「Open Source Memo」から「Software Development Memo」に変更しました。変更の理由は、サイト運用開始時と異なり、コンテンツの割合がオープンソースソフトウェア以外も増えてきたためです。

== リンク ==
*[http://twitter.com/#!/pandakojirou Twitter]
*[http://www.osmemo.info/blog/ Open Source Memo – blog版 -（更新停止）]
*[http://www.osmemo.info/wiki_old/ 2009/03/01以前のアーカイブ]

== ページ全体の更新履歴 ==

個別コンテンツの更新履歴は、メニューの [[特別:最近の更新]] を参照下さい。

*2014/10/13
**MediaWiki のバージョンを 1.23.5 にアップグレード
**WordPress のバージョンを 4.0 にアップグレード（もう更新していませんが）
*2011/02/17
**サイト名を「Open Source Memo」から「Software Development Memo」に変更
**URLを「[http://www.osmemo.info/ http://www.osmemo.info/]」から「[http://www.sdmemo.com/ http://www.sdmemo.com/]」に変更
*2010/11/28
**MediaWikiのバージョンを1.16.0にアップグレード
**スキンをmonobookからvectorに変更
*2010/01/10
**MediaWikiのバージョンを1.15.1にアップグレード
*2009/12/13
**wikiのアドレスにShort URLを採用

----

管理用 : [[特別:Upload]], [[MediaWiki:Sidebar]], [[Sandbox]], [[:Category:下書き]]

MediaWikiのアップグレード手順

2014-10-13T09:47:09Z

Admin:

MediaWikiのアップグレード手順

2014-10-13T09:44:01Z

Admin:

MediaWikiのアップグレード手順

2014-10-13T09:35:15Z

Admin: /* 更新履歴 */

MediaWikiのアップグレード手順

2014-10-13T09:34:33Z

Admin: /* update.phpをコマンドラインから実行する（1.23.5 の場合） */

MediaWikiのアップグレード手順

2014-10-13T09:33:51Z

Admin: /* AdminSettings.phpをコマンドラインから実行する */

MediaWikiの導入手順

2014-10-13T07:42:57Z

Admin:

[[Category:導入手順]][[Category:CMS]]
本ページでは、ウィキソフトウェアである「MediaWiki」の導入手順を記述します。

== 環境 ==
* OS : CentOS 5.2
* Web Server : Apache 2.2.11
* Database : MySQL 5.1.30
* Other : PHP 5.2.8

== インストール ==
=== MySQL ===

入手先 :http://www.mysql.com/

$ tar zxvf mysql-5.1.30.tar.gz
$ cd mysql-5.1.30
$ ./configure
$ make
# make install
# /usr/local/bin/mysql_install_db --user=<ユーザ名>
# /usr/local/bin/mysqld_safe --user=<ユーザ名> &
# /usr/local/bin/mysqladmin -u root password <パスワード>

=== Apache ===

入手先 : http://httpd.apache.org/

$ tar jxvf httpd-2.2.11.tar.bz2
$ cd httpd-2.2.11
$ ./configure
$ make
# make install

=== PHP ===

入手先 : http://www.php.net/

$ tar jxvf php-5.2.8.tar.bz2
$ cd php-5.2.8
$ ./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-mysql
$ make
# make install
# cp php.ini-dist /usr/local/lib/php.ini

=== MediaWiki ===

入手先 : http://www.mediawiki.org/wiki/MediaWiki

$ tar zxvf mediawiki-1.13.4.tar.gz
# mv mediawiki-1.13.4/* /usr/local/apache2/htdocs/

== 設定 ==

=== Apache ===
ApacheにてPHPの設定を行う。「httpd.conf」を下記のように編集します。
# DirectoryIndex index.html
DirectoryIndex index.html index.php index.php5

AddType application/x-httpd-php .php .phtml .php5
AddType application/x-httpd-php-source .phps

Alias /w/index.php /usr/local/apache2/htdocs/w/index.php
Alias /wiki /usr/local/apache2/htdocs/w/index.php
Alias /index.php /usr/local/apache2/htdocs/w/index.php

Memo: 2014/10/13 Alias 設定が抜けていたので追記しました。

下記設定は必須ではありませんが、セキュリティ上の理由から変更します。

<Directory "/usr/local/apache2/htdocs">
# Options Indexes FollowSymLinks
Options FollowSymLinks

=== MySQL ===
データベースアクセス用のアカウントに権限を付与する。

$ mysql -u root -p

mysql> grant all privileges on *.* to wikiuser@localhost identified by '<パスワード>' with grant option;

=== MediaWiki ===
MediaWikiの初期設定を行うため、下記コマンドを実行します。初期設定を行うためには、MySQLとApacheが起動している必要がああります。
# chmod a+w config

MediaWikiのページへWebブラウザを使用してアクセスし、初期設定を実行します。初期設定の詳細は省略します。初期設定が終了したら、「config/LocalSettings.php」ファイルを1階層上のディレクトリ（/usr/local/apache2/htdocs）に移動します。

設定完了後、「config」ディレクトリは不要であるため、削除します。

「LocalSettings.php」を必要に応じて修正します。下記は、ロゴを消去し、管理者以外の権限をWikiページ読み取り専用にする設定です。

<source lang="php">
$wgLogo = "";
$wgGroupPermissions['*']['createaccount'] = false;
$wgGroupPermissions['*']['edit'] = false;
$wgGroupPermissions['*']['createpage'] = false;
$wgGroupPermissions['*']['createtalk'] = false;
$wgGroupPermissions['*']['writeapi'] = false;
</source>

「$wgGroupPermissions」の仕様については、下記URLを参照してください。

''Manual:User rights : http://www.mediawiki.org/wiki/Manual:User_rights''

== 起動 ==

=== MySQL ===

# /usr/local/bin/mysqld_safe --user=<ユーザ名> &

=== Apache ===

/usr/local/apache2/bin/apachectl start

== トラブルシューティング ==

=== Apache起動時に「libphp5.so: undefined symbol: OnUpdateLong」が表示される ===

'''※PHP5.3.4のみ確認できたエラーです'''

<source lang="bash">
# bin/apachectl start
httpd: Syntax error on line 53 of /usr/local/apache2/conf/httpd.conf: Cannot load /usr/local/apache2/modules/libphp5.so into server: /usr/local/apache2/modules/libphp5.so: undefined symbol: OnUpdateLong
</source>

make clean後、再度configureからやり直したらエラーは消えました。原因は、configureが完了しないままmakeしたためである想定します。

== 付録 ==
PostgreSQLの導入手順を下記に示します。バージョン8.3.5では、日本語検索ができないという問題があります。（ただし、ソースコードの変更やDBファンクションの追加で対応可能という情報有り）

[[導入手順:MediaWiki/PostgreSQL]]

== メモ ==

* MySQL 5.5.8では、configureがcmakeに変更されています。 -- 2011年1月1日 (土) 22:56 (JST)
** phpのconfigureを「./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-mysql=/usr/local/mysql」とする必要有

== 参考 ==
*http://www.postgresql.org/ftp/source/v8.3.5/
*http://www.mediawiki.org/wiki/Download/ja
*MediaWiki / Daniel J. Barrett / ISBN : 978-0-596-51979-7

== 更新履歴 ==

*2009/02/22
**ページ作成
*2014/10/13
**Apache Alias 設定が抜けていたので追記しました。

CDIメモ

2013-06-29T17:13:09Z

Admin:

{{Stub}}

[[Category:ソフトウェア開発]] [[Category:Java]]

JSR 299で定義されているCDIのサンプルコードです。CDIに関する日本語のドキュメントが無いので、作成してみようと思った次第です。

== 環境 ==

* GlassFish : 3.1.2
* OS : Windows 8
* Java : 1.6

== シンプルなCDIサンプル ==

=== 呼び出し側 ===

<source lang="java">
package tmp;

import java.io.IOException;

import javax.inject.Inject;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@WebServlet("/Main00")
public class Main00 extends HttpServlet {

@Inject
private CdiTest cdi;

@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
cdi.hello();
}
}
</source>

=== Injectionクラス ===

<source lang="java">
package tmp;

public class CdiTest {

public CdiTest() {
System.out.println("init.");
}

public void hello() {
System.out.println("hello.");
}

}
</source>

=== 実行結果 ===

以下、ブラウザでサーブレットを複数回呼び出したときのログです。

<source lang="text">
情報: init.
情報: hello.

情報: hello.

情報: hello.

情報: hello.
</source>

サーブレット初回コール時に、CdiTestのコンストラクタが呼ばれ、インスタンスが使い回しされます。

== @Produces を使用したサンプル ==

@Produces アノテーションを使用すると、インスタンスを取得するためのメソッドを指定できます。

=== サンプルコード ===

<source lang="java">
package tmp;

import javax.enterprise.inject.Produces;

public class Producer {

@Produces
public static CdiTest getCdiTest() {
System.out.println("factory method has called.");
return new CdiTest();
}
}
</source>

CdiTest クラスには @Any アノテーションを付与します。

<source lang="java">
package tmp;

import javax.enterprise.inject.Any;

@Any
public class CdiTest {

public CdiTest() {
System.out.println("init.");
}

public void hello() {
System.out.println("hello.");
}

}

</source>

=== 実行結果 ===

<source lang="text">
情報: factory method has called.
情報: init.
情報: hello.

情報: hello.

情報: hello.
</source>

== @Qualifier を使用してインジェクションを行うメソッドを指定 ==

@Qualifier アノテーションを付与したアノテーションを定義することで、インジェクションを行うメソッドを指定することができます。

=== サンプルコード ===

アノテーション @A01 を作成します。

<source lang="java">
package tmp;

import java.lang.annotation.Retention;
import java.lang.annotation.Target;

import javax.inject.Qualifier;
import static java.lang.annotation.RetentionPolicy.RUNTIME;
import static java.lang.annotation.ElementType.TYPE;
import static java.lang.annotation.ElementType.METHOD;
import static java.lang.annotation.ElementType.FIELD;
import static java.lang.annotation.ElementType.PARAMETER;

@Qualifier
@Retention(RUNTIME)
@Target({TYPE, METHOD, FIELD, PARAMETER})
public @interface A01 {}

</source>

次に、アノテーション @A02 を作成します。

<source lang="java">
package tmp;

import java.lang.annotation.Retention;
import java.lang.annotation.Target;

import javax.inject.Qualifier;
import static java.lang.annotation.RetentionPolicy.RUNTIME;
import static java.lang.annotation.ElementType.TYPE;
import static java.lang.annotation.ElementType.METHOD;
import static java.lang.annotation.ElementType.FIELD;
import static java.lang.annotation.ElementType.PARAMETER;

@Qualifier
@Retention(RUNTIME)
@Target({TYPE, METHOD, FIELD, PARAMETER})
public @interface A02 {}
</source>

作成したアノテーション @A01 と @A02 を使用して、オブジェクトの初期化方法を定義する。

<source lang="java">
package tmp;

import javax.enterprise.inject.Produces;

public class Producer {

@Produces @A01
public static CdiTest getCdiTest() {
System.out.println("A01");
return new CdiTest();
}

@Produces @A02
public static CdiTest getCdiTest2() {
System.out.println("A02");
return new CdiTest();
}
}
</source>

インジェクションをする例、@Inject @A01 と指定することで、Producer#getCdiTest が呼ばれるようになります。

<source lang="java">
package tmp;

import java.io.IOException;

import javax.inject.Inject;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@WebServlet("/Main00")
public class Main00 extends HttpServlet {

@Inject @A01
private CdiTest cdi;

@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
cdi.hello();
}
}
</source>

=== 実行結果 ===

<source lang="text">
情報: A01
情報: init.
情報: hello.

情報: hello.

情報: hello.
</source>

== 更新履歴 ==

* 仮ページ作成 -- 2013年6月30日 (日) 01:51 (JST)

CDIメモ

2013-06-29T17:12:07Z

Admin: /* サンプルコード */

{{Stub}}

[[Category:ソフトウェア開発]] [[Category:Java]]

JSR 299で定義されているCDIのサンプルコードです。CDIに関する日本語のドキュメントが無いので、作成してみようと思った次第です。

== 環境 ==

* GlassFish : 3.1.2

== シンプルなCDIサンプル ==

=== 呼び出し側 ===

<source lang="java">
package tmp;

import java.io.IOException;

import javax.inject.Inject;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@WebServlet("/Main00")
public class Main00 extends HttpServlet {

@Inject
private CdiTest cdi;

@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
cdi.hello();
}
}
</source>

=== Injectionクラス ===

<source lang="java">
package tmp;

public class CdiTest {

public CdiTest() {
System.out.println("init.");
}

public void hello() {
System.out.println("hello.");
}

}
</source>

=== 実行結果 ===

以下、ブラウザでサーブレットを複数回呼び出したときのログです。

<source lang="text">
情報: init.
情報: hello.

情報: hello.

情報: hello.

情報: hello.
</source>

サーブレット初回コール時に、CdiTestのコンストラクタが呼ばれ、インスタンスが使い回しされます。

== @Produces を使用したサンプル ==

@Produces アノテーションを使用すると、インスタンスを取得するためのメソッドを指定できます。

=== サンプルコード ===

<source lang="java">
package tmp;

import javax.enterprise.inject.Produces;

public class Producer {

@Produces
public static CdiTest getCdiTest() {
System.out.println("factory method has called.");
return new CdiTest();
}
}
</source>

CdiTest クラスには @Any アノテーションを付与します。

<source lang="java">
package tmp;

import javax.enterprise.inject.Any;

@Any
public class CdiTest {

public CdiTest() {
System.out.println("init.");
}

public void hello() {
System.out.println("hello.");
}

}

</source>

=== 実行結果 ===

<source lang="text">
情報: factory method has called.
情報: init.
情報: hello.

情報: hello.

情報: hello.
</source>

== @Qualifier を使用してインジェクションを行うメソッドを指定 ==

@Qualifier アノテーションを付与したアノテーションを定義することで、インジェクションを行うメソッドを指定することができます。

=== サンプルコード ===

アノテーション @A01 を作成します。

<source lang="java">
package tmp;

import java.lang.annotation.Retention;
import java.lang.annotation.Target;

import javax.inject.Qualifier;
import static java.lang.annotation.RetentionPolicy.RUNTIME;
import static java.lang.annotation.ElementType.TYPE;
import static java.lang.annotation.ElementType.METHOD;
import static java.lang.annotation.ElementType.FIELD;
import static java.lang.annotation.ElementType.PARAMETER;

@Qualifier
@Retention(RUNTIME)
@Target({TYPE, METHOD, FIELD, PARAMETER})
public @interface A01 {}

</source>

次に、アノテーション @A02 を作成します。

<source lang="java">
package tmp;

import java.lang.annotation.Retention;
import java.lang.annotation.Target;

import javax.inject.Qualifier;
import static java.lang.annotation.RetentionPolicy.RUNTIME;
import static java.lang.annotation.ElementType.TYPE;
import static java.lang.annotation.ElementType.METHOD;
import static java.lang.annotation.ElementType.FIELD;
import static java.lang.annotation.ElementType.PARAMETER;

@Qualifier
@Retention(RUNTIME)
@Target({TYPE, METHOD, FIELD, PARAMETER})
public @interface A02 {}
</source>

作成したアノテーション @A01 と @A02 を使用して、オブジェクトの初期化方法を定義する。

<source lang="java">
package tmp;

import javax.enterprise.inject.Produces;

public class Producer {

@Produces @A01
public static CdiTest getCdiTest() {
System.out.println("A01");
return new CdiTest();
}

@Produces @A02
public static CdiTest getCdiTest2() {
System.out.println("A02");
return new CdiTest();
}
}
</source>

インジェクションをする例、@Inject @A01 と指定することで、Producer#getCdiTest が呼ばれるようになります。

<source lang="java">
package tmp;

import java.io.IOException;

import javax.inject.Inject;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@WebServlet("/Main00")
public class Main00 extends HttpServlet {

@Inject @A01
private CdiTest cdi;

@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
cdi.hello();
}
}
</source>

=== 実行結果 ===

<source lang="text">
情報: A01
情報: init.
情報: hello.

情報: hello.

情報: hello.
</source>

== 更新履歴 ==

* 仮ページ作成 -- 2013年6月30日 (日) 01:51 (JST)

CDIメモ

2013-06-29T17:11:48Z

Admin: /* 実行結果 */

{{Stub}}

[[Category:ソフトウェア開発]] [[Category:Java]]

JSR 299で定義されているCDIのサンプルコードです。CDIに関する日本語のドキュメントが無いので、作成してみようと思った次第です。

== 環境 ==

* GlassFish : 3.1.2

== シンプルなCDIサンプル ==

=== 呼び出し側 ===

<source lang="java">
package tmp;

import java.io.IOException;

import javax.inject.Inject;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@WebServlet("/Main00")
public class Main00 extends HttpServlet {

@Inject
private CdiTest cdi;

@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
cdi.hello();
}
}
</source>

=== Injectionクラス ===

<source lang="java">
package tmp;

public class CdiTest {

public CdiTest() {
System.out.println("init.");
}

public void hello() {
System.out.println("hello.");
}

}
</source>

=== 実行結果 ===

以下、ブラウザでサーブレットを複数回呼び出したときのログです。

<source lang="text">
情報: init.
情報: hello.

情報: hello.

情報: hello.

情報: hello.
</source>

サーブレット初回コール時に、CdiTestのコンストラクタが呼ばれ、インスタンスが使い回しされます。

== @Produces を使用したサンプル ==

@Produces アノテーションを使用すると、インスタンスを取得するためのメソッドを指定できます。

=== サンプルコード ===

<source lang="java">
package tmp;

import javax.enterprise.inject.Produces;

public class Producer {

@Produces
public static CdiTest getCdiTest() {
System.out.println("factory method has called.");
return new CdiTest();
}
}
</source>

CdiTest クラスには @Any アノテーションを付与します。

<source lang="java">
package tmp;

import javax.enterprise.inject.Any;

@Any
public class CdiTest {

public CdiTest() {
System.out.println("init.");
}

public void hello() {
System.out.println("hello.");
}

}

</source>

=== 実行結果 ===

<source lang="text">
情報: factory method has called.
情報: init.
情報: hello.

情報: hello.

情報: hello.
</source>

== @Qualifier を使用してインジェクションを行うメソッドを指定 ==

@Qualifier アノテーションを付与したアノテーションを定義することで、インジェクションを行うメソッドを指定することができます。

== サンプルコード ==

アノテーション @A01 を作成します。

<source lang="java">
package tmp;

import java.lang.annotation.Retention;
import java.lang.annotation.Target;

import javax.inject.Qualifier;
import static java.lang.annotation.RetentionPolicy.RUNTIME;
import static java.lang.annotation.ElementType.TYPE;
import static java.lang.annotation.ElementType.METHOD;
import static java.lang.annotation.ElementType.FIELD;
import static java.lang.annotation.ElementType.PARAMETER;

@Qualifier
@Retention(RUNTIME)
@Target({TYPE, METHOD, FIELD, PARAMETER})
public @interface A01 {}

</source>

次に、アノテーション @A02 を作成します。

<source lang="java">
package tmp;

import java.lang.annotation.Retention;
import java.lang.annotation.Target;

import javax.inject.Qualifier;
import static java.lang.annotation.RetentionPolicy.RUNTIME;
import static java.lang.annotation.ElementType.TYPE;
import static java.lang.annotation.ElementType.METHOD;
import static java.lang.annotation.ElementType.FIELD;
import static java.lang.annotation.ElementType.PARAMETER;

@Qualifier
@Retention(RUNTIME)
@Target({TYPE, METHOD, FIELD, PARAMETER})
public @interface A02 {}
</source>

作成したアノテーション @A01 と @A02 を使用して、オブジェクトの初期化方法を定義する。

<source lang="java">
package tmp;

import javax.enterprise.inject.Produces;

public class Producer {

@Produces @A01
public static CdiTest getCdiTest() {
System.out.println("A01");
return new CdiTest();
}

@Produces @A02
public static CdiTest getCdiTest2() {
System.out.println("A02");
return new CdiTest();
}
}
</source>

インジェクションをする例、@Inject @A01 と指定することで、Producer#getCdiTest が呼ばれるようになります。

<source lang="java">
package tmp;

import java.io.IOException;

import javax.inject.Inject;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@WebServlet("/Main00")
public class Main00 extends HttpServlet {

@Inject @A01
private CdiTest cdi;

@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
cdi.hello();
}
}
</source>

=== 実行結果 ===

<source lang="text">
情報: A01
情報: init.
情報: hello.

情報: hello.

情報: hello.
</source>

== 更新履歴 ==

* 仮ページ作成 -- 2013年6月30日 (日) 01:51 (JST)

CDIメモ

2013-06-29T17:01:51Z

Admin: /* 更新履歴 */

CDIメモ

2013-06-29T16:51:27Z

Admin: ページの作成: {{Stub}} Category:ソフトウェア開発 Category:Java JSR 299で定義されているCDIのサンプルコードです。CDIに関する日本語のドキュメン...

MySQL 5.5の導入手順

2012-11-14T08:41:33Z

Admin: /* MySQL */

[[Category:ソフトウェア開発]][[Category:導入手順]]

{{Stub}}

MySQLのバージョンが5.5になり、5.1の時と比較して導入手順に若干変化があったため改めて導入手順を記述します。

== 環境 ==

* OS : CentOS 6.3 x86-64
* Web Server : Apache 2.2.17
* Database : MySQL 5.1.54

== インストール ==

=== CMake ===

バージョン5.5よりビルドツールにCMakeを使用するようになったため、追加でインストールします。

yum -y install cmake

=== ncurses-devel===

MySQLインストール時に必要なライブラリをインストールします。

yum -y install ncurses-devel

=== MySQL ===

入手先 : http://www-jp.mysql.com/downloads/mysql/

<source lang="text">
$ tar zvxf mysql-5.5.28.tar.gz
$ cd mysql-5.5.28
$ cmake .
$ make
# make install
</source>

== 設定 ==

=== MySQL ===

ユーザ「mysql」を作成し、DBを初期化します。

MySQLのバイナリにパスを通すため、「/etc/bashrc」に以下を追記します。

export PATH=$PATH:/usr/local/mysql/bin

ユーザ「mysql」を作成し、DBを初期化します。

<source lang="text">
# /usr/sbin/useradd mysql
# cd /usr/local/mysql/
# scripts/mysql_install_db --user=mysql
</source>

pidファイルを配置るためのフォルダを作成します。

<source lang="text">
# mkdir /var/run/mysqld
# chown mysql.mysql /var/run/mysqld
</source>

DBを起動し、rootのパスワードを設定します。

<source lang="text">
# mysqld_safe --user=mysql &
# mysqladmin -u root password <password>
</source>

ユーザーを作成します。ここでは、ネットワーク経由でDBにアクセスするために、「"%"」としています。

<source lang="sql">
mysql> GRANT ALL privileges ON *.* TO <username>@"%" IDENTIFIED BY 'rootroot' WITH GRANT OPTION;
</source>

== 更新履歴 ==
* ページ作成 -- 2012年11月13日 (火) 20:15 (JST)

Subversion,Apacheの導入手順

2012-11-13T12:59:12Z

Admin:

[[Category:ソフトウェア開発]]

このページは、HTTP経由でSubversionを使用するための手順を記述します。内容は、[[Review Boardの導入手順]]の内容を抜き出して、多少修正したものです。

== 環境 ==

* OS : CentOS 6.2
* Apache : 2.2.17
* Subversion : 1.6.15

== インストール ==

=== Apache ===

入手先 : http://httpd.apache.org/

<source lang="text">
$ tar zxvf httpd-2.2.17.tar.gz
$ cd httpd-2.2.17
$ ./configure --enable-dav
$ make
# make install
</source>

「--enable-dav」はSubversionインストール時に導入されるモジュール「dav_svn_module」を動作させるために必要です。

=== neon ===

Subversionのコマンドでhttpスキームを使用するために必要なライブラリであるneonをインストールします。svnコマンドでhttpスキーム（「svn co http://」等）を使用しない場合は、インストール不要です。

入手先 : http://www.webdav.org/neon/

<source lang="text">
$ tar zxvf neon-0.29.5.tar.gz
$ cd neon-0.29.5
$ ./configure
$ make
# make install
</source>

=== SQLite Amalgamation ===

Subversionのビルドに必要となるSQLiteのソースコードをダウンロードします。

入手先 : http://www.sqlite.org/sqlite-amalgamation-3.6.13.tar.gz

=== Subversion ===

入手先 : http://subversion.tigris.org/

<source lang="text">
$ tar jxvf subversion-1.6.15.tar.bz2
$ tar zxvf sqlite-amalgamation-3.6.13.tar.gz
$ mv sqlite-3.6.13/ subversion-1.6.15/sqlite-amalgamation
$ cd subversion-1.6.15
$ ./configure
$ make
# make install
</source>

== 設定 ==

=== Apache ===

「/usr/local/apache2/conf/httpd.conf」を編集します。

<source lang="text">
LoadModule dav_svn_module modules/mod_dav_svn.so
LoadModule authz_svn_module modules/mod_authz_svn.so

<Location "/svn/test/test01">
DAV svn
SVNPath /var/lib/svn/test/test01
AuthzSVNAccessFile /usr/local/apache2/conf/svn.authz
AuthType Basic
AuthName "Subversion Repository"
AuthUserFile /usr/local/apache2/conf/.htpasswd
Require valid-user
</Location>
</source>

=== svn.authz ===

アクセス制御ファイルを「/usr/local/apache2/conf/svn.authz」に作成します。

<source lang="text">
[groups]
admin = user01

[/]
@admin = rw
</source>

=== .htpasswd ===

ApacheのBasic認証ファイルを「/usr/local/apache2/conf/.htpasswd」に作成します。

# /usr/local/apache2/bin/htpasswd -c /usr/local/apache2/conf/.htpasswd user01
New password:
Re-type new password:
Adding password for user user01

=== リポジトリ作成 ===

Subversionリポジトリを作成します。リポジトリのパーミッションはApacheの実行ユーザー（初期値ではdaemon）とします。

# mkdir -p /var/lib/svn/test/test01
# cd /var/lib/svn/test/test01
# svnadmin create .
# chown daemon.daemon /var/lib/svn/ -R

== 起動 ==

=== Apache ===

# /usr/local/apache2/bin/apachectl start

Apache起動後、「http://<Apacheのホスト名>/svn/test/test01/」でチェックアウトできれば設定完了です。

== 更新履歴 ==

* ページ作成 -- 2012年3月4日 (日) 16:44 (JST)

MySQL 5.5の導入手順

2012-11-13T11:15:40Z

Admin: /* MySQL */

[[Category:ソフトウェア開発]][[Category:導入手順]]

{{Stub}}

MySQLのバージョンが5.5になり、5.1の時と比較して導入手順に若干変化があったため改めて導入手順を記述します。

== 環境 ==

* OS : CentOS 6.3 x86-64
* Web Server : Apache 2.2.17
* Database : MySQL 5.1.54

== インストール ==

=== CMake ===

バージョン5.5よりビルドツールにCMakeを使用するようになったため、追加でインストールします。

yum -y install cmake

=== ncurses-devel===

MySQLインストール時に必要なライブラリをインストールします。

yum -y install ncurses-devel

=== MySQL ===

入手先 : http://www-jp.mysql.com/downloads/mysql/

<source lang="text">
$ tar zvxf mysql-5.5.28.tar.gz
$ cd mysql-5.5.28
$ cmake .
$ make
# make install
</source>

== 設定 ==

=== MySQL ===

ユーザ「mysql」を作成し、DBを初期化します。

MySQLのバイナリにパスを通すため、「/etc/bashrc」に以下を追記します。

export PATH=$PATH:/usr/local/mysql/bin

ユーザ「mysql」を作成し、DBを初期化します。

<source lang="text">
# /usr/sbin/useradd mysql
# cd /usr/local/mysql/
# scripts/mysql_install_db --user=mysql
</source>

pidファイルを配置るためのフォルダを作成します。

<source lang="text">
# mkdir /var/run/mysqld
# chown mysql.mysql /var/run/mysqld
</source>

DBを起動し、rootのパスワードを設定します。
socketオプションを指定しないと「/var/lib/mysql/mysql.sock」にファイルを生成し、mysqlコマンド実行時にソケットの認識ができずにエラーとなるので、オプションで指定します。

<source lang="text">
# mysqld_safe --user=mysql --socket=/tmp/mysql.sock &
# mysqladmin -u root password <password>
</source>

ユーザーを作成します。ここでは、ネットワーク経由でDBにアクセスするために、「"%"」としています。

<source lang="sql">
mysql> GRANT ALL privileges ON *.* TO <username>@"%" IDENTIFIED BY 'rootroot' WITH GRANT OPTION;
</source>

== 更新履歴 ==
* ページ作成 -- 2012年11月13日 (火) 20:15 (JST)

MySQL 5.5の導入手順

2012-11-12T15:31:38Z

Admin: /* MySQL */

MySQL 5.5の導入手順

2012-11-12T15:26:19Z

Admin: ページの作成: Category:ソフトウェア開発Category:導入手順 {{Stub}} MySQLのバージョンが5.5になり、5.1の時と比較して導入手順に若干変化があった...

Drupalメモ

2012-11-12T15:00:46Z

Admin: /* 更新履歴 */

[[Category:Tips]][[Category:CMS]]

== Proxyを使用して更新確認を行う ==

「includes/common.inc」を以下のように変更します。（バージョン6.15を使用）

<source lang="diff">
457,460c457
< // --- mod start
< //$fp = @fsockopen($uri['host'], $port, $errno, $errstr, 15);
< $fp = @fsockopen('<WWW.XXX.YYY.ZZZ>', '<PORT>'); // 第1引数:ホスト名, 第2引数:ポート番号
< // --- mod end
---
> $fp = @fsockopen($uri['host'], $port, $errno, $errstr, 15);
533,537c530,531
< // --- mod start
< // $request = $method .' '. $path ." HTTP/1.0\r\n";
< // $request .= implode("\r\n", $defaults);
< $request = "$method ".$uri['scheme']."://".$uri['host'].$path." HTTP/1.1\r\n";
< // --- mod end
---
> $request = $method .' '. $path ." HTTP/1.0\r\n";
> $request .= implode("\r\n", $defaults);
</source>

* 参考
** http://drupal.org/node/7881

== 更新履歴 ==
* [[#アバターの画像URLを絶対URLから相対URLに変更する]]削除（コメントアウトと修正後のコードが同一であることに今更気が付きました。技術検証できるまで一時削除します。） -- 2012年11月13日 (火) 00:00 (JST)
* [[#アバターの画像URLを絶対URLから相対URLに変更する]]追加 -- 2010年12月26日 (日) 23:38 (JST)
* ページ作成 -- 2010年11月6日 (土) 07:40 (UTC)

Drupalメモ

2012-11-12T14:58:54Z

Admin: /* アバターの画像URLを絶対URLから相対URLに変更する */

[[Category:Tips]][[Category:CMS]]

== Proxyを使用して更新確認を行う ==

「includes/common.inc」を以下のように変更します。（バージョン6.15を使用）

<source lang="diff">
457,460c457
< // --- mod start
< //$fp = @fsockopen($uri['host'], $port, $errno, $errstr, 15);
< $fp = @fsockopen('<WWW.XXX.YYY.ZZZ>', '<PORT>'); // 第1引数:ホスト名, 第2引数:ポート番号
< // --- mod end
---
> $fp = @fsockopen($uri['host'], $port, $errno, $errstr, 15);
533,537c530,531
< // --- mod start
< // $request = $method .' '. $path ." HTTP/1.0\r\n";
< // $request .= implode("\r\n", $defaults);
< $request = "$method ".$uri['scheme']."://".$uri['host'].$path." HTTP/1.1\r\n";
< // --- mod end
---
> $request = $method .' '. $path ." HTTP/1.0\r\n";
> $request .= implode("\r\n", $defaults);
</source>

* 参考
** http://drupal.org/node/7881

== 更新履歴 ==

* [[#アバターの画像URLを絶対URLから相対URLに変更する]]追加 -- 2010年12月26日 (日) 23:38 (JST)
* ページ作成 -- 2010年11月6日 (土) 07:40 (UTC)

Redmineの導入手順

2012-11-12T06:32:01Z

Admin: /* developmentモードで起動するには */

[[Category:ソフトウェア開発]][[Category:導入手順]]

本ページでは、Rubyで作成されたバグトラッキングシステムである「Redmine」の導入手順を記述します。バージョン管理システムである「Mercurial」も同時にインストールします。

== 環境 ==

* OS : CentOS 5.4
* Web Server : Apache 2.2.17
* Database : MySQL 5.1.54
* Other : Redmine 1.1.0, Ruby 1.8.7, rubygems 1.4.2, Mercurial 1.7.3

== インストール ==

=== MySQL ===

入手先 :http://www.mysql.com/

<source lang="text">
$ tar zxvf mysql-5.1.54.tar.gz
$ cd mysql-5.1.54
$ ./configure
$ make
# make install
</source>

=== Apache ===

入手先 : http://httpd.apache.org/

<source lang="text">
$ tar zxvf httpd-2.2.17.tar.gz
$ cd httpd-2.2.17
$ ./configure
$ make
# make install
</source>

=== Ruby ===

入手先 : http://www.ruby-lang.org/

<source lang="text">
$ tar zxvf ruby-1.8.7-p330.tar.gz
$ cd ruby-1.8.7-p330
$ ./configure
$ make
# make install
</source>

=== RubyGems ===

入手先 : http://rubyforge.org/projects/rubygems/

<source lang="text">
$ tar zxvf rubygems-1.4.2.tgz
$ cd rubygems-1.4.2
# ruby setup.rb
</source>

=== Ruby on Rails ===

RubyGemsからインストールします。[http://www.redmine.org/projects/redmine/wiki/RedmineInstall 公式サイト]にある通り、バージョン2.3.5のRailsをインストールします。

<source lang="text">
# gem install rails -v 2.3.5
</source>

=== Docutils ===

Mercurialをインストールするための準備として、Docutilsをインストールします。

入手先 : http://docutils.sourceforge.net/

<source lang="text">
$ tar zxvf docutils-0.7
$ cd docutils-0.7
# ./setup.py install
</source>

Pythonはインストール済みとします。

=== Mercurial ===

入手先 : http://mercurial.selenic.com/

<source lang="text">
$ tar zxvf mercurial-1.7.3.tar.gz
$ cd mercurial-1.7.3
$ make all
# make install
</source>

=== Redmine ===

入手先 : http://www.redmine.org/

<source lang="text">
$ tar zxvf redmine-1.1.0.tar.gz
# gem install -v=0.4.2 i18n
# mv redmine-1.1.0 /var/lib/redmine
# cd /var/lib/redmine/
# rake generate_session_store
</source>

i18nはrakeに必要なためインストールします。

=== Passenger ===

Passengerをインストールします。
<source lang="text">
# gem install passenger
</source>

Apache用モジュールをインストールします。
<source lang="text">
# export APXS2=/usr/local/apache2/bin/apxs
# export PATH=/usr/local/apache2/bin:$PATH
# passenger-install-apache2-module
</source>

「Please edit your Apache configuration file, and add these lines:」の次の3行を控えて置きます。後に「httpd.conf」の設定で必要になります。
<source lang="text">
The Apache 2 module was successfully installed.

Please edit your Apache configuration file, and add these lines:

LoadModule passenger_module /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2/ext/apache2/mod_passenger.so
PassengerRoot /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2
PassengerRuby /usr/local/bin/ruby

After you restart Apache, you are ready to deploy any number of Ruby on Rails
applications on Apache, without any further Ruby on Rails-specific
configuration!

Press ENTER to continue.
</source>

=== MySQL用のデータベースアクセスライブラリ ===

MySQL用のデータベースアクセスライブラリをインストールします。

<source lang="text">
# gem install mysql -- --with-mysql-lib=/usr/local/lib/mysql/
</source>

インストール中に「No definition for ...」から始まる行がいくつか出力されます。

「ld.so.conf」に「/usr/local/lib/mysql/」を追加します。
<source lang="text">
# vim /etc/ld.so.conf
</source>

共有ライブラリを再認識させます。
<source lang="text">
# /sbin/ldconfig
</source>

== 設定 ==

=== MySQL ===

ユーザ「mysql」を作成し、DBを初期化します。

<source lang="text">
# /usr/sbin/useradd mysql
# /usr/local/bin/mysql_install_db --user=mysql
</source>

DBを起動し、rootのパスワードを設定します。

<source lang="text">
# /usr/local/bin/mysqld_safe --user=mysql &
# /usr/local/bin/mysqladmin -u root password <password>
</source>

Redmineでアクセスするためのユーザ（redmine）を作成し、DBを作成します。

<source lang="text">
# mysql -u root -p
</source>

<source lang="sql">
mysql> grant all privileges on *.* to redmine@localhost identified by '<パスワード>' with grant option;
mysql> create database redmine default character set utf8;
</source>

RedmineのDB接続設定を行います。

<source lang="text">
$ cd /var/lib/redmine/config/
$ cp database.yml.example database.yml
$ vim database.yml
</source>

productionのセクションの「username:」に先ほど作成したユーザ名、「password:」にDBパスワードを追記します。
<source lang="text">
production:
adapter: mysql
database: redmine
host: localhost
username: redmine
password: <パスワード>
encoding: utf8
</source>

DBを初期化します。
<source lang="text">
# rake db:migrate RAILS_ENV=production
</source>

本コマンドで、以下のメッセージが表示される場合は、共有ライブラリの設定が不十分かもしれません。
<source lang="text">
(in /var/lib/redmine)
rake aborted!
Object is not missing constant Issue!

(See full trace by running task with --trace)
</source>

標準のワークフローを導入します。
<source lang="text">
# rake redmine:load_default_data RAILS_ENV=production
</source>
「Select language:」と表示されたら「ja」を入力します。

=== Apache ===

「/usr/local/apache2/conf/httpd.conf」を編集します。

DocumentRootを以下に変更します。
<source lang="text">
# DocumentRoot "/usr/local/apache2/htdocs"
DocumentRoot "/var/lib/redmine/public"
</source>

以下を追記します。
<source lang="text">
<Directory "/var/lib/redmine/public">
Options Indexes FollowSymLinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>

LoadModule passenger_module /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2/ext/apache2/mod_passenger.so
PassengerRoot /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2
PassengerRuby /usr/local/bin/ruby
</source>
下の3行は、「passenger-install-apache2-module」の出力結果を必ず貼り付けてください。

== 起動 ==

=== MySQL ===

# /usr/local/bin/mysqld_safe --user=mysql &

=== Apache ===

# /usr/local/apache2/bin/apachectl start

Apache起動後、Redmine初期画面は以下のようになります。

[[ファイル:Redmine install.png|600px]]

[http://blog.redmine.jp/articles/farend-basic-theme/ farend basic]というテーマを使用しています。

== トラブルシューティング ==

=== 「rake db:migrate RAILS_ENV=production」コマンド実行時にエラーが発生する。 ===

以下のエラーメッセージが表示された場合、「rake generate_session_store」コマンドの実行が漏れている可能性があります。

<source lang="text">
(in /var/lib/redmine)
rake aborted!
A key is required to write a cookie containing the session data. Use config.action_controller.session = { :key => "_myapp_session", :secret => "some secret phrase" } in config/environment.rb

(See full trace by running task with --trace)
</source>

== RedmineでMercurialリポジトリを参照する ==

=== 作成手順 ===

Mercurialのリポジトリを作成し、hgrcファイルを編集します。

mkdir /var/lib/hg/test00
cd /var/lib/hg/test00
vim .hg/hgrc

hgrcファイルの内容は以下とします。

[web]
allow_push = *
push_ssl = false

Webサーバを立ち上げます。

hg serve --port 8002

[設定]->[リポジトリ]のページで以下のように設定します。

[[ファイル:Install redmine 01.png|600px]]

[リポジトリ]のページを参照すると、Mercurialのリポジトリを参照できます。

[[ファイル:Install redmine 02.png|600px]]

上記画像で文字化けしているテキストファイルは、「新しいテキストドキュメント.txt」という名前のファイルです。これは、ページの文字コードが「UTF-8」に対して、ファイルの文字コードが「Shift_JIS」であるために発生します。

=== 日本語ファイル名を含むファイルの履歴が表示されない ===

英字だけのファイル名の場合、履歴が正常に表示されます。

[[ファイル:Install redmine 03.png|600px]]

日本語を含むファイル名の場合、履歴が表示されません。ただし、ダウンロードはできます。

[[ファイル:Install redmine 04.png|600px]]

=== Root directoryをhttpプロトコルで指定すると参照できない ===

Root directoryを「http://192.168.100.6:8002/」等のhttpで指定すると、リポジトリ参照ができません。（一応、Webアクセス時、GETメソッドを使用しているようですが）

[[ファイル:Install redmine 05.png|600px]]

[[ファイル:Install redmine 06.png|600px]]

そもそも、想定外の指定方法かも知れません。（要調査）

== その他 ==

=== RMagickをインストールする ===

プラグイン[https://ociotec.com/redmine/projects/show/advanced-roadmap Adcanced roadmap]をインストールするためには[http://rmagick.rubyforge.org/ RMagick]が必要となります。

RMagickをインストールするまでの手順は以下となります。

==== FreeType ====

ImageMagickにてTrueTypeフォントを使用するため、FreeTypeをインストールします。

# yum install freetype freetype-devel

==== libpngのインストール ====

入手先 : http://www.libpng.org/pub/png/libpng.html

PNG形式のグラフを出力するときに使用するライブラリです。

$ tar zxvf libpng-1.5.4.tar.gz
$ cd libpng-1.5.4
$ ./configure
$ make
$ su
# make install

==== ImageMagickのインストール ====

入手先 : http://www.imagemagick.org/script/index.php

$ tar zxvf ImageMagick.tar.gz
$ cd ImageMagick-6.7.1-3
$ ./configure
$ make
$ su
# make install

==== RMagickのインストール ====

$ gem install rmagick

==== Advenced roadmapのソースコード修正 ====

標準では、Advanced roadmapのグラフの凡例が文字化けするので、「vendor/plugins/advanced_roadmap/lib/advanced_roadmap/gruff/base.rb」を修正します。

修正例 :
<source lang="diff">
226,227c226,228
< vera_font_path = File.expand_path('Vera.ttf', ENV['MAGICK_FONT_PATH'])
< @font = File.exists?(vera_font_path) ? vera_font_path : nil
---
> # vera_font_path = File.expand_path('Vera.ttf', ENV['MAGICK_FONT_PATH'])
> # @font = File.exists?(vera_font_path) ? vera_font_path : nil
> @font = "/usr/share/fonts/japanese/TrueType/sazanami-gothic.ttf"
</source>

参考 :
* http://groups.google.com/group/redmine-users-ja/browse_thread/thread/13410c0c0c809dc6

インストールは以上です。

-- 2011年8月8日 (月) 21:41 (JST)

=== サブディレクトリにRedmineを配置するには ===

通常インストールでは、Redmineのルートは「http://<ホスト名>/」となります。これを、「http://<ホスト名>/test/」とするには以下とします。

「httpd.conf」に以下を追記します。（DocumentRootは「"/usr/local/apache2/htdocs"」のままとします）
RailsBaseURI /test

シンボリックリンクを作成します。
# ln -s /var/lib/redmine/public /usr/local/apache2/htdocs/test

以上の手順により、1サーバで複数のRedmineを構築することも可能です。

=== developmentモードで起動するには ===

「httpd.conf」に以下を追記します。
RailsEnv development

=== プラグインをインストールした後のDB初期化コマンド ===

rake db:migrate_plugins RAILS_ENV=production

== 参考 ==

* 入門Redmine 第2版 Linux/Windows対応 / 前田剛
* http://redmine.jp/tech_note/apache-passenger/ - Apache上でRuby on Railsアプリケーションを動かす／Passenger(mod_rails for Apache)の利用

== 更新履歴 ==
* [[#RMagickをインストールする]] -- 2011年8月8日 (月) 21:41 (JST)
* [[#RedmineでMercurialリポジトリを参照する]]追加 -- 2011年3月20日 (日) 18:46 (JST)
* ページ作成 -- 2011年1月23日 (日) 16:35 (JST)

Redmineの導入手順

2012-05-16T03:44:20Z

Admin: Admin (トーク) による第405版を取り消し

[[Category:ソフトウェア開発]][[Category:導入手順]]

本ページでは、Rubyで作成されたバグトラッキングシステムである「Redmine」の導入手順を記述します。バージョン管理システムである「Mercurial」も同時にインストールします。

== 環境 ==

* OS : CentOS 5.4
* Web Server : Apache 2.2.17
* Database : MySQL 5.1.54
* Other : Redmine 1.1.0, Ruby 1.8.7, rubygems 1.4.2, Mercurial 1.7.3

== インストール ==

=== MySQL ===

入手先 :http://www.mysql.com/

<source lang="text">
$ tar zxvf mysql-5.1.54.tar.gz
$ cd mysql-5.1.54
$ ./configure
$ make
# make install
</source>

=== Apache ===

入手先 : http://httpd.apache.org/

<source lang="text">
$ tar zxvf httpd-2.2.17.tar.gz
$ cd httpd-2.2.17
$ ./configure
$ make
# make install
</source>

=== Ruby ===

入手先 : http://www.ruby-lang.org/

<source lang="text">
$ tar zxvf ruby-1.8.7-p330.tar.gz
$ cd ruby-1.8.7-p330
$ ./configure
$ make
# make install
</source>

=== RubyGems ===

入手先 : http://rubyforge.org/projects/rubygems/

<source lang="text">
$ tar zxvf rubygems-1.4.2.tgz
$ cd rubygems-1.4.2
# ruby setup.rb
</source>

=== Ruby on Rails ===

RubyGemsからインストールします。[http://www.redmine.org/projects/redmine/wiki/RedmineInstall 公式サイト]にある通り、バージョン2.3.5のRailsをインストールします。

<source lang="text">
# gem install rails -v 2.3.5
</source>

=== Docutils ===

Mercurialをインストールするための準備として、Docutilsをインストールします。

入手先 : http://docutils.sourceforge.net/

<source lang="text">
$ tar zxvf docutils-0.7
$ cd docutils-0.7
# ./setup.py install
</source>

Pythonはインストール済みとします。

=== Mercurial ===

入手先 : http://mercurial.selenic.com/

<source lang="text">
$ tar zxvf mercurial-1.7.3.tar.gz
$ cd mercurial-1.7.3
$ make all
# make install
</source>

=== Redmine ===

入手先 : http://www.redmine.org/

<source lang="text">
$ tar zxvf redmine-1.1.0.tar.gz
# gem install -v=0.4.2 i18n
# mv redmine-1.1.0 /var/lib/redmine
# cd /var/lib/redmine/
# rake generate_session_store
</source>

i18nはrakeに必要なためインストールします。

=== Passenger ===

Passengerをインストールします。
<source lang="text">
# gem install passenger
</source>

Apache用モジュールをインストールします。
<source lang="text">
# export APXS2=/usr/local/apache2/bin/apxs
# export PATH=/usr/local/apache2/bin:$PATH
# passenger-install-apache2-module
</source>

「Please edit your Apache configuration file, and add these lines:」の次の3行を控えて置きます。後に「httpd.conf」の設定で必要になります。
<source lang="text">
The Apache 2 module was successfully installed.

Please edit your Apache configuration file, and add these lines:

LoadModule passenger_module /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2/ext/apache2/mod_passenger.so
PassengerRoot /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2
PassengerRuby /usr/local/bin/ruby

After you restart Apache, you are ready to deploy any number of Ruby on Rails
applications on Apache, without any further Ruby on Rails-specific
configuration!

Press ENTER to continue.
</source>

=== MySQL用のデータベースアクセスライブラリ ===

MySQL用のデータベースアクセスライブラリをインストールします。

<source lang="text">
# gem install mysql -- --with-mysql-lib=/usr/local/lib/mysql/
</source>

インストール中に「No definition for ...」から始まる行がいくつか出力されます。

「ld.so.conf」に「/usr/local/lib/mysql/」を追加します。
<source lang="text">
# vim /etc/ld.so.conf
</source>

共有ライブラリを再認識させます。
<source lang="text">
# /sbin/ldconfig
</source>

== 設定 ==

=== MySQL ===

ユーザ「mysql」を作成し、DBを初期化します。

<source lang="text">
# /usr/sbin/useradd mysql
# /usr/local/bin/mysql_install_db --user=mysql
</source>

DBを起動し、rootのパスワードを設定します。

<source lang="text">
# /usr/local/bin/mysqld_safe --user=mysql &
# /usr/local/bin/mysqladmin -u root password <password>
</source>

Redmineでアクセスするためのユーザ（redmine）を作成し、DBを作成します。

<source lang="text">
# mysql -u root -p
</source>

<source lang="sql">
mysql> grant all privileges on *.* to redmine@localhost identified by '<パスワード>' with grant option;
mysql> create database redmine default character set utf8;
</source>

RedmineのDB接続設定を行います。

<source lang="text">
$ cd /var/lib/redmine/config/
$ cp database.yml.example database.yml
$ vim database.yml
</source>

productionのセクションの「username:」に先ほど作成したユーザ名、「password:」にDBパスワードを追記します。
<source lang="text">
production:
adapter: mysql
database: redmine
host: localhost
username: redmine
password: <パスワード>
encoding: utf8
</source>

DBを初期化します。
<source lang="text">
# rake db:migrate RAILS_ENV=production
</source>

本コマンドで、以下のメッセージが表示される場合は、共有ライブラリの設定が不十分かもしれません。
<source lang="text">
(in /var/lib/redmine)
rake aborted!
Object is not missing constant Issue!

(See full trace by running task with --trace)
</source>

標準のワークフローを導入します。
<source lang="text">
# rake redmine:load_default_data RAILS_ENV=production
</source>
「Select language:」と表示されたら「ja」を入力します。

=== Apache ===

「/usr/local/apache2/conf/httpd.conf」を編集します。

DocumentRootを以下に変更します。
<source lang="text">
# DocumentRoot "/usr/local/apache2/htdocs"
DocumentRoot "/var/lib/redmine/public"
</source>

以下を追記します。
<source lang="text">
<Directory "/var/lib/redmine/public">
Options Indexes FollowSymLinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>

LoadModule passenger_module /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2/ext/apache2/mod_passenger.so
PassengerRoot /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2
PassengerRuby /usr/local/bin/ruby
</source>
下の3行は、「passenger-install-apache2-module」の出力結果を必ず貼り付けてください。

== 起動 ==

=== MySQL ===

# /usr/local/bin/mysqld_safe --user=mysql &

=== Apache ===

# /usr/local/apache2/bin/apachectl start

Apache起動後、Redmine初期画面は以下のようになります。

[[ファイル:Redmine install.png|600px]]

[http://blog.redmine.jp/articles/farend-basic-theme/ farend basic]というテーマを使用しています。

== トラブルシューティング ==

=== 「rake db:migrate RAILS_ENV=production」コマンド実行時にエラーが発生する。 ===

以下のエラーメッセージが表示された場合、「rake generate_session_store」コマンドの実行が漏れている可能性があります。

<source lang="text">
(in /var/lib/redmine)
rake aborted!
A key is required to write a cookie containing the session data. Use config.action_controller.session = { :key => "_myapp_session", :secret => "some secret phrase" } in config/environment.rb

(See full trace by running task with --trace)
</source>

== RedmineでMercurialリポジトリを参照する ==

=== 作成手順 ===

Mercurialのリポジトリを作成し、hgrcファイルを編集します。

mkdir /var/lib/hg/test00
cd /var/lib/hg/test00
vim .hg/hgrc

hgrcファイルの内容は以下とします。

[web]
allow_push = *
push_ssl = false

Webサーバを立ち上げます。

hg serve --port 8002

[設定]->[リポジトリ]のページで以下のように設定します。

[[ファイル:Install redmine 01.png|600px]]

[リポジトリ]のページを参照すると、Mercurialのリポジトリを参照できます。

[[ファイル:Install redmine 02.png|600px]]

上記画像で文字化けしているテキストファイルは、「新しいテキストドキュメント.txt」という名前のファイルです。これは、ページの文字コードが「UTF-8」に対して、ファイルの文字コードが「Shift_JIS」であるために発生します。

=== 日本語ファイル名を含むファイルの履歴が表示されない ===

英字だけのファイル名の場合、履歴が正常に表示されます。

[[ファイル:Install redmine 03.png|600px]]

日本語を含むファイル名の場合、履歴が表示されません。ただし、ダウンロードはできます。

[[ファイル:Install redmine 04.png|600px]]

=== Root directoryをhttpプロトコルで指定すると参照できない ===

Root directoryを「http://192.168.100.6:8002/」等のhttpで指定すると、リポジトリ参照ができません。（一応、Webアクセス時、GETメソッドを使用しているようですが）

[[ファイル:Install redmine 05.png|600px]]

[[ファイル:Install redmine 06.png|600px]]

そもそも、想定外の指定方法かも知れません。（要調査）

== その他 ==

=== RMagickをインストールする ===

プラグイン[https://ociotec.com/redmine/projects/show/advanced-roadmap Adcanced roadmap]をインストールするためには[http://rmagick.rubyforge.org/ RMagick]が必要となります。

RMagickをインストールするまでの手順は以下となります。

==== FreeType ====

ImageMagickにてTrueTypeフォントを使用するため、FreeTypeをインストールします。

# yum install freetype freetype-devel

==== libpngのインストール ====

入手先 : http://www.libpng.org/pub/png/libpng.html

PNG形式のグラフを出力するときに使用するライブラリです。

$ tar zxvf libpng-1.5.4.tar.gz
$ cd libpng-1.5.4
$ ./configure
$ make
$ su
# make install

==== ImageMagickのインストール ====

入手先 : http://www.imagemagick.org/script/index.php

$ tar zxvf ImageMagick.tar.gz
$ cd ImageMagick-6.7.1-3
$ ./configure
$ make
$ su
# make install

==== RMagickのインストール ====

$ gem install rmagick

==== Advenced roadmapのソースコード修正 ====

標準では、Advanced roadmapのグラフの凡例が文字化けするので、「vendor/plugins/advanced_roadmap/lib/advanced_roadmap/gruff/base.rb」を修正します。

修正例 :
<source lang="diff">
226,227c226,228
< vera_font_path = File.expand_path('Vera.ttf', ENV['MAGICK_FONT_PATH'])
< @font = File.exists?(vera_font_path) ? vera_font_path : nil
---
> # vera_font_path = File.expand_path('Vera.ttf', ENV['MAGICK_FONT_PATH'])
> # @font = File.exists?(vera_font_path) ? vera_font_path : nil
> @font = "/usr/share/fonts/japanese/TrueType/sazanami-gothic.ttf"
</source>

参考 :
* http://groups.google.com/group/redmine-users-ja/browse_thread/thread/13410c0c0c809dc6

インストールは以上です。

-- 2011年8月8日 (月) 21:41 (JST)

=== サブディレクトリにRedmineを配置するには ===

通常インストールでは、Redmineのルートは「http://<ホスト名>/」となります。これを、「http://<ホスト名>/test/」とするには以下とします。

「httpd.conf」に以下を追記します。（DocumentRootは「"/usr/local/apache2/htdocs"」のままとします）
RailsBaseURI /test

シンボリックリンクを作成します。
# ln -s /var/lib/redmine/public /usr/local/apache2/htdocs/test

以上の手順により、1サーバで複数のRedmineを構築することも可能です。

=== developmentモードで起動するには ===

「httpd.conf」に以下を追記します。
RailsEnv development

== 参考 ==

* 入門Redmine 第2版 Linux/Windows対応 / 前田剛
* http://redmine.jp/tech_note/apache-passenger/ - Apache上でRuby on Railsアプリケーションを動かす／Passenger(mod_rails for Apache)の利用

== 更新履歴 ==
* [[#RMagickをインストールする]] -- 2011年8月8日 (月) 21:41 (JST)
* [[#RedmineでMercurialリポジトリを参照する]]追加 -- 2011年3月20日 (日) 18:46 (JST)
* ページ作成 -- 2011年1月23日 (日) 16:35 (JST)

Redmineの導入手順

2012-05-16T03:36:02Z

Admin: /* Redmine */

[[Category:ソフトウェア開発]][[Category:導入手順]]

本ページでは、Rubyで作成されたバグトラッキングシステムである「Redmine」の導入手順を記述します。バージョン管理システムである「Mercurial」も同時にインストールします。

== 環境 ==

* OS : CentOS 5.4
* Web Server : Apache 2.2.17
* Database : MySQL 5.1.54
* Other : Redmine 1.1.0, Ruby 1.8.7, rubygems 1.4.2, Mercurial 1.7.3

== インストール ==

=== MySQL ===

入手先 :http://www.mysql.com/

<source lang="text">
$ tar zxvf mysql-5.1.54.tar.gz
$ cd mysql-5.1.54
$ ./configure
$ make
# make install
</source>

=== Apache ===

入手先 : http://httpd.apache.org/

<source lang="text">
$ tar zxvf httpd-2.2.17.tar.gz
$ cd httpd-2.2.17
$ ./configure
$ make
# make install
</source>

=== Ruby ===

入手先 : http://www.ruby-lang.org/

<source lang="text">
$ tar zxvf ruby-1.8.7-p330.tar.gz
$ cd ruby-1.8.7-p330
$ ./configure
$ make
# make install
</source>

=== RubyGems ===

入手先 : http://rubyforge.org/projects/rubygems/

<source lang="text">
$ tar zxvf rubygems-1.4.2.tgz
$ cd rubygems-1.4.2
# ruby setup.rb
</source>

=== Ruby on Rails ===

RubyGemsからインストールします。[http://www.redmine.org/projects/redmine/wiki/RedmineInstall 公式サイト]にある通り、バージョン2.3.5のRailsをインストールします。

<source lang="text">
# gem install rails -v 2.3.5
</source>

=== Docutils ===

Mercurialをインストールするための準備として、Docutilsをインストールします。

入手先 : http://docutils.sourceforge.net/

<source lang="text">
$ tar zxvf docutils-0.7
$ cd docutils-0.7
# ./setup.py install
</source>

Pythonはインストール済みとします。

=== Mercurial ===

入手先 : http://mercurial.selenic.com/

<source lang="text">
$ tar zxvf mercurial-1.7.3.tar.gz
$ cd mercurial-1.7.3
$ make all
# make install
</source>

=== Redmine ===

入手先 : http://www.redmine.org/

<source lang="text">
$ tar zxvf redmine-1.1.0.tar.gz
# gem install -v=0.4.2 i18n
# mkdir /var/lib/redmine
# mv redmine-1.1.0 /var/lib/redmine
# cd /var/lib/redmine/
# rake generate_session_store
</source>

i18nはrakeに必要なためインストールします。

=== Passenger ===

Passengerをインストールします。
<source lang="text">
# gem install passenger
</source>

Apache用モジュールをインストールします。
<source lang="text">
# export APXS2=/usr/local/apache2/bin/apxs
# export PATH=/usr/local/apache2/bin:$PATH
# passenger-install-apache2-module
</source>

「Please edit your Apache configuration file, and add these lines:」の次の3行を控えて置きます。後に「httpd.conf」の設定で必要になります。
<source lang="text">
The Apache 2 module was successfully installed.

Please edit your Apache configuration file, and add these lines:

LoadModule passenger_module /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2/ext/apache2/mod_passenger.so
PassengerRoot /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2
PassengerRuby /usr/local/bin/ruby

After you restart Apache, you are ready to deploy any number of Ruby on Rails
applications on Apache, without any further Ruby on Rails-specific
configuration!

Press ENTER to continue.
</source>

=== MySQL用のデータベースアクセスライブラリ ===

MySQL用のデータベースアクセスライブラリをインストールします。

<source lang="text">
# gem install mysql -- --with-mysql-lib=/usr/local/lib/mysql/
</source>

インストール中に「No definition for ...」から始まる行がいくつか出力されます。

「ld.so.conf」に「/usr/local/lib/mysql/」を追加します。
<source lang="text">
# vim /etc/ld.so.conf
</source>

共有ライブラリを再認識させます。
<source lang="text">
# /sbin/ldconfig
</source>

== 設定 ==

=== MySQL ===

ユーザ「mysql」を作成し、DBを初期化します。

<source lang="text">
# /usr/sbin/useradd mysql
# /usr/local/bin/mysql_install_db --user=mysql
</source>

DBを起動し、rootのパスワードを設定します。

<source lang="text">
# /usr/local/bin/mysqld_safe --user=mysql &
# /usr/local/bin/mysqladmin -u root password <password>
</source>

Redmineでアクセスするためのユーザ（redmine）を作成し、DBを作成します。

<source lang="text">
# mysql -u root -p
</source>

<source lang="sql">
mysql> grant all privileges on *.* to redmine@localhost identified by '<パスワード>' with grant option;
mysql> create database redmine default character set utf8;
</source>

RedmineのDB接続設定を行います。

<source lang="text">
$ cd /var/lib/redmine/config/
$ cp database.yml.example database.yml
$ vim database.yml
</source>

productionのセクションの「username:」に先ほど作成したユーザ名、「password:」にDBパスワードを追記します。
<source lang="text">
production:
adapter: mysql
database: redmine
host: localhost
username: redmine
password: <パスワード>
encoding: utf8
</source>

DBを初期化します。
<source lang="text">
# rake db:migrate RAILS_ENV=production
</source>

本コマンドで、以下のメッセージが表示される場合は、共有ライブラリの設定が不十分かもしれません。
<source lang="text">
(in /var/lib/redmine)
rake aborted!
Object is not missing constant Issue!

(See full trace by running task with --trace)
</source>

標準のワークフローを導入します。
<source lang="text">
# rake redmine:load_default_data RAILS_ENV=production
</source>
「Select language:」と表示されたら「ja」を入力します。

=== Apache ===

「/usr/local/apache2/conf/httpd.conf」を編集します。

DocumentRootを以下に変更します。
<source lang="text">
# DocumentRoot "/usr/local/apache2/htdocs"
DocumentRoot "/var/lib/redmine/public"
</source>

以下を追記します。
<source lang="text">
<Directory "/var/lib/redmine/public">
Options Indexes FollowSymLinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>

LoadModule passenger_module /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2/ext/apache2/mod_passenger.so
PassengerRoot /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2
PassengerRuby /usr/local/bin/ruby
</source>
下の3行は、「passenger-install-apache2-module」の出力結果を必ず貼り付けてください。

== 起動 ==

=== MySQL ===

# /usr/local/bin/mysqld_safe --user=mysql &

=== Apache ===

# /usr/local/apache2/bin/apachectl start

Apache起動後、Redmine初期画面は以下のようになります。

[[ファイル:Redmine install.png|600px]]

[http://blog.redmine.jp/articles/farend-basic-theme/ farend basic]というテーマを使用しています。

== トラブルシューティング ==

=== 「rake db:migrate RAILS_ENV=production」コマンド実行時にエラーが発生する。 ===

以下のエラーメッセージが表示された場合、「rake generate_session_store」コマンドの実行が漏れている可能性があります。

<source lang="text">
(in /var/lib/redmine)
rake aborted!
A key is required to write a cookie containing the session data. Use config.action_controller.session = { :key => "_myapp_session", :secret => "some secret phrase" } in config/environment.rb

(See full trace by running task with --trace)
</source>

== RedmineでMercurialリポジトリを参照する ==

=== 作成手順 ===

Mercurialのリポジトリを作成し、hgrcファイルを編集します。

mkdir /var/lib/hg/test00
cd /var/lib/hg/test00
vim .hg/hgrc

hgrcファイルの内容は以下とします。

[web]
allow_push = *
push_ssl = false

Webサーバを立ち上げます。

hg serve --port 8002

[設定]->[リポジトリ]のページで以下のように設定します。

[[ファイル:Install redmine 01.png|600px]]

[リポジトリ]のページを参照すると、Mercurialのリポジトリを参照できます。

[[ファイル:Install redmine 02.png|600px]]

上記画像で文字化けしているテキストファイルは、「新しいテキストドキュメント.txt」という名前のファイルです。これは、ページの文字コードが「UTF-8」に対して、ファイルの文字コードが「Shift_JIS」であるために発生します。

=== 日本語ファイル名を含むファイルの履歴が表示されない ===

英字だけのファイル名の場合、履歴が正常に表示されます。

[[ファイル:Install redmine 03.png|600px]]

日本語を含むファイル名の場合、履歴が表示されません。ただし、ダウンロードはできます。

[[ファイル:Install redmine 04.png|600px]]

=== Root directoryをhttpプロトコルで指定すると参照できない ===

Root directoryを「http://192.168.100.6:8002/」等のhttpで指定すると、リポジトリ参照ができません。（一応、Webアクセス時、GETメソッドを使用しているようですが）

[[ファイル:Install redmine 05.png|600px]]

[[ファイル:Install redmine 06.png|600px]]

そもそも、想定外の指定方法かも知れません。（要調査）

== その他 ==

=== RMagickをインストールする ===

プラグイン[https://ociotec.com/redmine/projects/show/advanced-roadmap Adcanced roadmap]をインストールするためには[http://rmagick.rubyforge.org/ RMagick]が必要となります。

RMagickをインストールするまでの手順は以下となります。

==== FreeType ====

ImageMagickにてTrueTypeフォントを使用するため、FreeTypeをインストールします。

# yum install freetype freetype-devel

==== libpngのインストール ====

入手先 : http://www.libpng.org/pub/png/libpng.html

PNG形式のグラフを出力するときに使用するライブラリです。

$ tar zxvf libpng-1.5.4.tar.gz
$ cd libpng-1.5.4
$ ./configure
$ make
$ su
# make install

==== ImageMagickのインストール ====

入手先 : http://www.imagemagick.org/script/index.php

$ tar zxvf ImageMagick.tar.gz
$ cd ImageMagick-6.7.1-3
$ ./configure
$ make
$ su
# make install

==== RMagickのインストール ====

$ gem install rmagick

==== Advenced roadmapのソースコード修正 ====

標準では、Advanced roadmapのグラフの凡例が文字化けするので、「vendor/plugins/advanced_roadmap/lib/advanced_roadmap/gruff/base.rb」を修正します。

修正例 :
<source lang="diff">
226,227c226,228
< vera_font_path = File.expand_path('Vera.ttf', ENV['MAGICK_FONT_PATH'])
< @font = File.exists?(vera_font_path) ? vera_font_path : nil
---
> # vera_font_path = File.expand_path('Vera.ttf', ENV['MAGICK_FONT_PATH'])
> # @font = File.exists?(vera_font_path) ? vera_font_path : nil
> @font = "/usr/share/fonts/japanese/TrueType/sazanami-gothic.ttf"
</source>

参考 :
* http://groups.google.com/group/redmine-users-ja/browse_thread/thread/13410c0c0c809dc6

インストールは以上です。

-- 2011年8月8日 (月) 21:41 (JST)

=== サブディレクトリにRedmineを配置するには ===

通常インストールでは、Redmineのルートは「http://<ホスト名>/」となります。これを、「http://<ホスト名>/test/」とするには以下とします。

「httpd.conf」に以下を追記します。（DocumentRootは「"/usr/local/apache2/htdocs"」のままとします）
RailsBaseURI /test

シンボリックリンクを作成します。
# ln -s /var/lib/redmine/public /usr/local/apache2/htdocs/test

以上の手順により、1サーバで複数のRedmineを構築することも可能です。

=== developmentモードで起動するには ===

「httpd.conf」に以下を追記します。
RailsEnv development

== 参考 ==

* 入門Redmine 第2版 Linux/Windows対応 / 前田剛
* http://redmine.jp/tech_note/apache-passenger/ - Apache上でRuby on Railsアプリケーションを動かす／Passenger(mod_rails for Apache)の利用

== 更新履歴 ==
* [[#RMagickをインストールする]] -- 2011年8月8日 (月) 21:41 (JST)
* [[#RedmineでMercurialリポジトリを参照する]]追加 -- 2011年3月20日 (日) 18:46 (JST)
* ページ作成 -- 2011年1月23日 (日) 16:35 (JST)

Subversion,Apacheの導入手順

2012-03-04T08:34:52Z

Admin: /* インストール */

[[Category:ソフトウェア開発]]

このページは、HTTP経由でSubversionを使用するための手順を記述します。内容は、[[Review Boardの導入手順]]の内容を抜き出して、多少修正したものです。

== 環境 ==

* OS : CentOS 6.2
* Apache : 2.2.17
* Subversion : 1.6.15

== インストール ==

=== Apache ===

入手先 : http://httpd.apache.org/

<source lang="text">
$ tar zxvf httpd-2.2.17.tar.gz
$ cd neon-0.29.5
$ ./configure --enable-dav
$ make
# make install
</source>

「--enable-dav」はSubversionインストール時に導入されるモジュール「dav_svn_module」を動作させるために必要です。

=== neon ===

Subversionのコマンドでhttpスキームを使用するために必要なライブラリであるneonをインストールします。svnコマンドでhttpスキーム（「svn co http://」等）を使用しない場合は、インストール不要です。

入手先 : http://www.webdav.org/neon/

<source lang="text">
$ tar zxvf neon-0.29.5.tar.gz
$ cd httpd-2.2.17
$ ./configure
$ make
# make install
</source>

=== SQLite Amalgamation ===

Subversionのビルドに必要となるSQLiteのソースコードをダウンロードします。

入手先 : http://www.sqlite.org/sqlite-amalgamation-3.6.13.tar.gz

=== Subversion ===

入手先 : http://subversion.tigris.org/

<source lang="text">
$ tar jxvf subversion-1.6.15.tar.bz2
$ tar zxvf sqlite-amalgamation-3.6.13.tar.gz
$ mv sqlite-3.6.13/ subversion-1.6.15/sqlite-amalgamation
$ cd subversion-1.6.15
$ ./configure
$ make
# make install
</source>

== 設定 ==

=== Apache ===

「/usr/local/apache2/conf/httpd.conf」を編集します。

<source lang="text">
LoadModule dav_svn_module modules/mod_dav_svn.so
LoadModule authz_svn_module modules/mod_authz_svn.so

<Location "/svn/test/test01">
DAV svn
SVNPath /var/lib/svn/test/test01
AuthzSVNAccessFile /usr/local/apache2/conf/svn.authz
AuthType Basic
AuthName "Subversion Repository"
AuthUserFile /usr/local/apache2/conf/.htpasswd
Require valid-user
</Location>
</source>

=== svn.authz ===

アクセス制御ファイルを「/usr/local/apache2/conf/svn.authz」に作成します。

<source lang="text">
[groups]
admin = user01

[/]
@admin = rw
</source>

=== .htpasswd ===

ApacheのBasic認証ファイルを「/usr/local/apache2/conf/.htpasswd」に作成します。

# /usr/local/apache2/bin/htpasswd -c /usr/local/apache2/conf/.htpasswd user01
New password:
Re-type new password:
Adding password for user user01

=== リポジトリ作成 ===

Subversionリポジトリを作成します。リポジトリのパーミッションはApacheの実行ユーザー（初期値ではdaemon）とします。

# mkdir -p /var/lib/svn/test/test01
# cd /var/lib/svn/test/test01
# svnadmin create .
# chown daemon.daemon /var/lib/svn/ -R

== 起動 ==

=== Apache ===

# /usr/local/apache2/bin/apachectl start

Apache起動後、「http://<Apacheのホスト名>/svn/test/test01/」でチェックアウトできれば設定完了です。

== 更新履歴 ==

* ページ作成 -- 2012年3月4日 (日) 16:44 (JST)

ページ逆引き

2012-03-04T07:45:23Z

Admin:

[[Category:その他]]

簡単なページ逆引きリストです。自分でも知りたい情報がどこにあるか分からなくなる事があるので…。

== 更新履歴 ==

* ページ作成 -- 2012年3月4日 (日) 14:02 (JST)

Subversion,Apacheの導入手順

2012-03-04T07:44:44Z

Admin: ページの作成: Category:ソフトウェア開発このページは、HTTP経由でSubversionを使用するための手順を記述します。内容は、Review Boardの導入手順...

[[Category:ソフトウェア開発]]

このページは、HTTP経由でSubversionを使用するための手順を記述します。内容は、[[Review Boardの導入手順]]の内容を抜き出して、多少修正したものです。

== 環境 ==

* OS : CentOS 6.2
* Apache : 2.2.17
* Subversion : 1.6.15

== インストール ==

=== Apache ===

入手先 : http://httpd.apache.org/

<source lang="text">
$ tar zxvf httpd-2.2.17.tar.gz
$ cd neon-0.29.5
$ ./configure --enable-dav
$ make
# make install
</source>

「--enable-dav」はSubversionインストール時に導入されるモジュール「dav_svn_module」を動作させるために必要です。

=== Subversion ===

入手先 : http://subversion.tigris.org/

<source lang="text">
$ tar jxvf subversion-1.6.15.tar.bz2
$ tar zxvf sqlite-amalgamation-3.6.13.tar.gz
$ mv sqlite-3.6.13/ subversion-1.6.15/sqlite-amalgamation
$ cd subversion-1.6.15
$ ./configure
$ make
# make install
</source>

== 設定 ==

=== Apache ===

「/usr/local/apache2/conf/httpd.conf」を編集します。

<source lang="text">
LoadModule dav_svn_module modules/mod_dav_svn.so
LoadModule authz_svn_module modules/mod_authz_svn.so

<Location "/svn/test/test01">
DAV svn
SVNPath /var/lib/svn/test/test01
AuthzSVNAccessFile /usr/local/apache2/conf/svn.authz
AuthType Basic
AuthName "Subversion Repository"
AuthUserFile /usr/local/apache2/conf/.htpasswd
Require valid-user
</Location>
</source>

=== svn.authz ===

アクセス制御ファイルを「/usr/local/apache2/conf/svn.authz」に作成します。

<source lang="text">
[groups]
admin = user01

[/]
@admin = rw
</source>

=== .htpasswd ===

ApacheのBasic認証ファイルを「/usr/local/apache2/conf/.htpasswd」に作成します。

# /usr/local/apache2/bin/htpasswd -c /usr/local/apache2/conf/.htpasswd user01
New password:
Re-type new password:
Adding password for user user01

=== リポジトリ作成 ===

Subversionリポジトリを作成します。リポジトリのパーミッションはApacheの実行ユーザー（初期値ではdaemon）とします。

# mkdir -p /var/lib/svn/test/test01
# cd /var/lib/svn/test/test01
# svnadmin create .
# chown daemon.daemon /var/lib/svn/ -R

== 起動 ==

=== Apache ===

# /usr/local/apache2/bin/apachectl start

Apache起動後、「http://<Apacheのホスト名>/svn/test/test01/」でチェックアウトできれば設定完了です。

== 更新履歴 ==

* ページ作成 -- 2012年3月4日 (日) 16:44 (JST)

ページ逆引き

2012-03-04T05:02:50Z

Admin: ページの作成: Category:その他簡単なページ逆引きリストです。自分でも知りたい情報がどこにあるか分からなくなる事があるので…。 * Apache...

[[Category:その他]]

簡単なページ逆引きリストです。自分でも知りたい情報がどこにあるか分からなくなる事があるので…。

* Apache経由でSubversionを使用する
** [[Review Boardの導入手順#Apache]] のApacheとSubversion関係のトピックを参考

== 更新履歴 ==

* ページ作成 -- 2012年3月4日 (日) 14:02 (JST)

Ant,Jenkins,Sonarの導入手順

2012-02-12T10:12:24Z

Admin: /* FindBugs指摘項目の文字化けを回避する */

[[Category:ソフトウェア開発]]

本ページでは、Javaソフトウェア管理ツール群である、Ant・Jenkins・Sonarの導入手順を記述します。[[Maven,Jenkins,Sonarの導入手順]]と異なるのは、ビルドツールにMavenではなくAntを使用している点です。

Mavenは、ディレクトリ構成といった各種ルールが予め定義されているため、標準に従えばビルド作業が効率よく行える反面、自由度が低いため融通が利かないという性質があります。Mavenを導入していないプロジェクトに対してSonarによる品質チェックを行いたい場合、Mavenのルールに無理やり適合させて既存の構成を変更してしまうことは得策とは言えません。[http://www.sonarsource.org/sonar-2-6-adds-continuous-inspection-support-for-ant-community/#more-4887 Sonar 2.6]からAntによるビルドでもSonarを使用でるようになりましたので、その手順を記述します。

参考 : [[Maven,Jenkins,Sonarの導入手順]]

== 環境 ==

* OS : CentOS 5.5
* Ant : 1.8.2
* Jenkins : 1.406
* Sonar : 2.7
* Tomcat : 7.0.12
* MySQL : 5.1.54

== インストール ==

Jenkins, Tomcat, MySQLのインストール方法は、[[Maven,Jenkins,Sonarの導入手順#インストール]]を参照ください。

=== Ant ===

入手先 : http://ant.apache.org/

$ tar zxvf apache-ant-1.8.2-bin.tar.gz
# mv apache-ant-1.8.2 /usr/local/

=== Sonar ===

入手先 : http://www.sonarsource.com/

$ unzip sonar-2.7.zip
# mv sonar-2.7 /usr/local/

=== Sonar Ant Task ===

入手先 : http://docs.codehaus.org/display/SONAR/Analyse+with+ANT

上記ページからSonar Ant Taskをダウンロードします。

ダウンロードした「sonar-ant-task-1.0.jar」ファイルを「/usr/local/apache-ant-1.8.2/lib/」に移動します。

== 設定 ==

Jenkins, Sonar, Tomcat, MySQLのインストール方法は、[[Maven,Jenkins,Sonarの導入手順#設定]]を参照ください。

=== その他 ===

「ANT_HOME」の環境変数を設定します。

export ANT_HOME=/usr/local/apache-ant-1.8.2/

JenkinsがAntのコマンドである「ant」を実行するために、「/usr/local/apache-ant-1.8.2/bin/」をPATHに加えます。

== 起動 ==

起動方法は[[Maven,Jenkins,Sonarの導入手順#起動]]を参照ください。

== Sonarの品質管理画面を更新 ==

EclipseでJavaプロジェクトを作成し、Sonarの品質管理画面を更新する場合の手順を記述します。Subversionの使用方法は[[Maven,Jenkins,Sonarの導入手順#Subversionリポジトリを作成する]]を参考にしてください。

=== Javaプロジェクトの作成 ===

Javaプロジェクトのルートディレクトリに「build.xml」ファイルを作成します。ファイルの作成例を以下に示します。

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<project name="sample" default="compile" basedir="." xmlns:sonar="antlib:org.sonar.ant">
<description>Sonarサンプル</description>
<property environment="env" />
<property name="src" location="src"/>
<property name="build" location="bin"/>

<taskdef uri="antlib:org.sonar.ant" resource="org/sonar/ant/antlib.xml">
<classpath path="${env.ANT_HOME}/lib/sonar-ant-task-1.0.jar" />
</taskdef>

<target name="init">
<tstamp/>
<mkdir dir="${build}"/>
</target>

<target name="compile" depends="init" description="compile the source">
<javac srcdir="${src}" destdir="${build}" encoding="MS932" />
</target>

<target name="sonar" description="analyze project" >
<sonar:sonar workDir="/tmp/sonar/test00" key="com.example.test00:test00" version="0.1">
<property key="sonar.jdbc.url" value="jdbc:mysql://${env.SONAR_HOST_NAME}:3306/sonar?useUnicode=true&characterEncoding=utf8" />
<property key="sonar.jdbc.driverClassName" value="com.mysql.jdbc.Driver" />
<property key="sonar.jdbc.username" value="sonar" />
<property key="sonar.jdbc.password" value="sonar" />
<property key="sonar.host.url" value="http://${env.SONAR_HOST_NAME}:8080/sonar" />
<property key="sonar.sourceEncoding" value="MS932" />

<sources>
<path location="${src}" />
</sources>

<property key="sonar.projectName" value="Sonarサンプル" />
<property key="sonar.dynamicAnalysis" value="false" />
</sonar:sonar>
</target>

<target name="clean" description="clean up" >
<delete dir="${build}"/>
</target>
</project>
</source>

SonarとMySQLが動作するサーバを環境変数「SONAR_HOST_NAME」から取得します。「SONAR_HOST_NAME」の環境変数を設定します。

export SONAR_HOST_NAME=<HOST_NAME>

動的な値にする必要が無ければ、環境変数による設定でなくホスト名を直接入力しても問題ありません。

今回使用したプロジェクトのエンコードは「UTF-8」でなく「MS932」のため、javacのencoding属性、sonar:sonarのproperty要素に「MS932」の記述を追記しています。

=== Jenkinsでジョブを設定する ===

最初に、「Jenkinsの管理」->「システムの設定」からAntの設定を行います。

[[ファイル:Install sonar ant 01.png|600px]]

次に、「新規ジョブ作成」からジョブを作成します。

[[ファイル:Install sonar ant 02.png|600px]]

「ソースコード管理システム」と「ビルド」の項目を変更します。

[[ファイル:Install sonar ant 03.png|600px]]

「ビルド実行」を選択すると、ビルドが開始されます。コンソール出力の最後に「Finished: SUCCESS」と表示されていれば、正常に終了しています。

[[ファイル:Install sonar ant 04.png|600px]]

「http://<ホスト名>:8080/sonar」にアクセスすると、「Sonarサンプル」が追加されています。

[[ファイル:Install sonar ant 05.png|600px]]

[[ファイル:Install sonar ant 06.png|600px]]

== トラブルシューティング ==

=== Sonar実行時に「org.sonar.squid.api.AnalysisException: Got an exception - unexpected char: 0xXXXX」が表示される ===

ソースコードのエンコーディングが「MS932」の場合、以下のエラーメッセージが表示されることがあります。

<source lang="text">
sonar:
[sonar:sonar] Apache Ant(TM) version 1.8.2 compiled on December 20 2010
[sonar:sonar] Sonar Ant Task version: 1.0
[sonar:sonar] Loaded from: file:/usr/local/apache-ant-1.8.2/lib/sonar-ant-task-1.0.jar
[sonar:sonar] Sonar work directory: /tmp/sonar/test00
[sonar:sonar] Sonar server: http://127.0.0.1:8080/sonar
[sonar:sonar] Sonar version: 2.7
[sonar:sonar] [INFO] Database dialect class org.sonar.jpa.dialect.MySql
[sonar:sonar] [INFO] Execution environment: Ant Apache Ant(TM) version 1.8.2 compiled on December 20 2010
[sonar:sonar] [INFO] ------------- Analyzing Sonarサンプル
[sonar:sonar] [INFO] Selected quality profile : [name=Sonar way,language=java]
[sonar:sonar] [INFO] Compare to previous analysis (2011-04-16)
[sonar:sonar] [INFO] Compare over 5 days (2011-04-11, analysis of 2011-04-16 21:02:18.0)
[sonar:sonar] [INFO] Compare over 30 days (2011-03-17, analysis of 2011-04-16 21:02:18.0)
[sonar:sonar] [INFO] Configure maven plugins...
[sonar:sonar] [INFO] Sensor AsynchronousMeasuresSensor...
[sonar:sonar] [INFO] Sensor AsynchronousMeasuresSensor done: 90 ms
[sonar:sonar] [INFO] Sensor SquidSensor...
[sonar:sonar] [INFO] Java AST scan...

BUILD FAILED
/usr/local/jenkins/jobs/sonar-ant-sample/workspace/sonar-ant-sample/build.xml:22: org.sonar.squid.api.AnalysisException: Got an exception - unexpected char: 0xFFFD, file : /usr/local/jenkins/jobs/sonar-ant-sample/workspace/sonar-ant-sample/src/test/Class00.java, line : 6
at org.sonar.java.ast.CheckstyleAuditListener.addError(CheckstyleAuditListener.java:40)
at com.puppycrawl.tools.checkstyle.Checker.fireErrors(Checker.java:513)
at com.puppycrawl.tools.checkstyle.Checker.process(Checker.java:279)
at org.sonar.java.ast.JavaAstScanner.launchCheckstyleEngine(JavaAstScanner.java:75)
at org.sonar.java.ast.JavaAstScanner.scanFiles(JavaAstScanner.java:138)
at org.sonar.plugins.squid.SquidExecutor.scanSources(SquidExecutor.java:166)
at org.sonar.plugins.squid.SquidExecutor.scan(SquidExecutor.java:87)
at org.sonar.plugins.squid.SquidSensor.analyzeMainSources(SquidSensor.java:78)
at org.sonar.plugins.squid.SquidSensor.analyse(SquidSensor.java:62)
at org.sonar.batch.phases.SensorsExecutor.execute(SensorsExecutor.java:59)
at org.sonar.batch.phases.Phases.execute(Phases.java:75)
at org.sonar.batch.ProjectBatch.execute(ProjectBatch.java:55)
at org.sonar.batch.Batch.analyzeModule(Batch.java:158)
at org.sonar.batch.Batch.analyzeModules(Batch.java:76)
at org.sonar.batch.Batch.execute(Batch.java:62)
at org.sonar.ant.Launcher.executeBatch(Launcher.java:121)
at org.sonar.ant.Launcher.execute(Launcher.java:60)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
at java.lang.reflect.Method.invoke(Method.java:597)
at org.sonar.ant.SonarTask.delegateExecution(SonarTask.java:167)
at org.sonar.ant.SonarTask.execute(SonarTask.java:151)
at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:291)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
at java.lang.reflect.Method.invoke(Method.java:597)
at org.apache.tools.ant.dispatch.DispatchUtils.execute(DispatchUtils.java:106)
at org.apache.tools.ant.Task.perform(Task.java:348)
at org.apache.tools.ant.Target.execute(Target.java:390)
at org.apache.tools.ant.Target.performTasks(Target.java:411)
at org.apache.tools.ant.Project.executeSortedTargets(Project.java:1399)
at org.apache.tools.ant.Project.executeTarget(Project.java:1368)
at org.apache.tools.ant.helper.DefaultExecutor.executeTargets(DefaultExecutor.java:41)
at org.apache.tools.ant.Project.executeTargets(Project.java:1251)
at org.apache.tools.ant.Main.runBuild(Main.java:809)
at org.apache.tools.ant.Main.startAnt(Main.java:217)
at org.apache.tools.ant.launch.Launcher.run(Launcher.java:280)
at org.apache.tools.ant.launch.Launcher.main(Launcher.java:109)

Total time: 6 seconds
Finished: FAILURE
</source>

原因は、CheckStyleが文字コードを正しく認識していないためであると想定します。CheckStyleに文字コードを認識させるためには、「build.xml」で「sonar.sourceEncoding」を指定する必要があります。

ちなみに、本エラーはWindows 7でAntビルドを手動で行った時には発生しませんでした。CentOS 5.5の標準文字コードがUTF-8であるので、標準文字コードとソースコードの文字コードが異なる場合に本事象が発生すると想定します。

参考 : [http://docs.codehaus.org/display/SONAR/Advanced+parameters Advanced parameters - Sonar]

== FindBugs指摘項目の文字化けを回避する ==

FindBugsの日本語向けメッセージファイルである「message_ja.xml」がSHIFT_JISであるためか、Sonarの画面では、FindBugsの指摘項目が文字化けして表示されます。警告箇所をクリックすると、英語で解説が表示されますので大体の問題点は把握できますが、このままでは使いづらいので暫定回避策を記述します。

Sonarのバージョンは2.13前提です。

* Sonar展開先のFindBugsプラグイン「sonar-findbugs-plugin-2.13.jar」を取得する
** 例 : /usr/local/sonar-2.13/lib/core-plugins/sonar-findbugs-plugin-2.13.jar
* sonar-findbugs-plugin-2.13.jar を展開し、FindBugs本体「findbugs-1.3.9.jar」を取得する
* findbugs-1.3.9.jar を展開し、メッセージファイル「message_ja.xml」の文字コードをSHIFT_JISからUTF-8に変換する
** 同時に、ルート要素のencordingプロパティを「UTF-8」とする
* 「sonar-findbugs-plugin-2.13.jar」を作成し直し、元のファイルと置き換える
* '''Sonarタスクを再実行する''' （再実行しないと文字化けしたままです）

少々手間がかかりますが、これで文字化けせずに日本語の指摘項目が表示されます。Sonar側で簡単に回避できる方法が分かれば追記します。

-- 2012年2月12日 (日) 19:10 (JST)

== 参考 ==

* http://docs.codehaus.org/display/SONAR/Analyse+with+ANT

== 更新履歴 ==
* 「[[#FindBugs指摘項目の文字化けを回避する]]」追加 -- 2012年2月12日 (日) 19:11 (JST)
* ページ作成 -- 2011年4月16日 (土) 18:54 (JST)

Ant,Jenkins,Sonarの導入手順

2012-02-12T10:11:45Z

Admin: /* 更新履歴 */

Ant,Jenkins,Sonarの導入手順

2012-02-12T10:10:50Z

Admin: /* トラブルシューティング */

[[Category:ソフトウェア開発]]

本ページでは、Javaソフトウェア管理ツール群である、Ant・Jenkins・Sonarの導入手順を記述します。[[Maven,Jenkins,Sonarの導入手順]]と異なるのは、ビルドツールにMavenではなくAntを使用している点です。

Mavenは、ディレクトリ構成といった各種ルールが予め定義されているため、標準に従えばビルド作業が効率よく行える反面、自由度が低いため融通が利かないという性質があります。Mavenを導入していないプロジェクトに対してSonarによる品質チェックを行いたい場合、Mavenのルールに無理やり適合させて既存の構成を変更してしまうことは得策とは言えません。[http://www.sonarsource.org/sonar-2-6-adds-continuous-inspection-support-for-ant-community/#more-4887 Sonar 2.6]からAntによるビルドでもSonarを使用でるようになりましたので、その手順を記述します。

参考 : [[Maven,Jenkins,Sonarの導入手順]]

== 環境 ==

* OS : CentOS 5.5
* Ant : 1.8.2
* Jenkins : 1.406
* Sonar : 2.7
* Tomcat : 7.0.12
* MySQL : 5.1.54

== インストール ==

Jenkins, Tomcat, MySQLのインストール方法は、[[Maven,Jenkins,Sonarの導入手順#インストール]]を参照ください。

=== Ant ===

入手先 : http://ant.apache.org/

$ tar zxvf apache-ant-1.8.2-bin.tar.gz
# mv apache-ant-1.8.2 /usr/local/

=== Sonar ===

入手先 : http://www.sonarsource.com/

$ unzip sonar-2.7.zip
# mv sonar-2.7 /usr/local/

=== Sonar Ant Task ===

入手先 : http://docs.codehaus.org/display/SONAR/Analyse+with+ANT

上記ページからSonar Ant Taskをダウンロードします。

ダウンロードした「sonar-ant-task-1.0.jar」ファイルを「/usr/local/apache-ant-1.8.2/lib/」に移動します。

== 設定 ==

Jenkins, Sonar, Tomcat, MySQLのインストール方法は、[[Maven,Jenkins,Sonarの導入手順#設定]]を参照ください。

=== その他 ===

「ANT_HOME」の環境変数を設定します。

export ANT_HOME=/usr/local/apache-ant-1.8.2/

JenkinsがAntのコマンドである「ant」を実行するために、「/usr/local/apache-ant-1.8.2/bin/」をPATHに加えます。

== 起動 ==

起動方法は[[Maven,Jenkins,Sonarの導入手順#起動]]を参照ください。

== Sonarの品質管理画面を更新 ==

EclipseでJavaプロジェクトを作成し、Sonarの品質管理画面を更新する場合の手順を記述します。Subversionの使用方法は[[Maven,Jenkins,Sonarの導入手順#Subversionリポジトリを作成する]]を参考にしてください。

=== Javaプロジェクトの作成 ===

Javaプロジェクトのルートディレクトリに「build.xml」ファイルを作成します。ファイルの作成例を以下に示します。

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<project name="sample" default="compile" basedir="." xmlns:sonar="antlib:org.sonar.ant">
<description>Sonarサンプル</description>
<property environment="env" />
<property name="src" location="src"/>
<property name="build" location="bin"/>

<taskdef uri="antlib:org.sonar.ant" resource="org/sonar/ant/antlib.xml">
<classpath path="${env.ANT_HOME}/lib/sonar-ant-task-1.0.jar" />
</taskdef>

<target name="init">
<tstamp/>
<mkdir dir="${build}"/>
</target>

<target name="compile" depends="init" description="compile the source">
<javac srcdir="${src}" destdir="${build}" encoding="MS932" />
</target>

<target name="sonar" description="analyze project" >
<sonar:sonar workDir="/tmp/sonar/test00" key="com.example.test00:test00" version="0.1">
<property key="sonar.jdbc.url" value="jdbc:mysql://${env.SONAR_HOST_NAME}:3306/sonar?useUnicode=true&characterEncoding=utf8" />
<property key="sonar.jdbc.driverClassName" value="com.mysql.jdbc.Driver" />
<property key="sonar.jdbc.username" value="sonar" />
<property key="sonar.jdbc.password" value="sonar" />
<property key="sonar.host.url" value="http://${env.SONAR_HOST_NAME}:8080/sonar" />
<property key="sonar.sourceEncoding" value="MS932" />

<sources>
<path location="${src}" />
</sources>

<property key="sonar.projectName" value="Sonarサンプル" />
<property key="sonar.dynamicAnalysis" value="false" />
</sonar:sonar>
</target>

<target name="clean" description="clean up" >
<delete dir="${build}"/>
</target>
</project>
</source>

SonarとMySQLが動作するサーバを環境変数「SONAR_HOST_NAME」から取得します。「SONAR_HOST_NAME」の環境変数を設定します。

export SONAR_HOST_NAME=<HOST_NAME>

動的な値にする必要が無ければ、環境変数による設定でなくホスト名を直接入力しても問題ありません。

今回使用したプロジェクトのエンコードは「UTF-8」でなく「MS932」のため、javacのencoding属性、sonar:sonarのproperty要素に「MS932」の記述を追記しています。

=== Jenkinsでジョブを設定する ===

最初に、「Jenkinsの管理」->「システムの設定」からAntの設定を行います。

[[ファイル:Install sonar ant 01.png|600px]]

次に、「新規ジョブ作成」からジョブを作成します。

[[ファイル:Install sonar ant 02.png|600px]]

「ソースコード管理システム」と「ビルド」の項目を変更します。

[[ファイル:Install sonar ant 03.png|600px]]

「ビルド実行」を選択すると、ビルドが開始されます。コンソール出力の最後に「Finished: SUCCESS」と表示されていれば、正常に終了しています。

[[ファイル:Install sonar ant 04.png|600px]]

「http://<ホスト名>:8080/sonar」にアクセスすると、「Sonarサンプル」が追加されています。

[[ファイル:Install sonar ant 05.png|600px]]

[[ファイル:Install sonar ant 06.png|600px]]

== トラブルシューティング ==

=== Sonar実行時に「org.sonar.squid.api.AnalysisException: Got an exception - unexpected char: 0xXXXX」が表示される ===

ソースコードのエンコーディングが「MS932」の場合、以下のエラーメッセージが表示されることがあります。

<source lang="text">
sonar:
[sonar:sonar] Apache Ant(TM) version 1.8.2 compiled on December 20 2010
[sonar:sonar] Sonar Ant Task version: 1.0
[sonar:sonar] Loaded from: file:/usr/local/apache-ant-1.8.2/lib/sonar-ant-task-1.0.jar
[sonar:sonar] Sonar work directory: /tmp/sonar/test00
[sonar:sonar] Sonar server: http://127.0.0.1:8080/sonar
[sonar:sonar] Sonar version: 2.7
[sonar:sonar] [INFO] Database dialect class org.sonar.jpa.dialect.MySql
[sonar:sonar] [INFO] Execution environment: Ant Apache Ant(TM) version 1.8.2 compiled on December 20 2010
[sonar:sonar] [INFO] ------------- Analyzing Sonarサンプル
[sonar:sonar] [INFO] Selected quality profile : [name=Sonar way,language=java]
[sonar:sonar] [INFO] Compare to previous analysis (2011-04-16)
[sonar:sonar] [INFO] Compare over 5 days (2011-04-11, analysis of 2011-04-16 21:02:18.0)
[sonar:sonar] [INFO] Compare over 30 days (2011-03-17, analysis of 2011-04-16 21:02:18.0)
[sonar:sonar] [INFO] Configure maven plugins...
[sonar:sonar] [INFO] Sensor AsynchronousMeasuresSensor...
[sonar:sonar] [INFO] Sensor AsynchronousMeasuresSensor done: 90 ms
[sonar:sonar] [INFO] Sensor SquidSensor...
[sonar:sonar] [INFO] Java AST scan...

BUILD FAILED
/usr/local/jenkins/jobs/sonar-ant-sample/workspace/sonar-ant-sample/build.xml:22: org.sonar.squid.api.AnalysisException: Got an exception - unexpected char: 0xFFFD, file : /usr/local/jenkins/jobs/sonar-ant-sample/workspace/sonar-ant-sample/src/test/Class00.java, line : 6
at org.sonar.java.ast.CheckstyleAuditListener.addError(CheckstyleAuditListener.java:40)
at com.puppycrawl.tools.checkstyle.Checker.fireErrors(Checker.java:513)
at com.puppycrawl.tools.checkstyle.Checker.process(Checker.java:279)
at org.sonar.java.ast.JavaAstScanner.launchCheckstyleEngine(JavaAstScanner.java:75)
at org.sonar.java.ast.JavaAstScanner.scanFiles(JavaAstScanner.java:138)
at org.sonar.plugins.squid.SquidExecutor.scanSources(SquidExecutor.java:166)
at org.sonar.plugins.squid.SquidExecutor.scan(SquidExecutor.java:87)
at org.sonar.plugins.squid.SquidSensor.analyzeMainSources(SquidSensor.java:78)
at org.sonar.plugins.squid.SquidSensor.analyse(SquidSensor.java:62)
at org.sonar.batch.phases.SensorsExecutor.execute(SensorsExecutor.java:59)
at org.sonar.batch.phases.Phases.execute(Phases.java:75)
at org.sonar.batch.ProjectBatch.execute(ProjectBatch.java:55)
at org.sonar.batch.Batch.analyzeModule(Batch.java:158)
at org.sonar.batch.Batch.analyzeModules(Batch.java:76)
at org.sonar.batch.Batch.execute(Batch.java:62)
at org.sonar.ant.Launcher.executeBatch(Launcher.java:121)
at org.sonar.ant.Launcher.execute(Launcher.java:60)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
at java.lang.reflect.Method.invoke(Method.java:597)
at org.sonar.ant.SonarTask.delegateExecution(SonarTask.java:167)
at org.sonar.ant.SonarTask.execute(SonarTask.java:151)
at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:291)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
at java.lang.reflect.Method.invoke(Method.java:597)
at org.apache.tools.ant.dispatch.DispatchUtils.execute(DispatchUtils.java:106)
at org.apache.tools.ant.Task.perform(Task.java:348)
at org.apache.tools.ant.Target.execute(Target.java:390)
at org.apache.tools.ant.Target.performTasks(Target.java:411)
at org.apache.tools.ant.Project.executeSortedTargets(Project.java:1399)
at org.apache.tools.ant.Project.executeTarget(Project.java:1368)
at org.apache.tools.ant.helper.DefaultExecutor.executeTargets(DefaultExecutor.java:41)
at org.apache.tools.ant.Project.executeTargets(Project.java:1251)
at org.apache.tools.ant.Main.runBuild(Main.java:809)
at org.apache.tools.ant.Main.startAnt(Main.java:217)
at org.apache.tools.ant.launch.Launcher.run(Launcher.java:280)
at org.apache.tools.ant.launch.Launcher.main(Launcher.java:109)

Total time: 6 seconds
Finished: FAILURE
</source>

原因は、CheckStyleが文字コードを正しく認識していないためであると想定します。CheckStyleに文字コードを認識させるためには、「build.xml」で「sonar.sourceEncoding」を指定する必要があります。

ちなみに、本エラーはWindows 7でAntビルドを手動で行った時には発生しませんでした。CentOS 5.5の標準文字コードがUTF-8であるので、標準文字コードとソースコードの文字コードが異なる場合に本事象が発生すると想定します。

参考 : [http://docs.codehaus.org/display/SONAR/Advanced+parameters Advanced parameters - Sonar]

== FindBugs指摘項目の文字化けを回避する ==

FindBugsの日本語向けメッセージファイルである「message_ja.xml」がSHIFT_JISであるためか、Sonarの画面では、FindBugsの指摘項目が文字化けして表示されます。警告箇所をクリックすると、英語で解説が表示されますので大体の問題点は把握できますが、このままでは使いづらいので暫定回避策を記述します。

Sonarのバージョンは2.13前提です。

* Sonar展開先のFindBugsプラグイン「sonar-findbugs-plugin-2.13.jar」を取得する
** 例 : /usr/local/sonar-2.13/lib/core-plugins/sonar-findbugs-plugin-2.13.jar
* sonar-findbugs-plugin-2.13.jar を展開し、FindBugs本体「findbugs-1.3.9.jar」を取得する
* findbugs-1.3.9.jar を展開し、メッセージファイル「message_ja.xml」の文字コードをSHIFT_JISからUTF-8に変換する
** 同時に、ルート要素のencordingプロパティを「UTF-8」とする
* 「sonar-findbugs-plugin-2.13.jar」を作成し直し、元のファイルと置き換える
* '''Sonarタスクを再実行する''' （再実行しないと文字化けしたままです）

少々手間がかかりますが、これで文字化けせずに日本語の指摘項目が表示されます。Sonar側で簡単に回避できる方法が分かれば追記します。

-- 2012年2月12日 (日) 19:10 (JST)

== 参考 ==

* http://docs.codehaus.org/display/SONAR/Analyse+with+ANT

== 更新履歴 ==
* ページ作成 -- 2011年4月16日 (土) 18:54 (JST)

Androidメモ

2011-09-11T14:38:56Z

Admin:

[[Category:ソフトウェア開発]] [[Category:Java]]

Android開発関連のメモを残します。

== Android Test Projectで外部jarのクラスを使用する ==

テスト対象のプロジェクトで取り込んでいるjarのクラスを使用するために、テストプロジェクトで同じjarをビルドパスに加えると、テスト実行中に以下のようなエラーが表示します。

<source lang="text">
[2011-09-11 23:13:53 - Sample_Android_Test] Launching instrumentation android.test.InstrumentationTestRunner on device emulator-5554
[2011-09-11 23:13:53 - Sample_Android_Test] Collecting test information
[2011-09-11 23:13:55 - Sample_Android_Test] Sending test information to Eclipse
[2011-09-11 23:13:55 - Sample_Android_Test] テストの実行...
[2011-09-11 23:13:57 - Sample_Android_Test] Test run failed: Class ref in pre-verified class resolved to unexpected implementation
[2011-09-11 23:13:57 - Sample_Android_Test] Test run finished
[2011-09-11 23:16:04 - Sample_Android_Test] ------------------------------
</source>

解決するには、テストプロジェクトでjarをビルドバスに加えるのではなく、テスト元プロジェクトのエクスポートするエントリーに該当するjarを追加する必要があります。

以下の画像を参考にし、エクスポートしたいjarのチェックをONにします。

[[ファイル:Android unit test jar 00.png|600px]]

* 環境
** Android SDK Revision 10
** IDE : Eclipse 3.6 (pleiades)
* 参考
** http://dtmilano.blogspot.com/2009/12/android-testing-external-libraries.html

-- 2011年9月11日 (日) 23:38 (JST)

== 「Android SDK and AVD Manager」で使用するProxy接続設定をテキストファイルから指定する ==

ホームディレクトリの「.android」ディレクトリにある「androidtool.cfg」ファイルを以下のように設定します。

<source lang="text">
### Settings for Android Tool
#Wed Apr 06 16:30:33 JST 2011
http.proxyPort=3128
sdkman.monitor.density=96
http.proxyHost=192.168.1.100
sdkman.show.update.only=true
sdkman.ask.adb.restart=true
sdkman.force.http=true
</source>

ビルドサーバといったGUIを持たないマシンの場合、テキストファイルを直接編集した方が効率的です。

* 動作環境
** Android SDK r10

== コマンドラインでAndroid SDKのパッケージをインストールするには ==

以下コマンドを実行します。

android update sdk -u

== 更新履歴 ==

* [[#Android Test Projectで外部jarのクラスを使用する]]追加 -- 2011年9月11日 (日) 23:38 (JST)
* ページ作成 -- 2011年4月16日 (土) 23:30 (JST)

Androidメモ

2011-09-11T14:38:01Z

Admin:

[[Category:ソフトウェア開発]] [[Category:Java]]

== Android Test Projectで外部jarのクラスを使用する ==

テスト対象のプロジェクトで取り込んでいるjarのクラスを使用するために、テストプロジェクトで同じjarをビルドパスに加えると、テスト実行中に以下のようなエラーが表示します。

<source lang="text">
[2011-09-11 23:13:53 - Sample_Android_Test] Launching instrumentation android.test.InstrumentationTestRunner on device emulator-5554
[2011-09-11 23:13:53 - Sample_Android_Test] Collecting test information
[2011-09-11 23:13:55 - Sample_Android_Test] Sending test information to Eclipse
[2011-09-11 23:13:55 - Sample_Android_Test] テストの実行...
[2011-09-11 23:13:57 - Sample_Android_Test] Test run failed: Class ref in pre-verified class resolved to unexpected implementation
[2011-09-11 23:13:57 - Sample_Android_Test] Test run finished
[2011-09-11 23:16:04 - Sample_Android_Test] ------------------------------
</source>

解決するには、テストプロジェクトでjarをビルドバスに加えるのではなく、テスト元プロジェクトのエクスポートするエントリーに該当するjarを追加する必要があります。

以下の画像を参考にし、エクスポートしたいjarのチェックをONにします。

[[ファイル:Android unit test jar 00.png|600px]]

* 環境
** Android SDK Revision 10
** IDE : Eclipse 3.6 (pleiades)
* 参考
** http://dtmilano.blogspot.com/2009/12/android-testing-external-libraries.html

-- 2011年9月11日 (日) 23:38 (JST)

== 「Android SDK and AVD Manager」で使用するProxy接続設定をテキストファイルから指定する ==

ホームディレクトリの「.android」ディレクトリにある「androidtool.cfg」ファイルを以下のように設定します。

<source lang="text">
### Settings for Android Tool
#Wed Apr 06 16:30:33 JST 2011
http.proxyPort=3128
sdkman.monitor.density=96
http.proxyHost=192.168.1.100
sdkman.show.update.only=true
sdkman.ask.adb.restart=true
sdkman.force.http=true
</source>

ビルドサーバといったGUIを持たないマシンの場合、テキストファイルを直接編集した方が効率的です。

* 動作環境
** Android SDK r10

== コマンドラインでAndroid SDKのパッケージをインストールするには ==

以下コマンドを実行します。

android update sdk -u

== 更新履歴 ==

* [[#Android Test Projectで外部jarのクラスを使用する]]追加 -- 2011年9月11日 (日) 23:38 (JST)
* ページ作成 -- 2011年4月16日 (土) 23:30 (JST)

ファイル:Android unit test jar 00.png

2011-09-11T14:32:48Z

Admin:

Linuxシステム設定

2011-08-09T14:43:14Z

Admin: /* iptables設定例 */

[[Category:Tips]]

== patch作成手順 ==

パッチ作成
diff <変更元ファイル> <変更後ファイル> > <パッチファイル>

パッチ当て
patch <変更元ファイル> < <パッチファイル>

-- 2010年11月26日 (金) 04:02 (UTC)

== rootユーザでNFSをマウントする ==

NFSサーバ側
exportfs -o rw,no_root_squash *:<公開ディレクトリ>

NFSクライアント側
mount -t nfs サーバホスト名:<公開ディレクトリ> <マウントパス>

-- 2010年11月24日 (水) 05:42 (UTC)

== telnetデーモンを起動する（RHEL 5.5） ==

「/etc/xinetd.d/ekrb5-telnet」ファイルの「disable」の値を「yes」に変更し、xinetdサービスを再起動します。

-- 2010年11月10日 (水) 08:05 (UTC)

== メンテナンスモードにてファイルを書き込む ==

デフォルトでは読み取り専用となっています。

# mount -o remount rw /

-- 2010年7月25日 (日) 14:53 (UTC)

== iptables設定例 ==
# iptables -F
# iptables -X
# iptables -A INPUT -m state --state ESTABLISHED,RELATED -j ACCEPT
# iptables -A INPUT -i lo -j ACCEPT
# iptables -A INPUT -p icmp -j ACCEPT
# iptables -A INPUT -p tcp --dport 22 -m state --state NEW -j ACCEPT
# iptables -A INPUT -p tcp --dport 25 -m state --state NEW -j ACCEPT
# iptables -A INPUT -p tcp --dport 110 -m state --state NEW -j ACCEPT
# iptables -P INPUT DROP

== NTPサーバ起動直後、時刻同期が出来ない問題 ==

ntpdを起動後、しばらくはクライアントとの時刻同期はできません。Windows XPにて時刻の同期を行うと、下記のメッセージが表示されます。

<IPアドレス> と同期中にエラーが発生しました。タイムサンプルは拒否されました。ピアの階層は、ホストの階層よりも少ないです。

ntpdは、起動してから数分経過するまで、時刻情報を提供しないようです。時刻情報を提供する状態となっているかは、下記より判断可能です。

# ntpq
ntpd起動直後 :
ntpq> rv
assID=0 status=c011 sync_alarm, sync_unspec, 1 event, event_restart,
version="ntpd 4.2.0a@1.1190-r Sat May 5 12:52:53 EDT 2007 (1)"?,
processor="x86_64", system="Linux/2.6.9-67.EL", leap=11, stratum=16,
precision=-20, rootdelay=0.000, rootdispersion=0.045, peer=0,
refid=INIT, reftime=00000000.00000000 Thu, Feb 7 2036 15:28:16.000,
poll=6, clock=0xcd5d0b34.44b23140, state=1, offset=0.000,
frequency=0.000, noise=0.001, jitter=0.001, stability=0.000
ntpq> pe
remote refid st t when poll reach delay offset jitter
==============================================================================
LOCAL(0) .INIT. 0 l 4 64 1 0.000 0.000 0.001

4分後 :
ntpq> rv
assID=0 status=0544 leap_none, sync_local_proto, 4 events, event_peer/strat_chg,
version="ntpd 4.2.0a@1.1190-r Sat May 5 12:52:53 EDT 2007 (1)"?,
processor="x86_64", system="Linux/2.6.9-67.EL", leap=00, stratum=1,
precision=-20, rootdelay=0.000, rootdispersion=949.897, peer=38948,
refid=INIT, reftime=cd5d0bf3.1fe5753a Sun, Mar 8 2009 0:06:27.124,
poll=6, clock=0xcd5d0c24.5e684cf0, state=4, offset=0.000,
frequency=0.000, noise=0.001, jitter=0.001, stability=0.000
ntpq> pe
remote refid st t when poll reach delay offset jitter
==============================================================================
*LOCAL(0) .INIT. 0 l 50 64 17 0.000 0.000 0.001

rvコマンドの1行目の値が変化しています。peコマンドで得られる「reach」値が「17」になると、時刻同期が可能になります。

参考 : 徒然ブログ / http://blog.c--v.net/2007/02/15/3

作成 : 2009/03/08

== qmailサブミッションポート対応後の起動コマンド ==

起動コマンドを以下とします。前提条件として、vpopmailとtcpserverとsmtp-authの導入が必要です。

/var/qmail/bin/splogger pop3d 3 &
/usr/local/bin/tcpserver -R -H -x \
/home/vpopmail/etc/tcp.smtp.cdb -u vpopmail -g vchkpw 0 smtp \
/var/qmail/bin/qmail-smtpd <ホスト名> /home/vpopmail/bin/vchkpw /bin/true &

/usr/local/bin/tcpserver -R -H -x \
/home/vpopmail/etc/tcp.smtp.cdb -u vpopmail -g vchkpw 0 submission \
/var/qmail/bin/qmail-smtpd <ホスト名> /home/vpopmail/bin/vchkpw /bin/true &

<ホスト名>には、自サーバのホスト名（osmemo.info等）を入力してください。

作成 : 2009/08/18

== 更新履歴 ==

* 「patch作成手順」追加 -- 2010年11月26日 (金) 04:02 (UTC)
* 「メンテナンスモードにてファイルを書き込む」追加 -- 2010年7月25日 (日) 14:53 (UTC)
*2009/08/18
**「qmailサブミッションポート対応後の起動コマンド」追加
*2009/03/08
**「NTPサーバ起動直後、時刻同期が出来ない問題」追加

Redmineの導入手順

2011-08-08T18:55:47Z

Admin: /* Advenced roadmapのソースコード修正 */

[[Category:ソフトウェア開発]][[Category:導入手順]]

本ページでは、Rubyで作成されたバグトラッキングシステムである「Redmine」の導入手順を記述します。バージョン管理システムである「Mercurial」も同時にインストールします。

== 環境 ==

* OS : CentOS 5.4
* Web Server : Apache 2.2.17
* Database : MySQL 5.1.54
* Other : Redmine 1.1.0, Ruby 1.8.7, rubygems 1.4.2, Mercurial 1.7.3

== インストール ==

=== MySQL ===

入手先 :http://www.mysql.com/

<source lang="text">
$ tar zxvf mysql-5.1.54.tar.gz
$ cd mysql-5.1.54
$ ./configure
$ make
# make install
</source>

=== Apache ===

入手先 : http://httpd.apache.org/

<source lang="text">
$ tar zxvf httpd-2.2.17.tar.gz
$ cd httpd-2.2.17
$ ./configure
$ make
# make install
</source>

=== Ruby ===

入手先 : http://www.ruby-lang.org/

<source lang="text">
$ tar zxvf ruby-1.8.7-p330.tar.gz
$ cd ruby-1.8.7-p330
$ ./configure
$ make
# make install
</source>

=== RubyGems ===

入手先 : http://rubyforge.org/projects/rubygems/

<source lang="text">
$ tar zxvf rubygems-1.4.2.tgz
$ cd rubygems-1.4.2
# ruby setup.rb
</source>

=== Ruby on Rails ===

RubyGemsからインストールします。[http://www.redmine.org/projects/redmine/wiki/RedmineInstall 公式サイト]にある通り、バージョン2.3.5のRailsをインストールします。

<source lang="text">
# gem install rails -v 2.3.5
</source>

=== Docutils ===

Mercurialをインストールするための準備として、Docutilsをインストールします。

入手先 : http://docutils.sourceforge.net/

<source lang="text">
$ tar zxvf docutils-0.7
$ cd docutils-0.7
# ./setup.py install
</source>

Pythonはインストール済みとします。

=== Mercurial ===

入手先 : http://mercurial.selenic.com/

<source lang="text">
$ tar zxvf mercurial-1.7.3.tar.gz
$ cd mercurial-1.7.3
$ make all
# make install
</source>

=== Redmine ===

入手先 : http://www.redmine.org/

<source lang="text">
$ tar zxvf redmine-1.1.0.tar.gz
# gem install -v=0.4.2 i18n
# mv redmine-1.1.0 /var/lib/redmine
# cd /var/lib/redmine/
# rake generate_session_store
</source>

i18nはrakeに必要なためインストールします。

=== Passenger ===

Passengerをインストールします。
<source lang="text">
# gem install passenger
</source>

Apache用モジュールをインストールします。
<source lang="text">
# export APXS2=/usr/local/apache2/bin/apxs
# export PATH=/usr/local/apache2/bin:$PATH
# passenger-install-apache2-module
</source>

「Please edit your Apache configuration file, and add these lines:」の次の3行を控えて置きます。後に「httpd.conf」の設定で必要になります。
<source lang="text">
The Apache 2 module was successfully installed.

Please edit your Apache configuration file, and add these lines:

LoadModule passenger_module /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2/ext/apache2/mod_passenger.so
PassengerRoot /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2
PassengerRuby /usr/local/bin/ruby

After you restart Apache, you are ready to deploy any number of Ruby on Rails
applications on Apache, without any further Ruby on Rails-specific
configuration!

Press ENTER to continue.
</source>

=== MySQL用のデータベースアクセスライブラリ ===

MySQL用のデータベースアクセスライブラリをインストールします。

<source lang="text">
# gem install mysql -- --with-mysql-lib=/usr/local/lib/mysql/
</source>

インストール中に「No definition for ...」から始まる行がいくつか出力されます。

「ld.so.conf」に「/usr/local/lib/mysql/」を追加します。
<source lang="text">
# vim /etc/ld.so.conf
</source>

共有ライブラリを再認識させます。
<source lang="text">
# /sbin/ldconfig
</source>

== 設定 ==

=== MySQL ===

ユーザ「mysql」を作成し、DBを初期化します。

<source lang="text">
# /usr/sbin/useradd mysql
# /usr/local/bin/mysql_install_db --user=mysql
</source>

DBを起動し、rootのパスワードを設定します。

<source lang="text">
# /usr/local/bin/mysqld_safe --user=mysql &
# /usr/local/bin/mysqladmin -u root password <password>
</source>

Redmineでアクセスするためのユーザ（redmine）を作成し、DBを作成します。

<source lang="text">
# mysql -u root -p
</source>

<source lang="sql">
mysql> grant all privileges on *.* to redmine@localhost identified by '<パスワード>' with grant option;
mysql> create database redmine default character set utf8;
</source>

RedmineのDB接続設定を行います。

<source lang="text">
$ cd /var/lib/redmine/config/
$ cp database.yml.example database.yml
$ vim database.yml
</source>

productionのセクションの「username:」に先ほど作成したユーザ名、「password:」にDBパスワードを追記します。
<source lang="text">
production:
adapter: mysql
database: redmine
host: localhost
username: redmine
password: <パスワード>
encoding: utf8
</source>

DBを初期化します。
<source lang="text">
# rake db:migrate RAILS_ENV=production
</source>

本コマンドで、以下のメッセージが表示される場合は、共有ライブラリの設定が不十分かもしれません。
<source lang="text">
(in /var/lib/redmine)
rake aborted!
Object is not missing constant Issue!

(See full trace by running task with --trace)
</source>

標準のワークフローを導入します。
<source lang="text">
# rake redmine:load_default_data RAILS_ENV=production
</source>
「Select language:」と表示されたら「ja」を入力します。

=== Apache ===

「/usr/local/apache2/conf/httpd.conf」を編集します。

DocumentRootを以下に変更します。
<source lang="text">
# DocumentRoot "/usr/local/apache2/htdocs"
DocumentRoot "/var/lib/redmine/public"
</source>

以下を追記します。
<source lang="text">
<Directory "/var/lib/redmine/public">
Options Indexes FollowSymLinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>

LoadModule passenger_module /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2/ext/apache2/mod_passenger.so
PassengerRoot /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2
PassengerRuby /usr/local/bin/ruby
</source>
下の3行は、「passenger-install-apache2-module」の出力結果を必ず貼り付けてください。

== 起動 ==

=== MySQL ===

# /usr/local/bin/mysqld_safe --user=mysql &

=== Apache ===

# /usr/local/apache2/bin/apachectl start

Apache起動後、Redmine初期画面は以下のようになります。

[[ファイル:Redmine install.png|600px]]

[http://blog.redmine.jp/articles/farend-basic-theme/ farend basic]というテーマを使用しています。

== トラブルシューティング ==

=== 「rake db:migrate RAILS_ENV=production」コマンド実行時にエラーが発生する。 ===

以下のエラーメッセージが表示された場合、「rake generate_session_store」コマンドの実行が漏れている可能性があります。

<source lang="text">
(in /var/lib/redmine)
rake aborted!
A key is required to write a cookie containing the session data. Use config.action_controller.session = { :key => "_myapp_session", :secret => "some secret phrase" } in config/environment.rb

(See full trace by running task with --trace)
</source>

== RedmineでMercurialリポジトリを参照する ==

=== 作成手順 ===

Mercurialのリポジトリを作成し、hgrcファイルを編集します。

mkdir /var/lib/hg/test00
cd /var/lib/hg/test00
vim .hg/hgrc

hgrcファイルの内容は以下とします。

[web]
allow_push = *
push_ssl = false

Webサーバを立ち上げます。

hg serve --port 8002

[設定]->[リポジトリ]のページで以下のように設定します。

[[ファイル:Install redmine 01.png|600px]]

[リポジトリ]のページを参照すると、Mercurialのリポジトリを参照できます。

[[ファイル:Install redmine 02.png|600px]]

上記画像で文字化けしているテキストファイルは、「新しいテキストドキュメント.txt」という名前のファイルです。これは、ページの文字コードが「UTF-8」に対して、ファイルの文字コードが「Shift_JIS」であるために発生します。

=== 日本語ファイル名を含むファイルの履歴が表示されない ===

英字だけのファイル名の場合、履歴が正常に表示されます。

[[ファイル:Install redmine 03.png|600px]]

日本語を含むファイル名の場合、履歴が表示されません。ただし、ダウンロードはできます。

[[ファイル:Install redmine 04.png|600px]]

=== Root directoryをhttpプロトコルで指定すると参照できない ===

Root directoryを「http://192.168.100.6:8002/」等のhttpで指定すると、リポジトリ参照ができません。（一応、Webアクセス時、GETメソッドを使用しているようですが）

[[ファイル:Install redmine 05.png|600px]]

[[ファイル:Install redmine 06.png|600px]]

そもそも、想定外の指定方法かも知れません。（要調査）

== その他 ==

=== RMagickをインストールする ===

プラグイン[https://ociotec.com/redmine/projects/show/advanced-roadmap Adcanced roadmap]をインストールするためには[http://rmagick.rubyforge.org/ RMagick]が必要となります。

RMagickをインストールするまでの手順は以下となります。

==== FreeType ====

ImageMagickにてTrueTypeフォントを使用するため、FreeTypeをインストールします。

# yum install freetype freetype-devel

==== libpngのインストール ====

入手先 : http://www.libpng.org/pub/png/libpng.html

PNG形式のグラフを出力するときに使用するライブラリです。

$ tar zxvf libpng-1.5.4.tar.gz
$ cd libpng-1.5.4
$ ./configure
$ make
$ su
# make install

==== ImageMagickのインストール ====

入手先 : http://www.imagemagick.org/script/index.php

$ tar zxvf ImageMagick.tar.gz
$ cd ImageMagick-6.7.1-3
$ ./configure
$ make
$ su
# make install

==== RMagickのインストール ====

$ gem install rmagick

==== Advenced roadmapのソースコード修正 ====

標準では、Advanced roadmapのグラフの凡例が文字化けするので、「vendor/plugins/advanced_roadmap/lib/advanced_roadmap/gruff/base.rb」を修正します。

修正例 :
<source lang="diff">
226,227c226,228
< vera_font_path = File.expand_path('Vera.ttf', ENV['MAGICK_FONT_PATH'])
< @font = File.exists?(vera_font_path) ? vera_font_path : nil
---
> # vera_font_path = File.expand_path('Vera.ttf', ENV['MAGICK_FONT_PATH'])
> # @font = File.exists?(vera_font_path) ? vera_font_path : nil
> @font = "/usr/share/fonts/japanese/TrueType/sazanami-gothic.ttf"
</source>

参考 :
* http://groups.google.com/group/redmine-users-ja/browse_thread/thread/13410c0c0c809dc6

インストールは以上です。

-- 2011年8月8日 (月) 21:41 (JST)

=== サブディレクトリにRedmineを配置するには ===

通常インストールでは、Redmineのルートは「http://<ホスト名>/」となります。これを、「http://<ホスト名>/test/」とするには以下とします。

「httpd.conf」に以下を追記します。（DocumentRootは「"/usr/local/apache2/htdocs"」のままとします）
RailsBaseURI /test

シンボリックリンクを作成します。
# ln -s /var/lib/redmine/public /usr/local/apache2/htdocs/test

以上の手順により、1サーバで複数のRedmineを構築することも可能です。

=== developmentモードで起動するには ===

「httpd.conf」に以下を追記します。
RailsEnv development

== 参考 ==

* 入門Redmine 第2版 Linux/Windows対応 / 前田剛
* http://redmine.jp/tech_note/apache-passenger/ - Apache上でRuby on Railsアプリケーションを動かす／Passenger(mod_rails for Apache)の利用

== 更新履歴 ==
* [[#RMagickをインストールする]] -- 2011年8月8日 (月) 21:41 (JST)
* [[#RedmineでMercurialリポジトリを参照する]]追加 -- 2011年3月20日 (日) 18:46 (JST)
* ページ作成 -- 2011年1月23日 (日) 16:35 (JST)

Redmineの導入手順

2011-08-08T18:55:33Z

Admin: /* その他 */

[[Category:ソフトウェア開発]][[Category:導入手順]]

本ページでは、Rubyで作成されたバグトラッキングシステムである「Redmine」の導入手順を記述します。バージョン管理システムである「Mercurial」も同時にインストールします。

== 環境 ==

* OS : CentOS 5.4
* Web Server : Apache 2.2.17
* Database : MySQL 5.1.54
* Other : Redmine 1.1.0, Ruby 1.8.7, rubygems 1.4.2, Mercurial 1.7.3

== インストール ==

=== MySQL ===

入手先 :http://www.mysql.com/

<source lang="text">
$ tar zxvf mysql-5.1.54.tar.gz
$ cd mysql-5.1.54
$ ./configure
$ make
# make install
</source>

=== Apache ===

入手先 : http://httpd.apache.org/

<source lang="text">
$ tar zxvf httpd-2.2.17.tar.gz
$ cd httpd-2.2.17
$ ./configure
$ make
# make install
</source>

=== Ruby ===

入手先 : http://www.ruby-lang.org/

<source lang="text">
$ tar zxvf ruby-1.8.7-p330.tar.gz
$ cd ruby-1.8.7-p330
$ ./configure
$ make
# make install
</source>

=== RubyGems ===

入手先 : http://rubyforge.org/projects/rubygems/

<source lang="text">
$ tar zxvf rubygems-1.4.2.tgz
$ cd rubygems-1.4.2
# ruby setup.rb
</source>

=== Ruby on Rails ===

RubyGemsからインストールします。[http://www.redmine.org/projects/redmine/wiki/RedmineInstall 公式サイト]にある通り、バージョン2.3.5のRailsをインストールします。

<source lang="text">
# gem install rails -v 2.3.5
</source>

=== Docutils ===

Mercurialをインストールするための準備として、Docutilsをインストールします。

入手先 : http://docutils.sourceforge.net/

<source lang="text">
$ tar zxvf docutils-0.7
$ cd docutils-0.7
# ./setup.py install
</source>

Pythonはインストール済みとします。

=== Mercurial ===

入手先 : http://mercurial.selenic.com/

<source lang="text">
$ tar zxvf mercurial-1.7.3.tar.gz
$ cd mercurial-1.7.3
$ make all
# make install
</source>

=== Redmine ===

入手先 : http://www.redmine.org/

<source lang="text">
$ tar zxvf redmine-1.1.0.tar.gz
# gem install -v=0.4.2 i18n
# mv redmine-1.1.0 /var/lib/redmine
# cd /var/lib/redmine/
# rake generate_session_store
</source>

i18nはrakeに必要なためインストールします。

=== Passenger ===

Passengerをインストールします。
<source lang="text">
# gem install passenger
</source>

Apache用モジュールをインストールします。
<source lang="text">
# export APXS2=/usr/local/apache2/bin/apxs
# export PATH=/usr/local/apache2/bin:$PATH
# passenger-install-apache2-module
</source>

「Please edit your Apache configuration file, and add these lines:」の次の3行を控えて置きます。後に「httpd.conf」の設定で必要になります。
<source lang="text">
The Apache 2 module was successfully installed.

Please edit your Apache configuration file, and add these lines:

LoadModule passenger_module /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2/ext/apache2/mod_passenger.so
PassengerRoot /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2
PassengerRuby /usr/local/bin/ruby

After you restart Apache, you are ready to deploy any number of Ruby on Rails
applications on Apache, without any further Ruby on Rails-specific
configuration!

Press ENTER to continue.
</source>

=== MySQL用のデータベースアクセスライブラリ ===

MySQL用のデータベースアクセスライブラリをインストールします。

<source lang="text">
# gem install mysql -- --with-mysql-lib=/usr/local/lib/mysql/
</source>

インストール中に「No definition for ...」から始まる行がいくつか出力されます。

「ld.so.conf」に「/usr/local/lib/mysql/」を追加します。
<source lang="text">
# vim /etc/ld.so.conf
</source>

共有ライブラリを再認識させます。
<source lang="text">
# /sbin/ldconfig
</source>

== 設定 ==

=== MySQL ===

ユーザ「mysql」を作成し、DBを初期化します。

<source lang="text">
# /usr/sbin/useradd mysql
# /usr/local/bin/mysql_install_db --user=mysql
</source>

DBを起動し、rootのパスワードを設定します。

<source lang="text">
# /usr/local/bin/mysqld_safe --user=mysql &
# /usr/local/bin/mysqladmin -u root password <password>
</source>

Redmineでアクセスするためのユーザ（redmine）を作成し、DBを作成します。

<source lang="text">
# mysql -u root -p
</source>

<source lang="sql">
mysql> grant all privileges on *.* to redmine@localhost identified by '<パスワード>' with grant option;
mysql> create database redmine default character set utf8;
</source>

RedmineのDB接続設定を行います。

<source lang="text">
$ cd /var/lib/redmine/config/
$ cp database.yml.example database.yml
$ vim database.yml
</source>

productionのセクションの「username:」に先ほど作成したユーザ名、「password:」にDBパスワードを追記します。
<source lang="text">
production:
adapter: mysql
database: redmine
host: localhost
username: redmine
password: <パスワード>
encoding: utf8
</source>

DBを初期化します。
<source lang="text">
# rake db:migrate RAILS_ENV=production
</source>

本コマンドで、以下のメッセージが表示される場合は、共有ライブラリの設定が不十分かもしれません。
<source lang="text">
(in /var/lib/redmine)
rake aborted!
Object is not missing constant Issue!

(See full trace by running task with --trace)
</source>

標準のワークフローを導入します。
<source lang="text">
# rake redmine:load_default_data RAILS_ENV=production
</source>
「Select language:」と表示されたら「ja」を入力します。

=== Apache ===

「/usr/local/apache2/conf/httpd.conf」を編集します。

DocumentRootを以下に変更します。
<source lang="text">
# DocumentRoot "/usr/local/apache2/htdocs"
DocumentRoot "/var/lib/redmine/public"
</source>

以下を追記します。
<source lang="text">
<Directory "/var/lib/redmine/public">
Options Indexes FollowSymLinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>

LoadModule passenger_module /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2/ext/apache2/mod_passenger.so
PassengerRoot /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2
PassengerRuby /usr/local/bin/ruby
</source>
下の3行は、「passenger-install-apache2-module」の出力結果を必ず貼り付けてください。

== 起動 ==

=== MySQL ===

# /usr/local/bin/mysqld_safe --user=mysql &

=== Apache ===

# /usr/local/apache2/bin/apachectl start

Apache起動後、Redmine初期画面は以下のようになります。

[[ファイル:Redmine install.png|600px]]

[http://blog.redmine.jp/articles/farend-basic-theme/ farend basic]というテーマを使用しています。

== トラブルシューティング ==

=== 「rake db:migrate RAILS_ENV=production」コマンド実行時にエラーが発生する。 ===

以下のエラーメッセージが表示された場合、「rake generate_session_store」コマンドの実行が漏れている可能性があります。

<source lang="text">
(in /var/lib/redmine)
rake aborted!
A key is required to write a cookie containing the session data. Use config.action_controller.session = { :key => "_myapp_session", :secret => "some secret phrase" } in config/environment.rb

(See full trace by running task with --trace)
</source>

== RedmineでMercurialリポジトリを参照する ==

=== 作成手順 ===

Mercurialのリポジトリを作成し、hgrcファイルを編集します。

mkdir /var/lib/hg/test00
cd /var/lib/hg/test00
vim .hg/hgrc

hgrcファイルの内容は以下とします。

[web]
allow_push = *
push_ssl = false

Webサーバを立ち上げます。

hg serve --port 8002

[設定]->[リポジトリ]のページで以下のように設定します。

[[ファイル:Install redmine 01.png|600px]]

[リポジトリ]のページを参照すると、Mercurialのリポジトリを参照できます。

[[ファイル:Install redmine 02.png|600px]]

上記画像で文字化けしているテキストファイルは、「新しいテキストドキュメント.txt」という名前のファイルです。これは、ページの文字コードが「UTF-8」に対して、ファイルの文字コードが「Shift_JIS」であるために発生します。

=== 日本語ファイル名を含むファイルの履歴が表示されない ===

英字だけのファイル名の場合、履歴が正常に表示されます。

[[ファイル:Install redmine 03.png|600px]]

日本語を含むファイル名の場合、履歴が表示されません。ただし、ダウンロードはできます。

[[ファイル:Install redmine 04.png|600px]]

=== Root directoryをhttpプロトコルで指定すると参照できない ===

Root directoryを「http://192.168.100.6:8002/」等のhttpで指定すると、リポジトリ参照ができません。（一応、Webアクセス時、GETメソッドを使用しているようですが）

[[ファイル:Install redmine 05.png|600px]]

[[ファイル:Install redmine 06.png|600px]]

そもそも、想定外の指定方法かも知れません。（要調査）

== その他 ==

=== RMagickをインストールする ===

プラグイン[https://ociotec.com/redmine/projects/show/advanced-roadmap Adcanced roadmap]をインストールするためには[http://rmagick.rubyforge.org/ RMagick]が必要となります。

RMagickをインストールするまでの手順は以下となります。

==== FreeType ====

ImageMagickにてTrueTypeフォントを使用するため、FreeTypeをインストールします。

# yum install freetype freetype-devel

==== libpngのインストール ====

入手先 : http://www.libpng.org/pub/png/libpng.html

PNG形式のグラフを出力するときに使用するライブラリです。

$ tar zxvf libpng-1.5.4.tar.gz
$ cd libpng-1.5.4
$ ./configure
$ make
$ su
# make install

==== ImageMagickのインストール ====

入手先 : http://www.imagemagick.org/script/index.php

$ tar zxvf ImageMagick.tar.gz
$ cd ImageMagick-6.7.1-3
$ ./configure
$ make
$ su
# make install

==== RMagickのインストール ====

$ gem install rmagick

==== Advenced roadmapのソースコード修正 ====

標準では、Advanced roadmapのグラフの凡例が文字化けするので、「vendor/plugins/advanced_roadmap/lib/advanced_roadmap/gruff/base.rb」を修正します。

修正例 :
<source lang="diff">
226,227c226,228
< vera_font_path = File.expand_path('Vera.ttf', ENV['MAGICK_FONT_PATH'])
< @font = File.exists?(vera_font_path) ? vera_font_path : nil
---
> # vera_font_path = File.expand_path('Vera.ttf', ENV['MAGICK_FONT_PATH'])
> # @font = File.exists?(vera_font_path) ? vera_font_path : nil
> @font = "/usr/share/fonts/japanese/TrueType/sazanami-gothic.ttf"
</source>

参考 :
http://groups.google.com/group/redmine-users-ja/browse_thread/thread/13410c0c0c809dc6

インストールは以上です。

-- 2011年8月8日 (月) 21:41 (JST)

=== サブディレクトリにRedmineを配置するには ===

通常インストールでは、Redmineのルートは「http://<ホスト名>/」となります。これを、「http://<ホスト名>/test/」とするには以下とします。

「httpd.conf」に以下を追記します。（DocumentRootは「"/usr/local/apache2/htdocs"」のままとします）
RailsBaseURI /test

シンボリックリンクを作成します。
# ln -s /var/lib/redmine/public /usr/local/apache2/htdocs/test

以上の手順により、1サーバで複数のRedmineを構築することも可能です。

=== developmentモードで起動するには ===

「httpd.conf」に以下を追記します。
RailsEnv development

== 参考 ==

* 入門Redmine 第2版 Linux/Windows対応 / 前田剛
* http://redmine.jp/tech_note/apache-passenger/ - Apache上でRuby on Railsアプリケーションを動かす／Passenger(mod_rails for Apache)の利用

== 更新履歴 ==
* [[#RMagickをインストールする]] -- 2011年8月8日 (月) 21:41 (JST)
* [[#RedmineでMercurialリポジトリを参照する]]追加 -- 2011年3月20日 (日) 18:46 (JST)
* ページ作成 -- 2011年1月23日 (日) 16:35 (JST)

Redmineの導入手順

2011-08-08T12:41:36Z

Admin: /* 更新履歴 */

[[Category:ソフトウェア開発]][[Category:導入手順]]

本ページでは、Rubyで作成されたバグトラッキングシステムである「Redmine」の導入手順を記述します。バージョン管理システムである「Mercurial」も同時にインストールします。

== 環境 ==

* OS : CentOS 5.4
* Web Server : Apache 2.2.17
* Database : MySQL 5.1.54
* Other : Redmine 1.1.0, Ruby 1.8.7, rubygems 1.4.2, Mercurial 1.7.3

== インストール ==

=== MySQL ===

入手先 :http://www.mysql.com/

<source lang="text">
$ tar zxvf mysql-5.1.54.tar.gz
$ cd mysql-5.1.54
$ ./configure
$ make
# make install
</source>

=== Apache ===

入手先 : http://httpd.apache.org/

<source lang="text">
$ tar zxvf httpd-2.2.17.tar.gz
$ cd httpd-2.2.17
$ ./configure
$ make
# make install
</source>

=== Ruby ===

入手先 : http://www.ruby-lang.org/

<source lang="text">
$ tar zxvf ruby-1.8.7-p330.tar.gz
$ cd ruby-1.8.7-p330
$ ./configure
$ make
# make install
</source>

=== RubyGems ===

入手先 : http://rubyforge.org/projects/rubygems/

<source lang="text">
$ tar zxvf rubygems-1.4.2.tgz
$ cd rubygems-1.4.2
# ruby setup.rb
</source>

=== Ruby on Rails ===

RubyGemsからインストールします。[http://www.redmine.org/projects/redmine/wiki/RedmineInstall 公式サイト]にある通り、バージョン2.3.5のRailsをインストールします。

<source lang="text">
# gem install rails -v 2.3.5
</source>

=== Docutils ===

Mercurialをインストールするための準備として、Docutilsをインストールします。

入手先 : http://docutils.sourceforge.net/

<source lang="text">
$ tar zxvf docutils-0.7
$ cd docutils-0.7
# ./setup.py install
</source>

Pythonはインストール済みとします。

=== Mercurial ===

入手先 : http://mercurial.selenic.com/

<source lang="text">
$ tar zxvf mercurial-1.7.3.tar.gz
$ cd mercurial-1.7.3
$ make all
# make install
</source>

=== Redmine ===

入手先 : http://www.redmine.org/

<source lang="text">
$ tar zxvf redmine-1.1.0.tar.gz
# gem install -v=0.4.2 i18n
# mv redmine-1.1.0 /var/lib/redmine
# cd /var/lib/redmine/
# rake generate_session_store
</source>

i18nはrakeに必要なためインストールします。

=== Passenger ===

Passengerをインストールします。
<source lang="text">
# gem install passenger
</source>

Apache用モジュールをインストールします。
<source lang="text">
# export APXS2=/usr/local/apache2/bin/apxs
# export PATH=/usr/local/apache2/bin:$PATH
# passenger-install-apache2-module
</source>

「Please edit your Apache configuration file, and add these lines:」の次の3行を控えて置きます。後に「httpd.conf」の設定で必要になります。
<source lang="text">
The Apache 2 module was successfully installed.

Please edit your Apache configuration file, and add these lines:

LoadModule passenger_module /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2/ext/apache2/mod_passenger.so
PassengerRoot /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2
PassengerRuby /usr/local/bin/ruby

After you restart Apache, you are ready to deploy any number of Ruby on Rails
applications on Apache, without any further Ruby on Rails-specific
configuration!

Press ENTER to continue.
</source>

=== MySQL用のデータベースアクセスライブラリ ===

MySQL用のデータベースアクセスライブラリをインストールします。

<source lang="text">
# gem install mysql -- --with-mysql-lib=/usr/local/lib/mysql/
</source>

インストール中に「No definition for ...」から始まる行がいくつか出力されます。

「ld.so.conf」に「/usr/local/lib/mysql/」を追加します。
<source lang="text">
# vim /etc/ld.so.conf
</source>

共有ライブラリを再認識させます。
<source lang="text">
# /sbin/ldconfig
</source>

== 設定 ==

=== MySQL ===

ユーザ「mysql」を作成し、DBを初期化します。

<source lang="text">
# /usr/sbin/useradd mysql
# /usr/local/bin/mysql_install_db --user=mysql
</source>

DBを起動し、rootのパスワードを設定します。

<source lang="text">
# /usr/local/bin/mysqld_safe --user=mysql &
# /usr/local/bin/mysqladmin -u root password <password>
</source>

Redmineでアクセスするためのユーザ（redmine）を作成し、DBを作成します。

<source lang="text">
# mysql -u root -p
</source>

<source lang="sql">
mysql> grant all privileges on *.* to redmine@localhost identified by '<パスワード>' with grant option;
mysql> create database redmine default character set utf8;
</source>

RedmineのDB接続設定を行います。

<source lang="text">
$ cd /var/lib/redmine/config/
$ cp database.yml.example database.yml
$ vim database.yml
</source>

productionのセクションの「username:」に先ほど作成したユーザ名、「password:」にDBパスワードを追記します。
<source lang="text">
production:
adapter: mysql
database: redmine
host: localhost
username: redmine
password: <パスワード>
encoding: utf8
</source>

DBを初期化します。
<source lang="text">
# rake db:migrate RAILS_ENV=production
</source>

本コマンドで、以下のメッセージが表示される場合は、共有ライブラリの設定が不十分かもしれません。
<source lang="text">
(in /var/lib/redmine)
rake aborted!
Object is not missing constant Issue!

(See full trace by running task with --trace)
</source>

標準のワークフローを導入します。
<source lang="text">
# rake redmine:load_default_data RAILS_ENV=production
</source>
「Select language:」と表示されたら「ja」を入力します。

=== Apache ===

「/usr/local/apache2/conf/httpd.conf」を編集します。

DocumentRootを以下に変更します。
<source lang="text">
# DocumentRoot "/usr/local/apache2/htdocs"
DocumentRoot "/var/lib/redmine/public"
</source>

以下を追記します。
<source lang="text">
<Directory "/var/lib/redmine/public">
Options Indexes FollowSymLinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>

LoadModule passenger_module /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2/ext/apache2/mod_passenger.so
PassengerRoot /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2
PassengerRuby /usr/local/bin/ruby
</source>
下の3行は、「passenger-install-apache2-module」の出力結果を必ず貼り付けてください。

== 起動 ==

=== MySQL ===

# /usr/local/bin/mysqld_safe --user=mysql &

=== Apache ===

# /usr/local/apache2/bin/apachectl start

Apache起動後、Redmine初期画面は以下のようになります。

[[ファイル:Redmine install.png|600px]]

[http://blog.redmine.jp/articles/farend-basic-theme/ farend basic]というテーマを使用しています。

== トラブルシューティング ==

=== 「rake db:migrate RAILS_ENV=production」コマンド実行時にエラーが発生する。 ===

以下のエラーメッセージが表示された場合、「rake generate_session_store」コマンドの実行が漏れている可能性があります。

<source lang="text">
(in /var/lib/redmine)
rake aborted!
A key is required to write a cookie containing the session data. Use config.action_controller.session = { :key => "_myapp_session", :secret => "some secret phrase" } in config/environment.rb

(See full trace by running task with --trace)
</source>

== RedmineでMercurialリポジトリを参照する ==

=== 作成手順 ===

Mercurialのリポジトリを作成し、hgrcファイルを編集します。

mkdir /var/lib/hg/test00
cd /var/lib/hg/test00
vim .hg/hgrc

hgrcファイルの内容は以下とします。

[web]
allow_push = *
push_ssl = false

Webサーバを立ち上げます。

hg serve --port 8002

[設定]->[リポジトリ]のページで以下のように設定します。

[[ファイル:Install redmine 01.png|600px]]

[リポジトリ]のページを参照すると、Mercurialのリポジトリを参照できます。

[[ファイル:Install redmine 02.png|600px]]

上記画像で文字化けしているテキストファイルは、「新しいテキストドキュメント.txt」という名前のファイルです。これは、ページの文字コードが「UTF-8」に対して、ファイルの文字コードが「Shift_JIS」であるために発生します。

=== 日本語ファイル名を含むファイルの履歴が表示されない ===

英字だけのファイル名の場合、履歴が正常に表示されます。

[[ファイル:Install redmine 03.png|600px]]

日本語を含むファイル名の場合、履歴が表示されません。ただし、ダウンロードはできます。

[[ファイル:Install redmine 04.png|600px]]

=== Root directoryをhttpプロトコルで指定すると参照できない ===

Root directoryを「http://192.168.100.6:8002/」等のhttpで指定すると、リポジトリ参照ができません。（一応、Webアクセス時、GETメソッドを使用しているようですが）

[[ファイル:Install redmine 05.png|600px]]

[[ファイル:Install redmine 06.png|600px]]

そもそも、想定外の指定方法かも知れません。（要調査）

== その他 ==

=== RMagickをインストールする ===

プラグイン[https://ociotec.com/redmine/projects/show/advanced-roadmap Adcanced roadmap]をインストールするためには[http://rmagick.rubyforge.org/ RMagick]が必要となります。

RMagickをインストールするまでの手順は以下となります。

==== libpngのインストール ====

入手先 : http://www.libpng.org/pub/png/libpng.html

PNG形式のグラフを出力するときに使用するライブラリです。

$ tar zxvf libpng-1.5.4.tar.gz
$ cd libpng-1.5.4
$ ./configure
$ make
$ su
# make install

==== ImageMagickのインストール ====

入手先 : http://www.imagemagick.org/script/index.php

$ tar zxvf ImageMagick.tar.gz
$ cd ImageMagick-6.7.1-3
$ ./configure
$ make
$ su
# make install

==== RMagickのインストール ====

$ gem install rmagick

インストールは以上です。余談ですが、Advanced roadmapのグラフの凡例は、文字化けしていて読めません。

-- 2011年8月8日 (月) 21:41 (JST)

=== サブディレクトリにRedmineを配置するには ===

通常インストールでは、Redmineのルートは「http://<ホスト名>/」となります。これを、「http://<ホスト名>/test/」とするには以下とします。

「httpd.conf」に以下を追記します。（DocumentRootは「"/usr/local/apache2/htdocs"」のままとします）
RailsBaseURI /test

シンボリックリンクを作成します。
# ln -s /var/lib/redmine/public /usr/local/apache2/htdocs/test

以上の手順により、1サーバで複数のRedmineを構築することも可能です。

=== developmentモードで起動するには ===

「httpd.conf」に以下を追記します。
RailsEnv development

== 参考 ==

* 入門Redmine 第2版 Linux/Windows対応 / 前田剛
* http://redmine.jp/tech_note/apache-passenger/ - Apache上でRuby on Railsアプリケーションを動かす／Passenger(mod_rails for Apache)の利用

== 更新履歴 ==
* [[#RMagickをインストールする]] -- 2011年8月8日 (月) 21:41 (JST)
* [[#RedmineでMercurialリポジトリを参照する]]追加 -- 2011年3月20日 (日) 18:46 (JST)
* ページ作成 -- 2011年1月23日 (日) 16:35 (JST)

Redmineの導入手順

2011-08-08T12:41:08Z

Admin: /* RMagickをインストールする */

[[Category:ソフトウェア開発]][[Category:導入手順]]

本ページでは、Rubyで作成されたバグトラッキングシステムである「Redmine」の導入手順を記述します。バージョン管理システムである「Mercurial」も同時にインストールします。

== 環境 ==

* OS : CentOS 5.4
* Web Server : Apache 2.2.17
* Database : MySQL 5.1.54
* Other : Redmine 1.1.0, Ruby 1.8.7, rubygems 1.4.2, Mercurial 1.7.3

== インストール ==

=== MySQL ===

入手先 :http://www.mysql.com/

<source lang="text">
$ tar zxvf mysql-5.1.54.tar.gz
$ cd mysql-5.1.54
$ ./configure
$ make
# make install
</source>

=== Apache ===

入手先 : http://httpd.apache.org/

<source lang="text">
$ tar zxvf httpd-2.2.17.tar.gz
$ cd httpd-2.2.17
$ ./configure
$ make
# make install
</source>

=== Ruby ===

入手先 : http://www.ruby-lang.org/

<source lang="text">
$ tar zxvf ruby-1.8.7-p330.tar.gz
$ cd ruby-1.8.7-p330
$ ./configure
$ make
# make install
</source>

=== RubyGems ===

入手先 : http://rubyforge.org/projects/rubygems/

<source lang="text">
$ tar zxvf rubygems-1.4.2.tgz
$ cd rubygems-1.4.2
# ruby setup.rb
</source>

=== Ruby on Rails ===

RubyGemsからインストールします。[http://www.redmine.org/projects/redmine/wiki/RedmineInstall 公式サイト]にある通り、バージョン2.3.5のRailsをインストールします。

<source lang="text">
# gem install rails -v 2.3.5
</source>

=== Docutils ===

Mercurialをインストールするための準備として、Docutilsをインストールします。

入手先 : http://docutils.sourceforge.net/

<source lang="text">
$ tar zxvf docutils-0.7
$ cd docutils-0.7
# ./setup.py install
</source>

Pythonはインストール済みとします。

=== Mercurial ===

入手先 : http://mercurial.selenic.com/

<source lang="text">
$ tar zxvf mercurial-1.7.3.tar.gz
$ cd mercurial-1.7.3
$ make all
# make install
</source>

=== Redmine ===

入手先 : http://www.redmine.org/

<source lang="text">
$ tar zxvf redmine-1.1.0.tar.gz
# gem install -v=0.4.2 i18n
# mv redmine-1.1.0 /var/lib/redmine
# cd /var/lib/redmine/
# rake generate_session_store
</source>

i18nはrakeに必要なためインストールします。

=== Passenger ===

Passengerをインストールします。
<source lang="text">
# gem install passenger
</source>

Apache用モジュールをインストールします。
<source lang="text">
# export APXS2=/usr/local/apache2/bin/apxs
# export PATH=/usr/local/apache2/bin:$PATH
# passenger-install-apache2-module
</source>

「Please edit your Apache configuration file, and add these lines:」の次の3行を控えて置きます。後に「httpd.conf」の設定で必要になります。
<source lang="text">
The Apache 2 module was successfully installed.

Please edit your Apache configuration file, and add these lines:

LoadModule passenger_module /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2/ext/apache2/mod_passenger.so
PassengerRoot /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2
PassengerRuby /usr/local/bin/ruby

After you restart Apache, you are ready to deploy any number of Ruby on Rails
applications on Apache, without any further Ruby on Rails-specific
configuration!

Press ENTER to continue.
</source>

=== MySQL用のデータベースアクセスライブラリ ===

MySQL用のデータベースアクセスライブラリをインストールします。

<source lang="text">
# gem install mysql -- --with-mysql-lib=/usr/local/lib/mysql/
</source>

インストール中に「No definition for ...」から始まる行がいくつか出力されます。

「ld.so.conf」に「/usr/local/lib/mysql/」を追加します。
<source lang="text">
# vim /etc/ld.so.conf
</source>

共有ライブラリを再認識させます。
<source lang="text">
# /sbin/ldconfig
</source>

== 設定 ==

=== MySQL ===

ユーザ「mysql」を作成し、DBを初期化します。

<source lang="text">
# /usr/sbin/useradd mysql
# /usr/local/bin/mysql_install_db --user=mysql
</source>

DBを起動し、rootのパスワードを設定します。

<source lang="text">
# /usr/local/bin/mysqld_safe --user=mysql &
# /usr/local/bin/mysqladmin -u root password <password>
</source>

Redmineでアクセスするためのユーザ（redmine）を作成し、DBを作成します。

<source lang="text">
# mysql -u root -p
</source>

<source lang="sql">
mysql> grant all privileges on *.* to redmine@localhost identified by '<パスワード>' with grant option;
mysql> create database redmine default character set utf8;
</source>

RedmineのDB接続設定を行います。

<source lang="text">
$ cd /var/lib/redmine/config/
$ cp database.yml.example database.yml
$ vim database.yml
</source>

productionのセクションの「username:」に先ほど作成したユーザ名、「password:」にDBパスワードを追記します。
<source lang="text">
production:
adapter: mysql
database: redmine
host: localhost
username: redmine
password: <パスワード>
encoding: utf8
</source>

DBを初期化します。
<source lang="text">
# rake db:migrate RAILS_ENV=production
</source>

本コマンドで、以下のメッセージが表示される場合は、共有ライブラリの設定が不十分かもしれません。
<source lang="text">
(in /var/lib/redmine)
rake aborted!
Object is not missing constant Issue!

(See full trace by running task with --trace)
</source>

標準のワークフローを導入します。
<source lang="text">
# rake redmine:load_default_data RAILS_ENV=production
</source>
「Select language:」と表示されたら「ja」を入力します。

=== Apache ===

「/usr/local/apache2/conf/httpd.conf」を編集します。

DocumentRootを以下に変更します。
<source lang="text">
# DocumentRoot "/usr/local/apache2/htdocs"
DocumentRoot "/var/lib/redmine/public"
</source>

以下を追記します。
<source lang="text">
<Directory "/var/lib/redmine/public">
Options Indexes FollowSymLinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>

LoadModule passenger_module /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2/ext/apache2/mod_passenger.so
PassengerRoot /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2
PassengerRuby /usr/local/bin/ruby
</source>
下の3行は、「passenger-install-apache2-module」の出力結果を必ず貼り付けてください。

== 起動 ==

=== MySQL ===

# /usr/local/bin/mysqld_safe --user=mysql &

=== Apache ===

# /usr/local/apache2/bin/apachectl start

Apache起動後、Redmine初期画面は以下のようになります。

[[ファイル:Redmine install.png|600px]]

[http://blog.redmine.jp/articles/farend-basic-theme/ farend basic]というテーマを使用しています。

== トラブルシューティング ==

=== 「rake db:migrate RAILS_ENV=production」コマンド実行時にエラーが発生する。 ===

以下のエラーメッセージが表示された場合、「rake generate_session_store」コマンドの実行が漏れている可能性があります。

<source lang="text">
(in /var/lib/redmine)
rake aborted!
A key is required to write a cookie containing the session data. Use config.action_controller.session = { :key => "_myapp_session", :secret => "some secret phrase" } in config/environment.rb

(See full trace by running task with --trace)
</source>

== RedmineでMercurialリポジトリを参照する ==

=== 作成手順 ===

Mercurialのリポジトリを作成し、hgrcファイルを編集します。

mkdir /var/lib/hg/test00
cd /var/lib/hg/test00
vim .hg/hgrc

hgrcファイルの内容は以下とします。

[web]
allow_push = *
push_ssl = false

Webサーバを立ち上げます。

hg serve --port 8002

[設定]->[リポジトリ]のページで以下のように設定します。

[[ファイル:Install redmine 01.png|600px]]

[リポジトリ]のページを参照すると、Mercurialのリポジトリを参照できます。

[[ファイル:Install redmine 02.png|600px]]

上記画像で文字化けしているテキストファイルは、「新しいテキストドキュメント.txt」という名前のファイルです。これは、ページの文字コードが「UTF-8」に対して、ファイルの文字コードが「Shift_JIS」であるために発生します。

=== 日本語ファイル名を含むファイルの履歴が表示されない ===

英字だけのファイル名の場合、履歴が正常に表示されます。

[[ファイル:Install redmine 03.png|600px]]

日本語を含むファイル名の場合、履歴が表示されません。ただし、ダウンロードはできます。

[[ファイル:Install redmine 04.png|600px]]

=== Root directoryをhttpプロトコルで指定すると参照できない ===

Root directoryを「http://192.168.100.6:8002/」等のhttpで指定すると、リポジトリ参照ができません。（一応、Webアクセス時、GETメソッドを使用しているようですが）

[[ファイル:Install redmine 05.png|600px]]

[[ファイル:Install redmine 06.png|600px]]

そもそも、想定外の指定方法かも知れません。（要調査）

== その他 ==

=== RMagickをインストールする ===

プラグイン[https://ociotec.com/redmine/projects/show/advanced-roadmap Adcanced roadmap]をインストールするためには[http://rmagick.rubyforge.org/ RMagick]が必要となります。

RMagickをインストールするまでの手順は以下となります。

==== libpngのインストール ====

入手先 : http://www.libpng.org/pub/png/libpng.html

PNG形式のグラフを出力するときに使用するライブラリです。

$ tar zxvf libpng-1.5.4.tar.gz
$ cd libpng-1.5.4
$ ./configure
$ make
$ su
# make install

==== ImageMagickのインストール ====

入手先 : http://www.imagemagick.org/script/index.php

$ tar zxvf ImageMagick.tar.gz
$ cd ImageMagick-6.7.1-3
$ ./configure
$ make
$ su
# make install

==== RMagickのインストール ====

$ gem install rmagick

インストールは以上です。余談ですが、Advanced roadmapのグラフの凡例は、文字化けしていて読めません。

-- 2011年8月8日 (月) 21:41 (JST)

=== サブディレクトリにRedmineを配置するには ===

通常インストールでは、Redmineのルートは「http://<ホスト名>/」となります。これを、「http://<ホスト名>/test/」とするには以下とします。

「httpd.conf」に以下を追記します。（DocumentRootは「"/usr/local/apache2/htdocs"」のままとします）
RailsBaseURI /test

シンボリックリンクを作成します。
# ln -s /var/lib/redmine/public /usr/local/apache2/htdocs/test

以上の手順により、1サーバで複数のRedmineを構築することも可能です。

=== developmentモードで起動するには ===

「httpd.conf」に以下を追記します。
RailsEnv development

== 参考 ==

* 入門Redmine 第2版 Linux/Windows対応 / 前田剛
* http://redmine.jp/tech_note/apache-passenger/ - Apache上でRuby on Railsアプリケーションを動かす／Passenger(mod_rails for Apache)の利用

== 更新履歴 ==
* [[#RedmineでMercurialリポジトリを参照する]]追加 -- 2011年3月20日 (日) 18:46 (JST)
* ページ作成 -- 2011年1月23日 (日) 16:35 (JST)

Redmineの導入手順

2011-08-08T12:39:47Z

Admin: /* その他 */

[[Category:ソフトウェア開発]][[Category:導入手順]]

本ページでは、Rubyで作成されたバグトラッキングシステムである「Redmine」の導入手順を記述します。バージョン管理システムである「Mercurial」も同時にインストールします。

== 環境 ==

* OS : CentOS 5.4
* Web Server : Apache 2.2.17
* Database : MySQL 5.1.54
* Other : Redmine 1.1.0, Ruby 1.8.7, rubygems 1.4.2, Mercurial 1.7.3

== インストール ==

=== MySQL ===

入手先 :http://www.mysql.com/

<source lang="text">
$ tar zxvf mysql-5.1.54.tar.gz
$ cd mysql-5.1.54
$ ./configure
$ make
# make install
</source>

=== Apache ===

入手先 : http://httpd.apache.org/

<source lang="text">
$ tar zxvf httpd-2.2.17.tar.gz
$ cd httpd-2.2.17
$ ./configure
$ make
# make install
</source>

=== Ruby ===

入手先 : http://www.ruby-lang.org/

<source lang="text">
$ tar zxvf ruby-1.8.7-p330.tar.gz
$ cd ruby-1.8.7-p330
$ ./configure
$ make
# make install
</source>

=== RubyGems ===

入手先 : http://rubyforge.org/projects/rubygems/

<source lang="text">
$ tar zxvf rubygems-1.4.2.tgz
$ cd rubygems-1.4.2
# ruby setup.rb
</source>

=== Ruby on Rails ===

RubyGemsからインストールします。[http://www.redmine.org/projects/redmine/wiki/RedmineInstall 公式サイト]にある通り、バージョン2.3.5のRailsをインストールします。

<source lang="text">
# gem install rails -v 2.3.5
</source>

=== Docutils ===

Mercurialをインストールするための準備として、Docutilsをインストールします。

入手先 : http://docutils.sourceforge.net/

<source lang="text">
$ tar zxvf docutils-0.7
$ cd docutils-0.7
# ./setup.py install
</source>

Pythonはインストール済みとします。

=== Mercurial ===

入手先 : http://mercurial.selenic.com/

<source lang="text">
$ tar zxvf mercurial-1.7.3.tar.gz
$ cd mercurial-1.7.3
$ make all
# make install
</source>

=== Redmine ===

入手先 : http://www.redmine.org/

<source lang="text">
$ tar zxvf redmine-1.1.0.tar.gz
# gem install -v=0.4.2 i18n
# mv redmine-1.1.0 /var/lib/redmine
# cd /var/lib/redmine/
# rake generate_session_store
</source>

i18nはrakeに必要なためインストールします。

=== Passenger ===

Passengerをインストールします。
<source lang="text">
# gem install passenger
</source>

Apache用モジュールをインストールします。
<source lang="text">
# export APXS2=/usr/local/apache2/bin/apxs
# export PATH=/usr/local/apache2/bin:$PATH
# passenger-install-apache2-module
</source>

「Please edit your Apache configuration file, and add these lines:」の次の3行を控えて置きます。後に「httpd.conf」の設定で必要になります。
<source lang="text">
The Apache 2 module was successfully installed.

Please edit your Apache configuration file, and add these lines:

LoadModule passenger_module /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2/ext/apache2/mod_passenger.so
PassengerRoot /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2
PassengerRuby /usr/local/bin/ruby

After you restart Apache, you are ready to deploy any number of Ruby on Rails
applications on Apache, without any further Ruby on Rails-specific
configuration!

Press ENTER to continue.
</source>

=== MySQL用のデータベースアクセスライブラリ ===

MySQL用のデータベースアクセスライブラリをインストールします。

<source lang="text">
# gem install mysql -- --with-mysql-lib=/usr/local/lib/mysql/
</source>

インストール中に「No definition for ...」から始まる行がいくつか出力されます。

「ld.so.conf」に「/usr/local/lib/mysql/」を追加します。
<source lang="text">
# vim /etc/ld.so.conf
</source>

共有ライブラリを再認識させます。
<source lang="text">
# /sbin/ldconfig
</source>

== 設定 ==

=== MySQL ===

ユーザ「mysql」を作成し、DBを初期化します。

<source lang="text">
# /usr/sbin/useradd mysql
# /usr/local/bin/mysql_install_db --user=mysql
</source>

DBを起動し、rootのパスワードを設定します。

<source lang="text">
# /usr/local/bin/mysqld_safe --user=mysql &
# /usr/local/bin/mysqladmin -u root password <password>
</source>

Redmineでアクセスするためのユーザ（redmine）を作成し、DBを作成します。

<source lang="text">
# mysql -u root -p
</source>

<source lang="sql">
mysql> grant all privileges on *.* to redmine@localhost identified by '<パスワード>' with grant option;
mysql> create database redmine default character set utf8;
</source>

RedmineのDB接続設定を行います。

<source lang="text">
$ cd /var/lib/redmine/config/
$ cp database.yml.example database.yml
$ vim database.yml
</source>

productionのセクションの「username:」に先ほど作成したユーザ名、「password:」にDBパスワードを追記します。
<source lang="text">
production:
adapter: mysql
database: redmine
host: localhost
username: redmine
password: <パスワード>
encoding: utf8
</source>

DBを初期化します。
<source lang="text">
# rake db:migrate RAILS_ENV=production
</source>

本コマンドで、以下のメッセージが表示される場合は、共有ライブラリの設定が不十分かもしれません。
<source lang="text">
(in /var/lib/redmine)
rake aborted!
Object is not missing constant Issue!

(See full trace by running task with --trace)
</source>

標準のワークフローを導入します。
<source lang="text">
# rake redmine:load_default_data RAILS_ENV=production
</source>
「Select language:」と表示されたら「ja」を入力します。

=== Apache ===

「/usr/local/apache2/conf/httpd.conf」を編集します。

DocumentRootを以下に変更します。
<source lang="text">
# DocumentRoot "/usr/local/apache2/htdocs"
DocumentRoot "/var/lib/redmine/public"
</source>

以下を追記します。
<source lang="text">
<Directory "/var/lib/redmine/public">
Options Indexes FollowSymLinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>

LoadModule passenger_module /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2/ext/apache2/mod_passenger.so
PassengerRoot /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2
PassengerRuby /usr/local/bin/ruby
</source>
下の3行は、「passenger-install-apache2-module」の出力結果を必ず貼り付けてください。

== 起動 ==

=== MySQL ===

# /usr/local/bin/mysqld_safe --user=mysql &

=== Apache ===

# /usr/local/apache2/bin/apachectl start

Apache起動後、Redmine初期画面は以下のようになります。

[[ファイル:Redmine install.png|600px]]

[http://blog.redmine.jp/articles/farend-basic-theme/ farend basic]というテーマを使用しています。

== トラブルシューティング ==

=== 「rake db:migrate RAILS_ENV=production」コマンド実行時にエラーが発生する。 ===

以下のエラーメッセージが表示された場合、「rake generate_session_store」コマンドの実行が漏れている可能性があります。

<source lang="text">
(in /var/lib/redmine)
rake aborted!
A key is required to write a cookie containing the session data. Use config.action_controller.session = { :key => "_myapp_session", :secret => "some secret phrase" } in config/environment.rb

(See full trace by running task with --trace)
</source>

== RedmineでMercurialリポジトリを参照する ==

=== 作成手順 ===

Mercurialのリポジトリを作成し、hgrcファイルを編集します。

mkdir /var/lib/hg/test00
cd /var/lib/hg/test00
vim .hg/hgrc

hgrcファイルの内容は以下とします。

[web]
allow_push = *
push_ssl = false

Webサーバを立ち上げます。

hg serve --port 8002

[設定]->[リポジトリ]のページで以下のように設定します。

[[ファイル:Install redmine 01.png|600px]]

[リポジトリ]のページを参照すると、Mercurialのリポジトリを参照できます。

[[ファイル:Install redmine 02.png|600px]]

上記画像で文字化けしているテキストファイルは、「新しいテキストドキュメント.txt」という名前のファイルです。これは、ページの文字コードが「UTF-8」に対して、ファイルの文字コードが「Shift_JIS」であるために発生します。

=== 日本語ファイル名を含むファイルの履歴が表示されない ===

英字だけのファイル名の場合、履歴が正常に表示されます。

[[ファイル:Install redmine 03.png|600px]]

日本語を含むファイル名の場合、履歴が表示されません。ただし、ダウンロードはできます。

[[ファイル:Install redmine 04.png|600px]]

=== Root directoryをhttpプロトコルで指定すると参照できない ===

Root directoryを「http://192.168.100.6:8002/」等のhttpで指定すると、リポジトリ参照ができません。（一応、Webアクセス時、GETメソッドを使用しているようですが）

[[ファイル:Install redmine 05.png|600px]]

[[ファイル:Install redmine 06.png|600px]]

そもそも、想定外の指定方法かも知れません。（要調査）

== その他 ==

=== RMagickをインストールする ===

プラグイン[https://ociotec.com/redmine/projects/show/advanced-roadmap Adcanced roadmap]をインストールするためには[http://rmagick.rubyforge.org/ RMagick]が必要となります。

RMagickをインストールするまでの手順は以下となります。

==== libpngのインストール ====

入手先 : http://www.libpng.org/pub/png/libpng.html

PNG形式のグラフを出力するときに使用するライブラリです。

$ tar zxvf libpng-1.5.4.tar.gz
$ cd libpng-1.5.4
$ ./configure
$ make
$ su
# make install

==== ImageMagickのインストール ====

入手先 : http://www.imagemagick.org/script/index.php

$ tar zxvf ImageMagick.tar.gz
$ cd ImageMagick-6.7.1-3
$ ./configure
$ make
$ su
# make install

==== RMagickのインストール ====

$ gem install rmagick

=== サブディレクトリにRedmineを配置するには ===

通常インストールでは、Redmineのルートは「http://<ホスト名>/」となります。これを、「http://<ホスト名>/test/」とするには以下とします。

「httpd.conf」に以下を追記します。（DocumentRootは「"/usr/local/apache2/htdocs"」のままとします）
RailsBaseURI /test

シンボリックリンクを作成します。
# ln -s /var/lib/redmine/public /usr/local/apache2/htdocs/test

以上の手順により、1サーバで複数のRedmineを構築することも可能です。

=== developmentモードで起動するには ===

「httpd.conf」に以下を追記します。
RailsEnv development

== 参考 ==

* 入門Redmine 第2版 Linux/Windows対応 / 前田剛
* http://redmine.jp/tech_note/apache-passenger/ - Apache上でRuby on Railsアプリケーションを動かす／Passenger(mod_rails for Apache)の利用

== 更新履歴 ==
* [[#RedmineでMercurialリポジトリを参照する]]追加 -- 2011年3月20日 (日) 18:46 (JST)
* ページ作成 -- 2011年1月23日 (日) 16:35 (JST)

Ruby on Railsメモ

2011-08-08T09:27:38Z

Admin: ページの作成: Category:Tips == トラブルシューティング == === sqlite3-rubyのインストールに失敗する === CentOS5.4環境にて、sqlite3-rubyをインストールし...

[[Category:Tips]]

== トラブルシューティング ==

=== sqlite3-rubyのインストールに失敗する ===

CentOS5.4環境にて、sqlite3-rubyをインストールしようとしたら以下エラーとなりました。

<pre>
# gem install --remote sqlite3-ruby
Building native extensions. This could take a while...
ERROR: Error installing sqlite3-ruby:
ERROR: Failed to build gem native extension.

/usr/local/bin/ruby extconf.rb
checking for sqlite3.h... yes
checking for sqlite3_libversion_number() in -lsqlite3... yes
checking for rb_proc_arity()... no
checking for sqlite3_initialize()... no
checking for sqlite3_backup_init()... no
checking for sqlite3_column_database_name()... no
checking for sqlite3_enable_load_extension()... no
checking for sqlite3_load_extension()... no
creating Makefile

make
gcc -I. -I. -I/usr/local/lib/ruby/1.8/x86_64-linux -I. -fPIC -g -O2 -c database.c
database.c: In function ‘initialize’:
database.c:47: error: ‘SQLITE_OPEN_READWRITE’ undeclared (first use in this function)
database.c:47: error: (Each undeclared identifier is reported only once
database.c:47: error: for each function it appears in.)
database.c:47: error: ‘SQLITE_OPEN_CREATE’ undeclared (first use in this function)
database.c:72: error: ‘SQLITE_OPEN_READONLY’ undeclared (first use in this function)
database.c: In function ‘set_sqlite3_func_result’:
database.c:278: error: ‘sqlite3_int64’ undeclared (first use in this function)
make: *** [database.o] エラー 1

Gem files will remain installed in /usr/local/lib/ruby/gems/1.8/gems/sqlite3-1.3.4 for inspection.
Results logged to /usr/local/lib/ruby/gems/1.8/gems/sqlite3-1.3.4/ext/sqlite3/gem_make.out

</pre>

CentOS5.4標準のsqlite3（3.3.6）を、2011/08/08時点の最新バージョンである3.7.7.1に置き換えたら正常にインストールできました。

* その他環境
** ruby 1.8.7
** gem 1.4.2

-- 2011年8月8日 (月) 18:27 (JST)

== 更新履歴 ==
* ページ作成 -- 2011年8月8日 (月) 18:27 (JST)