久々に確認したらllvmがバージョン 7になっていた。
手持ちのARM clang クロスコンパイラはバージョン3.8ベース。
大分最新から古くなっているので再度作成することにする。
■作成対象
自作OSのビルドが目的なので
target-triple が arm-none-eabi のbaremetal ARMクロスコンパイラ
■インストール先
/opt/arm-none-eabi-clang
■ソースコード一式展開
Getting startedに従ってllvm本体とclang, lldそれぞれのソースコードを展開する。
libcxxはOSのライブラリ依存だが、独自OSにはそれがまだ無いのでこの時点では導入しない。
compiler-rtはLLVM/Clangのビルドとは別に独立して行うのでllvmソースツリー内に展開しない。
■ビルド
(clang+llvm)
cmake
<llvm-7.0.0.src path> -DCMAKE_CROSSCOMPILING=True
-DCMAKE_BUILD_TYPE=Release -DLLVM_TARGETS_TO_BUILD=ARM
-DCMAKE_INSTALL_PREFIX=/opt/arm-none-eabi-clang -DLLVM_TARGET_ARCH=ARM
-DLLVM_DEFAULT_TARGET_TRIPLE=arm-none-eabi -DCLANG_DEFAULT_LINKER=lld
-DCLANG_DEFAULT_RTLIB=compiler-rt
-DDEFAULT_SYSROOT=/opt/arm-none-eabi-clang
2018年9月20日木曜日
2018年3月27日火曜日
Zynqberry FPGA開発
開発環境構築からの続き
■参考サイト
ZynqBerryチュートリアル
■プロジェクトの作成
リファレンスデザインソースに生成されたvivado_create_project_guimode.cmdを実行する。いろいろとログが出力された後に下記のVivado開発環境が立ち上がる。
■IP編集
左メニューの[Flow Navigator]-[IP INTEGRATOR]-[Open Block Design]を選択する。
下記のように初期設定のブロック図が表示される。
自作IPの作成方針として理解したのは2通り。1つはAXI4対応IPとする方法、もう1つは汎用IPとして作成しAXI4-GPIOと接続する方法。
いずれにしてもAXI4と接続しないとARMのアドレス空間経由で操作できない。
①AXI4対応IP作成方法
上部メニューの[Tools]-[Create And Package New IP]を選択する。
下記ダイアログにおいて「Create a new AXI4 peripheral」を選択しNext。
Peripheral Detail画面が表示されるのでIPの名前や保存場所を指定する。
別ウィンドウでIPのサブプロジェクトが開けば成功
成功するとAXI I/Fドライバのひな型とC言語のドライバスタブが生成される。
Sourcesウィンドウの[Design Sources]-[IP名]を選択するとVHDLのコードが生成されているのがわかる。
エディタで開いて最下部に「Add user logic here」と記載されているところに自分のロジックを組み込めばOK。
②自作汎用IPの組み込み
[PROJECT MANAGER]-[Add Sources]し、ダイアログから[Add or create design sources]を選択する。
下部の[Create File]ボタンを押して作成するHDLソースファイルを指定する。
File TypeにHDLの種類(VHDL, Verilog, SystemVerilogなど)、File nameにソースファイル名を指定する。
次の画面で入出力ポートを設定すると自動でソースファイルのひな型が生成される。
■プロジェクト設定
自作IP毎のサブプロジェクト作成について
デフォルトでは編集時にサブプロジェクトを作成し、編集後に自動で削除されるようになっている。
毎回サブプロジェクトを作成、削除するのが手間であれば自動削除しないように設定できる。
左メニュー[Flow Navigator]-[PROJECT MANAGER]-[Setting]から[Project Setting]-[IP]-[Packager]を選択する。
設定画面の[Delete project after packaging]のチェックを外すと自動削除を無効にできる。
■参考サイト
ZynqBerryチュートリアル
■プロジェクトの作成
リファレンスデザインソースに生成されたvivado_create_project_guimode.cmdを実行する。いろいろとログが出力された後に下記のVivado開発環境が立ち上がる。
■IP編集
左メニューの[Flow Navigator]-[IP INTEGRATOR]-[Open Block Design]を選択する。
下記のように初期設定のブロック図が表示される。
自作IPの作成方針として理解したのは2通り。1つはAXI4対応IPとする方法、もう1つは汎用IPとして作成しAXI4-GPIOと接続する方法。
いずれにしてもAXI4と接続しないとARMのアドレス空間経由で操作できない。
①AXI4対応IP作成方法
上部メニューの[Tools]-[Create And Package New IP]を選択する。
下記ダイアログにおいて「Create a new AXI4 peripheral」を選択しNext。
Peripheral Detail画面が表示されるのでIPの名前や保存場所を指定する。
別ウィンドウでIPのサブプロジェクトが開けば成功
成功するとAXI I/Fドライバのひな型とC言語のドライバスタブが生成される。
Sourcesウィンドウの[Design Sources]-[IP名]を選択するとVHDLのコードが生成されているのがわかる。
エディタで開いて最下部に「Add user logic here」と記載されているところに自分のロジックを組み込めばOK。
②自作汎用IPの組み込み
[PROJECT MANAGER]-[Add Sources]し、ダイアログから[Add or create design sources]を選択する。
下部の[Create File]ボタンを押して作成するHDLソースファイルを指定する。
File TypeにHDLの種類(VHDL, Verilog, SystemVerilogなど)、File nameにソースファイル名を指定する。
次の画面で入出力ポートを設定すると自動でソースファイルのひな型が生成される。
■プロジェクト設定
自作IP毎のサブプロジェクト作成について
デフォルトでは編集時にサブプロジェクトを作成し、編集後に自動で削除されるようになっている。
毎回サブプロジェクトを作成、削除するのが手間であれば自動削除しないように設定できる。
左メニュー[Flow Navigator]-[PROJECT MANAGER]-[Setting]から[Project Setting]-[IP]-[Packager]を選択する。
設定画面の[Delete project after packaging]のチェックを外すと自動削除を無効にできる。
2018年3月19日月曜日
Zynqberry FPGA開発環境構築
■手順概要
■リファレンスデザインのダウンロード
Trenz electronic Zynqberryダウンロードサイト
ここからリファレンスデザインをダウンロードする
2018/3時点で最新バージョンは2017.4
te0726-test_board-vivado_2017.4-build_06_20180216205357.zip
これを適当なフォルダに展開する。
空白を含まないフォルダパスが望ましい。
■Xilinx Vivadoのインストール
リファレンスデザインの対象バージョンが2017.4なのでVivadoも同じバージョンをダウンロード、インストールする。
バージョンが合っていないと論理合成できないことがある
またインストールするフォルダはデフォルトのC:\Xilinxが望ましい。
リファレンスデザインのプロジェクト作成batファイルがC:\Xilinxにインストールされているのを前提にしているため
■リファレンスデザインの展開
ダウンロードしたリファレンスデザインを解凍すると直下に_create_win_setup.cmdというスクリプトがある。
これをコマンドプロンプトから実行
-------------------------TE Reference Design---------------------------
--------------------------------------------------------------------
-- (c) Go to CMD-File Generation (Manual setup)
-- (d) Go to Documentation (Web Documentation)
-- (x) Exit Batch (nothing is done!)
-- (0) Create minimum setup of CMD-Files and exit Batch
-- (1) Create maximum setup of CMD-Files and exit Batch
----
Select (ex.:'0' for min setup):
このような選択が表示されるので1を選択する。
するとプロジェクト作成に必要なスクリプト群が生成される。
■プロジェクト対象ボードの選択
生成されたスクリプト群にあるdesign_basic_setting.cmdを編集する。
(編集箇所)
@set PARTNUMBER=LAST_ID
LAST_IDを手持ちのボードに合わせる。選択できるボードの種類はboard_filesディレクトリのTE0726_board_files.csvに記載されている。
ここでは手元にあるte0726-03mを選択しておく。
LAST_IDのままにしておくと自動的にte0726-03-07s-1cが選択されたことになる。
@set SWAPP=NA
NAを作成するプロジェクト名に変える
■プロジェクトの作成
生成されたスクリプト群の中からvivado_create_project_guimode.cmdを実行する。
するとzynqberryのハード設定で初期化された状態でVivadoアプリケーションが立ち上がる。
立ち上がったらメニューのFile->Save Project Asで好きな場所に保存する。
以降はこのプロジェクトを編集して回路設計と合成を行う
- リファレンスデザインのダウンロード
- Xilinx Vivadoのインストール
- プロジェクトの作成
■リファレンスデザインのダウンロード
Trenz electronic Zynqberryダウンロードサイト
ここからリファレンスデザインをダウンロードする
2018/3時点で最新バージョンは2017.4
te0726-test_board-vivado_2017.4-build_06_20180216205357.zip
これを適当なフォルダに展開する。
空白を含まないフォルダパスが望ましい。
■Xilinx Vivadoのインストール
リファレンスデザインの対象バージョンが2017.4なのでVivadoも同じバージョンをダウンロード、インストールする。
バージョンが合っていないと論理合成できないことがある
またインストールするフォルダはデフォルトのC:\Xilinxが望ましい。
リファレンスデザインのプロジェクト作成batファイルがC:\Xilinxにインストールされているのを前提にしているため
■リファレンスデザインの展開
ダウンロードしたリファレンスデザインを解凍すると直下に_create_win_setup.cmdというスクリプトがある。
これをコマンドプロンプトから実行
-------------------------TE Reference Design---------------------------
--------------------------------------------------------------------
-- (c) Go to CMD-File Generation (Manual setup)
-- (d) Go to Documentation (Web Documentation)
-- (x) Exit Batch (nothing is done!)
-- (0) Create minimum setup of CMD-Files and exit Batch
-- (1) Create maximum setup of CMD-Files and exit Batch
----
Select (ex.:'0' for min setup):
このような選択が表示されるので1を選択する。
するとプロジェクト作成に必要なスクリプト群が生成される。
■プロジェクト対象ボードの選択
生成されたスクリプト群にあるdesign_basic_setting.cmdを編集する。
(編集箇所)
@set PARTNUMBER=LAST_ID
LAST_IDを手持ちのボードに合わせる。選択できるボードの種類はboard_filesディレクトリのTE0726_board_files.csvに記載されている。
ここでは手元にあるte0726-03mを選択しておく。
LAST_IDのままにしておくと自動的にte0726-03-07s-1cが選択されたことになる。
@set SWAPP=NA
NAを作成するプロジェクト名に変える
■プロジェクトの作成
生成されたスクリプト群の中からvivado_create_project_guimode.cmdを実行する。
するとzynqberryのハード設定で初期化された状態でVivadoアプリケーションが立ち上がる。
立ち上がったらメニューのFile->Save Project Asで好きな場所に保存する。
以降はこのプロジェクトを編集して回路設計と合成を行う
2017年1月1日日曜日
Mackbook Pro(Late 2016, macOS Sierra 10.12.2)でOpenOCD
新しく今年発売のMacbook Proを購入したのでBeagleBoneをOpenOCDでデバッグする環境を構築
■必要なソフトのインストール
・Xcode, gcc command line tool
AppStore経由でXcodeのインストール
command line toolはXcodeのメニューからインストール
・Homebrew
http://brew.sh/index_ja.html
上記サイトを見ながらhomebrewをインストールする
・OpenOCD
ターミナルから brew install openocd
で依存関係まで含めてインストールされる
■Kernel Extension設定変更
BeagleBone搭載のデバッガはTI XDS100v2
これはMacに接続するとUSBデバイス FT2232(vendor id: 0x403, product id: 0x6010)と認識される
macOS SierraにはFTDIのドライバが標準で入っているらしく接続すると以下4つのTTYデバイスが/dev に作成される
cu.usbserial-TIWD9YJWA
cu.usbserial-TIWD9YJWB
tty.usbserial-TIWD9YJWA
tty.usbserial-TIWD9YJWB
ただ、この状態だとOpenOCDが接続できない。
OpenOCDはlibftdi->libusb経由でUSB interface0のXDS100v2に接続しようとするが既にTIWD9YJWAというTTYデバイスとして使用してしまっているからである。
そこでmacOS Sierraの標準FTDIドライバがinterface0にドライバを適用しないようにする
/System/Library/Extensions/AppleUSBFTDI.kext/Contents/Info.plist の以下の部分を削除する
削除する前に一応 cp Info.plist Info.plist.org とでもしてバックアップを取っておくと良い
ちなみに/System/以下のファイルはSIPを無効にしないとchmodで書き込み権限を付与しても編集できない。
SIPを無効にするにはcommand+Rを押しながら起動または再起動してリカバリーモードから行う
リカバリーモードで起動したらメニューから[ユティリティ]-[ターミナル]を選択し、ターミナルからcsruti disableとする
Info.plist の編集が終わったら再びリカバリーモードから csrutil enableとして保護機能を有効化するのを忘れずに。
■OpenOCD起動
AppleUSBFTDIのInfo.plistを編集した後に再起動するか、モジュールのunload, loadをするとinterface0のTIWD9YJWAが作成されなくなる。
この状態でOpenOCDが接続可能となる
openocd -f board/ti_beaglebone.cfg
で接続することができる。さらに
screen /dev/tty.usbserial-TIWD9YJWB 115200
とすることでinterface1はシリアルUARTでデバイスと通信が可能である。
■必要なソフトのインストール
・Xcode, gcc command line tool
AppStore経由でXcodeのインストール
command line toolはXcodeのメニューからインストール
・Homebrew
http://brew.sh/index_ja.html
上記サイトを見ながらhomebrewをインストールする
・OpenOCD
ターミナルから brew install openocd
で依存関係まで含めてインストールされる
■Kernel Extension設定変更
BeagleBone搭載のデバッガはTI XDS100v2
これはMacに接続するとUSBデバイス FT2232(vendor id: 0x403, product id: 0x6010)と認識される
macOS SierraにはFTDIのドライバが標準で入っているらしく接続すると以下4つのTTYデバイスが/dev に作成される
cu.usbserial-TIWD9YJWA
cu.usbserial-TIWD9YJWB
tty.usbserial-TIWD9YJWA
tty.usbserial-TIWD9YJWB
ただ、この状態だとOpenOCDが接続できない。
OpenOCDはlibftdi->libusb経由でUSB interface0のXDS100v2に接続しようとするが既にTIWD9YJWAというTTYデバイスとして使用してしまっているからである。
そこでmacOS Sierraの標準FTDIドライバがinterface0にドライバを適用しないようにする
/System/Library/Extensions/AppleUSBFTDI.kext/Contents/Info.plist の以下の部分を削除する
<key>AppleUSBEFTDI-6010-0</key>
<dict>
<key>CFBundleIdentifier</key>
<string>com.apple.driver.AppleUSBFTDI</string>
<key>IOClass</key>
<string>AppleUSBFTDI</string>
<key>IOProviderClass</key>
<string>IOUSBHostInterface</string>
<key>InputBuffers</key>
<integer>8</integer>
<key>OutputBuffers</key>
<integer>16</integer>
<key>bConfigurationValue</key>
<integer>1</integer>
<key>bInterfaceNumber</key>
<integer>0</integer>
<key>idProduct</key>
<integer>24592</integer>
<key>idVendor</key>
<integer>1027</integer>
</dict>
削除する前に一応 cp Info.plist Info.plist.org とでもしてバックアップを取っておくと良い
ちなみに/System/以下のファイルはSIPを無効にしないとchmodで書き込み権限を付与しても編集できない。
SIPを無効にするにはcommand+Rを押しながら起動または再起動してリカバリーモードから行う
リカバリーモードで起動したらメニューから[ユティリティ]-[ターミナル]を選択し、ターミナルからcsruti disableとする
Info.plist の編集が終わったら再びリカバリーモードから csrutil enableとして保護機能を有効化するのを忘れずに。
■OpenOCD起動
AppleUSBFTDIのInfo.plistを編集した後に再起動するか、モジュールのunload, loadをするとinterface0のTIWD9YJWAが作成されなくなる。
この状態でOpenOCDが接続可能となる
openocd -f board/ti_beaglebone.cfg
で接続することができる。さらに
screen /dev/tty.usbserial-TIWD9YJWB 115200
とすることでinterface1はシリアルUARTでデバイスと通信が可能である。
2016年10月31日月曜日
ARMクロスコンパイル用clang その3
前々からautoconfではなく、cmakeでのビルドを推奨していたLLVMだが、ついにautoconfのサポートが無くなってしまった。
そこでcmakeでのARMクロスコンパイラのビルド方法を記載しておく。
(1)LLVM(Clang含む)のソースコード一式を適当なフォルダに展開する
展開の仕方は公式のGetting startedを参照
(2)LLVMのフォルダとは別の場所にビルドフォルダを作成し移動する.
(3)以下のようにcmakeを実行すればMakefileが生成される
cmake <LLVMフォルダパス> -DCMAKE_CROSSCOMPILING=True -DCMAKE_BUILD_TYPE=Release -DLLVM_TARGETS_TO_BUILD="ARM;AARCH64" -DCMAKE_INSTALL_PREFIX=<ビルドしたバイナリのインストール先パス> -DLLVM_TARGET_ARCH=ARM -DLLVM_DEFAULT_TARGET_TRIPLE=arm-none-eabi
(4)make; make install
そこでcmakeでのARMクロスコンパイラのビルド方法を記載しておく。
(1)LLVM(Clang含む)のソースコード一式を適当なフォルダに展開する
展開の仕方は公式のGetting startedを参照
(2)LLVMのフォルダとは別の場所にビルドフォルダを作成し移動する.
(3)以下のようにcmakeを実行すればMakefileが生成される
cmake <LLVMフォルダパス> -DCMAKE_CROSSCOMPILING=True -DCMAKE_BUILD_TYPE=Release -DLLVM_TARGETS_TO_BUILD="ARM;AARCH64" -DCMAKE_INSTALL_PREFIX=<ビルドしたバイナリのインストール先パス> -DLLVM_TARGET_ARCH=ARM -DLLVM_DEFAULT_TARGET_TRIPLE=arm-none-eabi
(4)make; make install
2016年8月11日木曜日
ARMクロスコンパイル用clang その2
ARMクロスコンパイル用clangの続き
普段使っているのがWindowsなのでWindows上でもARMクロスコンパイルclangを作成して見る
自作OS向けなのでベアメタルビルドでOK。
ライブラリ無しのコンパイラのみなのでビルドはシンプル。
普段使っているのがWindowsなのでWindows上でもARMクロスコンパイルclangを作成して見る
自作OS向けなのでベアメタルビルドでOK。
ライブラリ無しのコンパイラのみなのでビルドはシンプル。
■準備
msys2 32bit版を導入
(1) https://msys2.github.io/ から msys2-i686-[hhhhmmdd].exe をダウンロードして実行する
(2) メニューからMinGW-w64 Win32 shellを選択してターミナルを出す
(3) ターミナルからシステムアップグレード
pacman -Syu --noconfirm
(4) ターミナルを1度閉じる
(5) エクスプローラから C:\msys32\mingw32.exe を実行する
アップグレードするとメニューからのターミナル起動ショートカットがなぜか効かなくなるので直接実行
(6) clangビルドに必要なパッケージをインストール
pacman -S base-devel mingw-w64-i686-toolchain python --noconfirm
■binutils, clangをビルド
ビルド用スクリプトbuild-arm-clang.shを用意
(使用方法)
build-arm-clang.sh [binutilsバージョン] [llvm/clangバージョン]
何も指定しないとbinutils-2.27, llvm-3.8.1 になる
(使用方法)
build-arm-clang.sh [binutilsバージョン] [llvm/clangバージョン]
何も指定しないとbinutils-2.27, llvm-3.8.1 になる
2016年7月30日土曜日
Nginx + Redmine
■前提
nginx, Redmine(ruby, bundler, unicorn含む)はインストール済みとする
■nginxの設定
/etc/nginx/sites-available のサーバー設定に以下を追加
upstream unicorn {
server unix:[redmineインストールパス]/tmp/unicorn.sock fail_timeout=0;
}
server {} の中に locationを追加
location /redmine {
alias [redmineインストールパス]/public;
try_files $uri/index.html $uri.html $uri @unicorn;
}
location @unicorn {
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $http_host;
proxy_redirect off;
proxy_pass http://unicorn;
}
■Redmineの設定
sub-uri /redmine で動作するように若干変更
[redmineインストールパス]/config/routes.rb の以下の部分を変更
(変更前)
Rails.application.routes.draw do
root :to => 'welcome#index', :as => 'home'
・
・
・
end
(変更後)
Redmine::Utils::relative_url_root="/redmine"
Rails.application.routes.draw do
scope Redmine::Utils::relative_url_root do
root :to => 'welcome#index', :as => 'home'
・
・
・
end
■Redmineの起動
■nginx再起動
service nginx restart
nginx, Redmine(ruby, bundler, unicorn含む)はインストール済みとする
■nginxの設定
/etc/nginx/sites-available のサーバー設定に以下を追加
upstream unicorn {
server unix:[redmineインストールパス]/tmp/unicorn.sock fail_timeout=0;
}
server {} の中に locationを追加
location /redmine {
alias [redmineインストールパス]/public;
try_files $uri/index.html $uri.html $uri @unicorn;
}
location @unicorn {
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $http_host;
proxy_redirect off;
proxy_pass http://unicorn;
}
■Redmineの設定
sub-uri /redmine で動作するように若干変更
[redmineインストールパス]/config/routes.rb の以下の部分を変更
(変更前)
Rails.application.routes.draw do
root :to => 'welcome#index', :as => 'home'
・
・
・
end
(変更後)
Redmine::Utils::relative_url_root="/redmine"
Rails.application.routes.draw do
scope Redmine::Utils::relative_url_root do
root :to => 'welcome#index', :as => 'home'
・
・
・
end
end
■Redmineの起動
cd [redmineインストールパス]
bundle exec unicorn -c config/unicorn.rb -E production -D
これでunicorn経由でRedmineがデーモン状態で立ち上がる
■nginx再起動
service nginx restart
2016年2月14日日曜日
Gitoliteサーバ
■サーバ設定
・/var/lib/gitolite3/.gitolite.rc
UMASK 0700がデフォルト(rwx --- ---)。
redmine等の管理システムからリポジトリ参照したい場合は0027(rwxr-x---)としてグループからの読み込みも許可しておく
こうしないとgit でpushするたびにredmineからリポジトリ参照できなくなる
App 13972 stderr: fatal: Failed to resolve HEAD as a valid ref.
App 13972 stderr: fatal: Not a valid object name HEAD:
こんな感じのエラーログが出る。
■ユーザー追加
・Unixユーザー追加
・/var/lib/gitolite3/.gitolite.rc
UMASK 0700がデフォルト(rwx --- ---)。
redmine等の管理システムからリポジトリ参照したい場合は0027(rwxr-x---)としてグループからの読み込みも許可しておく
こうしないとgit でpushするたびにredmineからリポジトリ参照できなくなる
App 13972 stderr: fatal: Failed to resolve HEAD as a valid ref.
App 13972 stderr: fatal: Not a valid object name HEAD:
こんな感じのエラーログが出る。
■ユーザー追加
・Unixユーザー追加
useradd [ユーザーID]
passwd [ユーザーID]
・SSHキーペア生成
ssh-keygen -t rsa -b 2048
パスフレーズ入力して作成完了
id_rsa(秘密鍵), id_rsa.pub(公開鍵)の2つが生成される。
・gitoliteに追加
gitolite.conf のアクセスリポジトリにユーザーと権限追加
keydirフォルダに公開鍵を追加
ubuntu 14.04 + nginx + SSL立ち上げ
■apt準備
/etc/apt/sources.list に以下を追加
deb http://nginx.org/packages/ubuntu/ trusty nginx
deb-src http://nginx.org/packages/ubuntu/ trusty nginx
■パッケージインストール
apt-get update
apt-get install nginx
■設定
nginxのサイト設定は以下のどちらかのフォルダに設定することが出来る。
/etc/nginx/conf.d
/etc/nginx/sites-available
運用方針は人それぞれだが共通設定をconf.dに置き、サイト設定はsites-availableに置く。
有効にするサイト設定は/etc/nginx/sites-enabled/からシンボリックリンクを貼る
(1)サーバー共通設定作成
nginxのサイト設定は以下のどちらかのフォルダに設定することが出来る。
/etc/nginx/conf.d
/etc/nginx/sites-available
運用方針は人それぞれだが共通設定をconf.dに置き、サイト設定はsites-availableに置く。
有効にするサイト設定は/etc/nginx/sites-enabled/からシンボリックリンクを貼る
(1)サーバー共通設定作成
/etc/nginx/conf.d/default.conf を拡張子を変えて保存
/etc/nginx/conf.d/example_ssl.confを拡張子を変えて保存
/etc/nginx/conf.d/default.conf を新たに作成し中身を以下にする
========== ここから ==========
server {
listen 80;
listen [::]:80;
# httpへのアクセスをhttpsへリダイレクトする
# return 301 https://$host$request_uri; <= 後でコメントをはずす
}
========== ここまで ==========
========== ここから ==========
server {
listen 80;
listen [::]:80;
# httpへのアクセスをhttpsへリダイレクトする
# return 301 https://$host$request_uri; <= 後でコメントをはずす
}
========== ここまで ==========
(2)PFS用パラメータを生成
mkdir /etc/nginx/ssl
cd /etc/nginx/ssl
openssl dhparam 2048 -out dhparam.pem
mkdir /etc/nginx/ssl
cd /etc/nginx/ssl
openssl dhparam 2048 -out dhparam.pem
■サイト設定
(1)サイト設定の有効化
/etc/nginx/nginx.confの末尾に以下を追加
include /etc/nginx/sites-enabled/*;
(2)サイト設定の作成
(1)サイト設定の有効化
/etc/nginx/nginx.confの末尾に以下を追加
include /etc/nginx/sites-enabled/*;
(2)サイト設定の作成
/etc/nginx/sites-available/defaultのコピーを作成する
root および server_name を適宜設定
apache2からの移行ならroot は /var/www/html で良いかもしれない
(3)サイト設定の有効化
cd /etc/nginx/sites-enabled
ln -s /etc/ngingx/sites-available/<(2)でコピーしたサイト>
■let's encryptインストール
sudo su
cd /usr/share <= どこか適当な場所でよい
git clone https://github.com/letsencrypt/letsencrypt
cd letsencrypt
./letsencrypt-auto --help
依存関係が自動でインストールされてヘルプが表示されれば成功
■証明書取得
./letsencrypt-auto certonly --webroot -w <WEBファイルルートフォルダ> -d <サイトドメイン名> -d www.<サイトドメイン名> -m <管理者メールアドレス> --agree-tos
www.<サイトドメイン名>オプションは必要に応じて。無くてもいい。
取得に成功すると /etc/letsencrypt/live/<ドメイン名>/に証明書ファイルが保存される。
保存されるのは以下4ファイル
cert.pem
chain.pem
fullchain.pem
privkey.pem
■nginx SSL設定
(1)SSL設定
/etc/nginx/sites-available/ssl を作成し中身を以下にする
========== ここから ==========
root <WEBファイルルートフォルダ>;
index index.html;
# Perfect Forward Security (PFS)用パラメータ
ssl_dhparam /etc/nginx/ssl/dhparam.pem;
# Online Certificate Status Protocol(OCSP)有効化
ssl_stapling on;
ssl_stapling_verify on;
resolver 8.8.8.8;
# HTTP Strict Transport Security(HSTS)有効化
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains;';
}
root および server_name を適宜設定
apache2からの移行ならroot は /var/www/html で良いかもしれない
(3)サイト設定の有効化
cd /etc/nginx/sites-enabled
ln -s /etc/ngingx/sites-available/<(2)でコピーしたサイト>
■let's encryptインストール
sudo su
cd /usr/share <= どこか適当な場所でよい
git clone https://github.com/letsencrypt/letsencrypt
cd letsencrypt
./letsencrypt-auto --help
依存関係が自動でインストールされてヘルプが表示されれば成功
■証明書取得
./letsencrypt-auto certonly --webroot -w <WEBファイルルートフォルダ> -d <サイトドメイン名> -d www.<サイトドメイン名> -m <管理者メールアドレス> --agree-tos
www.<サイトドメイン名>オプションは必要に応じて。無くてもいい。
取得に成功すると /etc/letsencrypt/live/<ドメイン名>/に証明書ファイルが保存される。
保存されるのは以下4ファイル
cert.pem
chain.pem
fullchain.pem
privkey.pem
■nginx SSL設定
(1)SSL設定
/etc/nginx/sites-available/ssl を作成し中身を以下にする
========== ここから ==========
server {
listen 443 ssl;
listen [::]:443 ssl;
listen [::]:443 ssl;
server_name <サーバーのドメイン名>;
root <WEBファイルルートフォルダ>;
index index.html;
ssl_certificate /etc/letsencrypt/live/<ドメイン名>/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/<ドメイン名>/privkey.pem;
ssl_certificate_key /etc/letsencrypt/live/<ドメイン名>/privkey.pem;
ssl_session_cache shared:SSL:1m;
ssl_session_timeout 5m;
# サーバ側の暗号化スイートを優先する
ssl on;
# SSLプロトコルを安全なものだけ指定
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
# 暗号化アルゴリズムはサーバーが指定.
ssl_prefer_server_ciphers on;
# 具体的に使うアルゴリズム以外は無効に設定
ssl_ciphers EECDH+AESGCM:EDH+AESGCM:AES256+EECDH:AES256+EDH:!EXPORT:!DES:!3DES:!MD5:!RC4:!DSS:!SHA1;
# Perfect Forward Security (PFS)用パラメータ
ssl_dhparam /etc/nginx/ssl/dhparam.pem;
# Online Certificate Status Protocol(OCSP)有効化
ssl_stapling on;
ssl_stapling_verify on;
resolver 8.8.8.8;
# HTTP Strict Transport Security(HSTS)有効化
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains;';
}
========== ここまで ==========
(2)80ポートの扱い変更
最初に作成した/etc/nginx/conf.d/default.confの末尾のコメントをはずしポート80へのhttpアクセスはポート443のhttpsにリダイレクトする
この設定はお好みで。80をふさぐ場合は設定そのものを消す
■nginx起動
service nginx restart
■セキュリティ状態の確認
https://www.ssllabs.com/ssltest/index.html
ドメイン名を入力してテストしてもらう
■let's encrypt 証明書自動更新
/etc/cron.monthly/letsencrypt.shを作成
========== ここから ==========
#!/bin/sh
/usr/share/letsencrypt/letsencrypt-auto renew --force-renew
service nginx reload
========== ここまで ==========
(2)80ポートの扱い変更
最初に作成した/etc/nginx/conf.d/default.confの末尾のコメントをはずしポート80へのhttpアクセスはポート443のhttpsにリダイレクトする
この設定はお好みで。80をふさぐ場合は設定そのものを消す
■nginx起動
service nginx restart
■セキュリティ状態の確認
https://www.ssllabs.com/ssltest/index.html
ドメイン名を入力してテストしてもらう
■let's encrypt 証明書自動更新
/etc/cron.monthly/letsencrypt.shを作成
========== ここから ==========
#!/bin/sh
/usr/share/letsencrypt/letsencrypt-auto renew --force-renew
service nginx reload
========== ここまで ==========
[Grails] postgresql エラーメッセージ
例外発生時に文字化け
■対策
メッセージのロケール設定が悪いため発生。日本語だと厳しいので英語化
Windows:
C:\Program Files\PostgreSQL\9.1\data\postgresql.conf
Linux:
/etc/pgsql/postgresql.conf
lc_messages = 'Japanese_Japan.932' となっているのを lc_messages='C' にする
■対策
メッセージのロケール設定が悪いため発生。日本語だと厳しいので英語化
Windows:
C:\Program Files\PostgreSQL\9.1\data\postgresql.conf
Linux:
/etc/pgsql/postgresql.conf
lc_messages = 'Japanese_Japan.932' となっているのを lc_messages='C' にする
■Grails 2.4.0
・2.3.xからの変更点
upgradeコマンドが無くなった。
→バージョンアップはset-application-versionコマンドで行うこと
またはapplication.propertiesを開いてバージョンを手動で上げる。このファイルを保存すると自動でアップデートが走り出す。
■spring-security-core
・1.xからの変更点
パッケージが変更。grails.plugin.springsecurity.annotation.Securedが基本になった
さらにメソッドに対してのみ@Securedアノーテーションが使用可能に。
→web flowに対して設定できなくなった。さてどうしよう。
Login/LogoutControllerがプラグイン埋め込みになった。自動生成スクリプトが無くなった。
→自作のControllerに変更は可能。Config.groovyで指定するらしい
・2.3.xからの変更点
upgradeコマンドが無くなった。
→バージョンアップはset-application-versionコマンドで行うこと
またはapplication.propertiesを開いてバージョンを手動で上げる。このファイルを保存すると自動でアップデートが走り出す。
■spring-security-core
・1.xからの変更点
パッケージが変更。grails.plugin.springsecurity.annotation.Securedが基本になった
さらにメソッドに対してのみ@Securedアノーテーションが使用可能に。
→web flowに対して設定できなくなった。さてどうしよう。
Login/LogoutControllerがプラグイン埋め込みになった。自動生成スクリプトが無くなった。
→自作のControllerに変更は可能。Config.groovyで指定するらしい
Ubuntu 12.04 へのドメイン名の反映
■さくら VPS設定
・ドメイン名登録
コントロールパネル画面右上の「ネームサーバ登録」を選択。取得したドメイン名をテキストフィールドに入力して送信。
そうすると自動でさくらのDNSに登録される。
www. mail. などのサブドメインも登録してくれる。
・逆引き登録
コントロールパネルの右「設定」から「ホスト名逆引き登録」を選択
標準ホスト名にチェックが付いているが、カスタムに変更して取得したドメイン名を入力する
■Ubuntu設定
12.04からresolverの設定方法が変更になったらしい。
/etc/network/interfaces にresolver情報も記述する.
iface eth0 inet static
address ****
netmask ****
network ****
broadcast ****
gateway ****
# dns-* options are implemented by the resolvconf package, if installed
dns-nameservers ****
dns-search ****
という形に記述する。dns-nameservers にはさくらVPSのDNSサーバアドレスを記述
dns-search にはサーバが所属するドメインを複数記述する。
通常はhostname -f で取得できる結果と同じものを指定する。
単一のドメインに所属であれば、dns-domainを書けば良いらしい。
一応、さくら標準のホスト名でも検索できるように2つのドメインを指定
[番外編] Tomcat ログ出力
■Tomcatログ設定
ローテーションはtomcatでは行わない
設定 /usr/java/tomcat/conf/server.xml
<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log." suffix=".txt"
pattern="%h %l %u %t "%r" %s %b"
resolveHost="false" rotatable="false" />
■ログローテーション
logrotate に任せる。
設定 /etc/logrotate.d/tomcat
/var/log/tomcat/*.out {
copytruncate
missingok
notifempty
compress
rotate 8
weekly
}
(意味)
copytruncate --- コピー元ログはローテーション後に切り詰める
missingok --- ログが無くてもエラーにしない
notifempty --- ログが空の場合はローテーションしない
compress --- ローテーションファイルは圧縮
rotate 8 --- ローテーションは8回分保存
weekly --- ローテーションは週1回実行
ローテーションはtomcatでは行わない
設定 /usr/java/tomcat/conf/server.xml
<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log." suffix=".txt"
pattern="%h %l %u %t "%r" %s %b"
resolveHost="false" rotatable="false" />
■ログローテーション
logrotate に任せる。
設定 /etc/logrotate.d/tomcat
/var/log/tomcat/*.out {
copytruncate
missingok
notifempty
compress
rotate 8
weekly
}
(意味)
copytruncate --- コピー元ログはローテーション後に切り詰める
missingok --- ログが無くてもエラーにしない
notifempty --- ログが空の場合はローテーションしない
compress --- ローテーションファイルは圧縮
rotate 8 --- ローテーションは8回分保存
weekly --- ローテーションは週1回実行
2015年8月11日火曜日
ARMクロスコンパイル用clang
■ソース取得
・binutils
http://ftp.gnu.org/gnu/binutils/
上記から最新バージョンのtarアーカイブ取得
・LLVM他
gitで取得
git clone http://llvm.org/git/llvm
cd tools
git clone http://llvm.org/git/clang
git clone http://llvm.org/git/lldb
■ビルド
・binutils
cd binutils
mkdir build
../configure --target=arm-eabihf --enable-threads --enable-shared
make; make install
(注意)
../configure --target=arm-eabihf --enable-targets=arm とするとエラー発生
複数ARM用のビルド設定は出来ない様子
・clang, llvm, lldb
cd llvm
mkdir build
cd build
../configure --target=arm-eabihf --enable-threads --enable-shared --enable-optimized --disable-assertions --with-abi=aapcs-vfp --with-cpu=cortex-a9 --with-float=hard --with-fpu=neon
make; make install
・binutils
http://ftp.gnu.org/gnu/binutils/
上記から最新バージョンのtarアーカイブ取得
・LLVM他
gitで取得
git clone http://llvm.org/git/llvm
cd tools
git clone http://llvm.org/git/clang
git clone http://llvm.org/git/lldb
■ビルド
・binutils
cd binutils
mkdir build
../configure --target=arm-eabihf --enable-threads --enable-shared
make; make install
(注意)
../configure --target=arm-eabihf --enable-targets=arm とするとエラー発生
複数ARM用のビルド設定は出来ない様子
・clang, llvm, lldb
cd llvm
mkdir build
cd build
../configure --target=arm-eabihf --enable-threads --enable-shared --enable-optimized --disable-assertions --with-abi=aapcs-vfp --with-cpu=cortex-a9 --with-float=hard --with-fpu=neon
make; make install
2015年8月5日水曜日
ドメイン名の取得とサーバー証明書
■経緯
VPSのサーバー証明書を取るのに必要になった
→さくらVPSのデフォルトドメインでKingSSLのサーバー証明書を取ろうとしたらフィッシング審査ではじかれたため
→sakura.ne.jpがかつてフィッシングサーバとして使われたからか?
■取得先
お名前どっとこむ
割と安いしメジャーな様子
→安いと思いきや罠あり。Whois代行がドメイン登録時は無料だが更新後から1000円/年かかる
これはドメイン更新費用より高く割に合わない
ムームードメイン
こちらもメジャーなうえ、Whois代行が無料。
登録時の費用はお名前ドットコムより高いが更新も考えるとこちらの方が安い
(補足)
お名前ドットコムもムームードメインもどちらもGMOのグループ会社
サービス内容については大差無い
■取得契約内容
・TLD(Top Level Domain): 値段と目的で .workにする
・Whois代行: ON
Whois代行とはドメイン取得所在地、所有者情報を個人名から登録代行業者に変更すること
■契約後の設定
・さくらVPSドメイン設定から取得したドメイン名を登録
その際にさくらのDNSサーバアドレスが表示されるので控えておく
今回はns1.dns.ne.jp, ns2.dns.ne.jp だった
・ムームードメインの設定から外部DNSを使用を選択
さくらのDNSサーバアドレス2つを登録する
■SSLサーバ証明書
・秘密鍵生成
openssl genrsa -des3 -out [秘密鍵ファイル名] 4096
鍵にパスフレーズをつけないのであれば-des3オプションは不要
・CSR生成
openssl req -new -key [秘密鍵ファイル名] -out [出力CSRファイル名.csr]
・証明書要求
今回はKingSSLにした。安いので
申し込みページのCSR欄に生成したCSRをエディタで表示した内容をコピーペーストする
簡易ドメイン審査が行われた後にドメイン宛にメールが送られる。
送り先アドレスはpostmaster@やwebmaster@が選択できる
サーバー側でpostfixを動作させてメールを受け取れるようにしておくこと
念のため/etc/aliases でローカルアカウントと外部メールの両方に転送しておくといいかもしれない
/etc/aliasesの転送先はカンマ区切りで複数指定できる
・申し込み後に承認確認メールが来るので承認URLをブラウザで開いて確定する
確定後に証明書情報が送られてくる。
■クライアント証明書
・秘密鍵生成
openssl genrsa -out [キーファイル名] 4096
・CSR生成
openssl req -new -key [キーファイル名] -out [CSRファイル名]
・署名
openssl ca -in [CSRファイル名] -config /etc/ssl/openssl.cnf -out [クライアント証明書ファイル名]
■はまった点
メールを外部転送しなかったので添付ファイルを開くのに苦労した。
コマンドラインからメールを開くにはbase64 contentの部分だけ抜き出してファイル保存をする
そして以下のコマンドで復号する
openssl base64 -d -in <infile> -out <outfile>
VPSのサーバー証明書を取るのに必要になった
→さくらVPSのデフォルトドメインでKingSSLのサーバー証明書を取ろうとしたらフィッシング審査ではじかれたため
→sakura.ne.jpがかつてフィッシングサーバとして使われたからか?
■取得先
→安いと思いきや罠あり。Whois代行がドメイン登録時は無料だが更新後から1000円/年かかる
これはドメイン更新費用より高く割に合わない
ムームードメイン
こちらもメジャーなうえ、Whois代行が無料。
登録時の費用はお名前ドットコムより高いが更新も考えるとこちらの方が安い
(補足)
お名前ドットコムもムームードメインもどちらもGMOのグループ会社
サービス内容については大差無い
■取得契約内容
・TLD(Top Level Domain): 値段と目的で .workにする
・Whois代行: ON
Whois代行とはドメイン取得所在地、所有者情報を個人名から登録代行業者に変更すること
■契約後の設定
・さくらVPSドメイン設定から取得したドメイン名を登録
その際にさくらのDNSサーバアドレスが表示されるので控えておく
今回はns1.dns.ne.jp, ns2.dns.ne.jp だった
・ムームードメインの設定から外部DNSを使用を選択
さくらのDNSサーバアドレス2つを登録する
■SSLサーバ証明書
・秘密鍵生成
openssl genrsa -des3 -out [秘密鍵ファイル名] 4096
鍵にパスフレーズをつけないのであれば-des3オプションは不要
・CSR生成
openssl req -new -key [秘密鍵ファイル名] -out [出力CSRファイル名.csr]
・証明書要求
今回はKingSSLにした。安いので
申し込みページのCSR欄に生成したCSRをエディタで表示した内容をコピーペーストする
簡易ドメイン審査が行われた後にドメイン宛にメールが送られる。
送り先アドレスはpostmaster@やwebmaster@が選択できる
サーバー側でpostfixを動作させてメールを受け取れるようにしておくこと
念のため/etc/aliases でローカルアカウントと外部メールの両方に転送しておくといいかもしれない
/etc/aliasesの転送先はカンマ区切りで複数指定できる
・申し込み後に承認確認メールが来るので承認URLをブラウザで開いて確定する
確定後に証明書情報が送られてくる。
■クライアント証明書
・秘密鍵生成
openssl genrsa -out [キーファイル名] 4096
・CSR生成
openssl req -new -key [キーファイル名] -out [CSRファイル名]
・署名
openssl ca -in [CSRファイル名] -config /etc/ssl/openssl.cnf -out [クライアント証明書ファイル名]
■はまった点
メールを外部転送しなかったので添付ファイルを開くのに苦労した。
コマンドラインからメールを開くにはbase64 contentの部分だけ抜き出してファイル保存をする
そして以下のコマンドで復号する
openssl base64 -d -in <infile> -out <outfile>
2015年7月23日木曜日
msys2 - clang作成
■準備
以下のパッケージをインストール。64bit版を想定
・mingw-w64-x86_64-toolchain
→32ビットにしたいならmingw-w64-i686-toolchain
・diffutils
・git
■llvmファイル一式取得
適当なワークフォルダに移動してgitで取得
git clone http://llvm.org/git/llvm
cd tools
git clone http://llvm.org/git/clang
git clone http://llvm.org/git/libcxx
cd ../projects
git clone http://llvm.org/git/compiler-rt
cd ..
■ビルド
ARMクロスコンパイルもしたいのでx86, x86_64, arm, arm64をターゲットとしてビルドする
mkdir build
cd build
../configure --enable-targets=x86_64,x86,arm,aarch64 --disable-assertions --enable-optimized
make; make install
msys2インストール
■インストール後アップデート
pacman -Suy
もし下記エラーが出る場合は
pacman -Suy
もし下記エラーが出る場合は
error: GPGME error: No data
error: GPGME error: No data
error: GPGME error: No data
rm -r /var/lib/pacman/sync
pacman -Syuf
アップデート後はターミナルを再起動する
2015年4月29日水曜日
Apache2のセキュリティ設定(基本)
■ヘッダ情報削減
・HTTPレスポンスヘッダのサーバ情報を減らす
/etc/apache2/conf-available/security.conf
ServerTokens OS → ServerTokens Prod
ヘッダにApacheやOSのバージョン情報を入れない
・ヘッダ識別子非表示
ServerSignature On → ServerSignature Off
■Apacheトップページの非表示
http://ドメイン名/ で表示されるApacheのサンプルページの非表示
/etc/apache2/conf-available/security.conf
<Directory />
AllowOverride None
Order Deny,Allow
Deny from all
</Directory>
これがコメントアウトされていたらはずす。無ければ追記
・HTTPレスポンスヘッダのサーバ情報を減らす
/etc/apache2/conf-available/security.conf
ServerTokens OS → ServerTokens Prod
ヘッダにApacheやOSのバージョン情報を入れない
・ヘッダ識別子非表示
ServerSignature On → ServerSignature Off
■Apacheトップページの非表示
http://ドメイン名/ で表示されるApacheのサンプルページの非表示
/etc/apache2/conf-available/security.conf
<Directory />
AllowOverride None
Order Deny,Allow
Deny from all
</Directory>
これがコメントアウトされていたらはずす。無ければ追記
[Ubuntu] Gitolite3 + Apache2 + SSLクライアント認証
■目的
自分で立てたgitサーバーに対してhttps プロトコルでクライアント認証アクセスする
■インストール
Apache2はインストール済みとする
・Gitolite3インストール
apt-get install gitolite3
インストール中に管理者の公開鍵パスを要求されるので適当にSSHログインできる公開鍵を指定する
→これは後で変更も可能なので適当でOK
インストールが完了するとGitolite3のファイル群は /usr/share/gitolite3
環境は /var/lib/gitolite3 に作成される。
■Apache2準備
まずはApache2の準備
・ apache-suexec-custom のインストール
apt-get install apache-suexec-custom
a2enmod suexec
・mod_cgid 有効化
a2enmod cgid
・gitolite ラッパースクリプト用意
DocumentRoot が /var/www だとしたら /var/www/git というフォルダを作成する。
ここにスクリプトを追加する。 gitolite-suexec-wrapper.sh とする。
→スクリプトを置くフォルダは/var/www/git でなくても良いが、DocumentRootで指定したフォルダのサブフォルダでないとsuexecがスクリプトを実行できないので注意
(gitolite-suexec-wrapper.sh)
===============================================================================
#!/bin/bash
export GIT_PROJECT_ROOT="/var/lib/gitolite3/repositories"
export GITOLITE_HTTP_HOME="var/lib/gitolite3"
exec /usr/share/gitolite3/gitolite-shell
===============================================================================
chown gitolite3:gitolite3 gitolite-suexec-wrapper.sh
chmod +x /var/gitolite/gitolite-suexec-wrapper.sh
として所有者、実行権限を変更する。
・SSLクライアント認証設定
VirtualHost の設定に以下を追加
===============================================================================
SSLEngine on
SSLCertificateFile <サーバー証明書のパス>
SSLCertificateKeyFile <サーバ秘密鍵のパス>
SSLCACertficateFile <CA証明書のパス>
SSLVerifyClient require
SSLUserName SSL_CLIENT_S_DN_CN
SuexecUserGroup gitolite3:gitolite3
ScriptAlias /git /var/www/git/gitolite-suexec-wrapper.sh
<Location /git>
Order allow,deny
Allow from all
</Location>
===============================================================================
CAはオレオレCAで良い。SSLUserName設定はクライアント証明書のCNをユーザー名として扱うことの宣言。
環境変数REMOTE_USERもこれによって証明書CNに置き換わる。
■Gitolite3準備
次にGitolite3側の準備
・リポジトリアクセス権設定
Gitolite3のインストールによってgitolite-admin リポジトリが自動で生成されているはず。
まずはこれをローカルでclone する。そして conf/gitolite.conf を編集する。
例えばtesting リポジトリの設定が以下のようになっていたら
repo testing
RW+ = @all
↓
repo testing
RW+ = @all
R = daemon
というようにdaemonユーザーに対してRead権限を付与する。こうしないとApacheからGitolite3管理のリポジトリが読み出せない。Apacheからアクセスしたい全てのリポジトリにR = daemonを付与する。
変更したらcommit, push して反映
また当然であるが、クライアント証明書のCNと同じ名前のアクセス権限がリポジトリに設定されている必要がある。例えば、developというメンバーがクライアント認証でアクセスする場合にはtesting リポジトリの例で言うと
repo testing
RW = develop
R = daemon
とする。このときtestingリポジトリにApacheからはクライアント証明書のCNがdevelopでないとリポジトリにアクセスできない。
■クライアント側設定
・git設定ファイルの変更
(Linux)
~/.gitconfig
(Windows)
C:/Users/<ユーザー名>/.gitconfig
以下の設定を追記する
===============================================================================
[http]
sslCert = <クライアント証明書ファイルパス>
sslKey = <クライアント秘密鍵ファイルパス>
sslCaInfo = <CA証明書ファイルパス>
sslVerify = false
===============================================================================
最後のsslVefiry = false はオレオレCAの場合に必要。ちゃんと認証機関からCA証明書を取得しているなら不要。
■実行
以上の設定が完了していれば以下のコマンドでリポジトリの取得が可能なはず。
git clone https://<ドメイン名>/git/<リポジトリ名>
自分で立てたgitサーバーに対してhttps プロトコルでクライアント認証アクセスする
■インストール
Apache2はインストール済みとする
・Gitolite3インストール
apt-get install gitolite3
インストール中に管理者の公開鍵パスを要求されるので適当にSSHログインできる公開鍵を指定する
→これは後で変更も可能なので適当でOK
インストールが完了するとGitolite3のファイル群は /usr/share/gitolite3
環境は /var/lib/gitolite3 に作成される。
■Apache2準備
まずはApache2の準備
・ apache-suexec-custom のインストール
apt-get install apache-suexec-custom
a2enmod suexec
・mod_cgid 有効化
a2enmod cgid
・gitolite ラッパースクリプト用意
DocumentRoot が /var/www だとしたら /var/www/git というフォルダを作成する。
ここにスクリプトを追加する。 gitolite-suexec-wrapper.sh とする。
→スクリプトを置くフォルダは/var/www/git でなくても良いが、DocumentRootで指定したフォルダのサブフォルダでないとsuexecがスクリプトを実行できないので注意
(gitolite-suexec-wrapper.sh)
===============================================================================
#!/bin/bash
export GIT_PROJECT_ROOT="/var/lib/gitolite3/repositories"
export GITOLITE_HTTP_HOME="var/lib/gitolite3"
exec /usr/share/gitolite3/gitolite-shell
===============================================================================
chown gitolite3:gitolite3 gitolite-suexec-wrapper.sh
chmod +x /var/gitolite/gitolite-suexec-wrapper.sh
として所有者、実行権限を変更する。
・SSLクライアント認証設定
VirtualHost の設定に以下を追加
===============================================================================
SSLEngine on
SSLCertificateFile <サーバー証明書のパス>
SSLCertificateKeyFile <サーバ秘密鍵のパス>
SSLCACertficateFile <CA証明書のパス>
SSLVerifyClient require
SSLUserName SSL_CLIENT_S_DN_CN
SuexecUserGroup gitolite3:gitolite3
ScriptAlias /git /var/www/git/gitolite-suexec-wrapper.sh
<Location /git>
Order allow,deny
Allow from all
</Location>
===============================================================================
CAはオレオレCAで良い。SSLUserName設定はクライアント証明書のCNをユーザー名として扱うことの宣言。
環境変数REMOTE_USERもこれによって証明書CNに置き換わる。
■Gitolite3準備
次にGitolite3側の準備
・リポジトリアクセス権設定
Gitolite3のインストールによってgitolite-admin リポジトリが自動で生成されているはず。
まずはこれをローカルでclone する。そして conf/gitolite.conf を編集する。
例えばtesting リポジトリの設定が以下のようになっていたら
repo testing
RW+ = @all
↓
repo testing
RW+ = @all
R = daemon
というようにdaemonユーザーに対してRead権限を付与する。こうしないとApacheからGitolite3管理のリポジトリが読み出せない。Apacheからアクセスしたい全てのリポジトリにR = daemonを付与する。
変更したらcommit, push して反映
また当然であるが、クライアント証明書のCNと同じ名前のアクセス権限がリポジトリに設定されている必要がある。例えば、developというメンバーがクライアント認証でアクセスする場合にはtesting リポジトリの例で言うと
repo testing
RW = develop
R = daemon
とする。このときtestingリポジトリにApacheからはクライアント証明書のCNがdevelopでないとリポジトリにアクセスできない。
■クライアント側設定
・git設定ファイルの変更
(Linux)
~/.gitconfig
(Windows)
C:/Users/<ユーザー名>/.gitconfig
以下の設定を追記する
===============================================================================
[http]
sslCert = <クライアント証明書ファイルパス>
sslKey = <クライアント秘密鍵ファイルパス>
sslCaInfo = <CA証明書ファイルパス>
sslVerify = false
===============================================================================
最後のsslVefiry = false はオレオレCAの場合に必要。ちゃんと認証機関からCA証明書を取得しているなら不要。
■実行
以上の設定が完了していれば以下のコマンドでリポジトリの取得が可能なはず。
git clone https://<ドメイン名>/git/<リポジトリ名>
2014年6月15日日曜日
Beagle Boneのデバッグ
■openocd 0.7.0
openocd -f scripts/board/ti_beaglebone.cfg -c "init" -c "reset init" -c "arm core_state arm"
上記コマンドでopenocdが接続できる。
最後のコマンドはThumbモードからARMモードにするだけなので無くてもいい。
接続できない場合はopenocd ドライバフォルダにあるftdi2232ドライバのインストールをまず行う。
ドライバは自動認識しないので手動インストールでopenocdドライバフォルダにあるinfファイルを選択し、texas instrument xds100v2を選択してインストールする。
上記の方法でgdbからデバッグできるが、それには前提がある。
それはBeagleBone付属のSDカードからブートした後である。
ただしLinuxは起動してはいけない。
U-Bootが起動してLinuxロードの前にキー操作をしてU-Bootコンソールの状態に止めておく。
■gdb
Eclipseでgdbを使ってHardware Debuggingを行う際の注意。
Window-Preference-Run/Debug-Launching-Default Launchers-GDB Hardware Debuggingの設定
Eclipseのバージョンによってはこの設定がGDB(DSF) Hardware Debugging Launcherになっている。
しかしOpenOCD-gdbでデバッグする場合はLegacy GDB Hardware Debugging Launcherの設定でないとうまく動作しない。
■おまけ
U-Bootコンソールの起動を待ってからデバッグする理由
最初はDDRの初期化が行われていない。
したがってデバッグするプログラムをメモリにロードできないからである。
それでもロードしようとすると jtag-dap sticky error が発生する。
SDカードでのブートなしにロードしようとする場合はopenocd起動時にメモリの初期化コマンドを追加する必要がある。
その方法は調査中。
openocd -f scripts/board/ti_beaglebone.cfg -c "init" -c "reset init" -c "arm core_state arm"
上記コマンドでopenocdが接続できる。
最後のコマンドはThumbモードからARMモードにするだけなので無くてもいい。
接続できない場合はopenocd ドライバフォルダにあるftdi2232ドライバのインストールをまず行う。
ドライバは自動認識しないので手動インストールでopenocdドライバフォルダにあるinfファイルを選択し、texas instrument xds100v2を選択してインストールする。
上記の方法でgdbからデバッグできるが、それには前提がある。
それはBeagleBone付属のSDカードからブートした後である。
ただしLinuxは起動してはいけない。
U-Bootが起動してLinuxロードの前にキー操作をしてU-Bootコンソールの状態に止めておく。
■gdb
Eclipseでgdbを使ってHardware Debuggingを行う際の注意。
Window-Preference-Run/Debug-Launching-Default Launchers-GDB Hardware Debuggingの設定
Eclipseのバージョンによってはこの設定がGDB(DSF) Hardware Debugging Launcherになっている。
しかしOpenOCD-gdbでデバッグする場合はLegacy GDB Hardware Debugging Launcherの設定でないとうまく動作しない。
■おまけ
U-Bootコンソールの起動を待ってからデバッグする理由
最初はDDRの初期化が行われていない。
したがってデバッグするプログラムをメモリにロードできないからである。
それでもロードしようとすると jtag-dap sticky error が発生する。
SDカードでのブートなしにロードしようとする場合はopenocd起動時にメモリの初期化コマンドを追加する必要がある。
その方法は調査中。
登録:
投稿 (Atom)







