始めるにあたっての FAQ

Q:どのようにしてソースコードが見れますか？

java.net のアカウントがなくても Source - CVSページにアクセスすることでソースコードを見ることができます。

Q:どのようにしてソースコードをチェックアウトできますか？

登録済みの java.net ユーザーアカウントでプロジェクトのソースをチェックアウトするには、https://opensso.dev.java.net/servlets/ProjectSource を参照してください。 登録済みのユーザーアカウントに対してコミッターの権限が承認されていれば、ソースツリーに対して修正内容をコミットすることができます。 (OpenSSO のプロジェクトロールについての詳細は、ガバナンスのページを参照してください。)

また、guest アカウントで CVS コマンドを用いてソースコードをチェックアウトすることもできます。 コマンドは、次のようにユーザー名とパスワードに guest を使用します。

cvs -d :pserver:guest:guest@cvs.dev.java.net:/cvs checkout opensso

Q:OpenSSO のダウンロード方法

ダウンロードページからビルド済みのバイナリをダウンロードできます。.

Q: 環境設定や適切なツールの取得方法や実際にソースをビルドする方法に関する情報はどこから得ることができますか？

Source - CVS のページで products/amserver ディレクトリに移動します。このディレクトリにある README には要件や依存関係に関する情報が書かれています。 その情報はビルドの要件と依存関係に関する FAQのページにもあります。.

Q: まずはコードをビルドすることができました。次にどういったことができますか？

OpenSSO プロジェクトに参加するには、java.net に登録し、OpenSSOに参加する必要があります。その後、次のようなことができます:

• メーリングリストやコミュニティーフォーラムのディスカッションに参加する。
• 既存のバグを検索したり、新規バグをレポートする。
• マニュアルやソースコードを書く。
• プロジェクトがよりよいものになるようにするためにどうすればいいかについてフィードバックする。

Q:バグのレポート方法

一般的なバグやセキュリティバグのレポート方法のページを参照してください。

Q:OpenSSO のソースファイルの変更方法

OpenSSO の貢献者はソースツリーのファイルに新しいコードを適用することで問題を解決できます。OpenSSO のソースのファイルに変更を適用するプロセスは次の通りです:

1. 最新のソースファイルの複製をチェックアウトする。
2. 適切なファイルに対して修正を施す。
3. 何を変更したかがわかるようなコメントをつける。
4. Javadoc^TM タグや他の適切な形式の文章を用いてコメントを修正する。
5. ソフトウェアをビルドし修正内容が適切であるかを確認する。
6. 適切なサニティテストや回帰テストを行い修正によって他の機能などに悪影響がないかを確認する。

Q:パッチとは何ですか？どのようにしてサブミットできますか？

cvs diff を実行すると同一ファイルの異なるバージョン間の差異が表示されます。この差異がパッチです。パッチをワークスペースに適用することで修正内容が取り込まれてファイルのバージョンが更新されます。すべてのパッチはソースツリーにサブミットされる前にレビューしてもらう必要があります。

サブミットするパッチに対するレビュープロセス:

1. パッチファイルの作成方法:
   1. % cd checkedout_source
   2. % cvs diff -u > patch_report_name

2. パッチに関連する課題（バグ）がまだない場合には、課題トラッカーにて課題を登録する。

課題ごとにサブミットするパッチは 1 つのみとする。2 つ以上の課題に対して、それらが密接に関連している場合を除き、 1 つのパッチをサブミットしないでください。

3. code-review@opensso.dev.java.net に対して課題番号とともにパッチをサブミットする。.
4. パッチが承認されたら、課題トラッカーにて対応する課題に対してパッチファイルを添付するか、もしくはパッチファイルの内容を Suggested Fix フィールドに直接コピーします。
5. 承認されたパッチをソースツリーに反映させるために、committers@opensso.dev.java.net 宛にパッチを送ります。
6. パッチが反映されたら、コミッターが課題トラッカー上で該当する課題のステータスを修正済み(fixed)に変更します。

セキュリティ上の重大な問題を見つけた場合は、セキュリティの問題をレポートする際のガイドラインにしたがってください。

もしパッチが大きい場合、もしくは製品の機能拡張を行いたい場合は、パッチをサブミットする前にアーキテクチャーレビューガイドラインに従う必要があります。 詳細情報については、code-review@opensso.dev.java.net にメールで問い合わせてください。