PD File's Handler
デフォルトパス
PD File's Handler に関連するファイルのデフォルトパスは次の通りです。
PD File's Handler に関連するファイルのデフォルトパス
| パス名 | 説明 |
|---|---|
| /usr/sbin/pd_files_handler | 常駐実行オブジェクト（デーモン） |
| /lib/systemd/system/pd_files_handler.service | Systemd Service ファイル |
| /etc/init.d/pd_files_handler | RC ファイル |
| /var/webui/config/pd_files_handler.conf | 設定ファイル |
| /var/run/pd_files_handler.pid | PID ファイル |
設定ファイルの書式
構文
Root オブジェクト
| キー | データ型 | 説明 |
|---|---|---|
| enable | 論理値 | デフォルト値は false. |
| res_memory | 整数値 | 常駐メモリの増加分の上限値(Mbyte). 上限を越えると基幹プロセスを再起動する. デフォルト値は16. |
| debug | 整数値 | デバックレベル 0 ～ 4. デフォルト値は0. |
| interval | 整数値 | 処理終了から次の処理開始（ファイルの取り込み）までの間隔(sec). デフォルト値は 30. |
| folder | 文字列 | ファイルを取り込むディレクトリのパス名. デフォルト値は '/var/webui/pd files handler'. |
| cloud | 文字列 | アップロード先クラウドの種別. 'webdav'(WebDAV), 'aws'(Amazon S3),'google'(GCS: Google Cloud Strage) のいずれか. デフォルト値は'webdav'. |
| fn mode | 文字列 | アップロード先におけるファイル名. 'asis', 'md5', 'sha256', 'timestamp', 'serial' のいずれか. 'asis' は入力ファイル名をそのまま用いる. 'md5' は入力ファイル名にシリアル番号と時刻を連結した文字列のMD5 ハッシュ値. 'sha256' は入力ファイル名にシリアル番号と時刻を連結した文字列の SHA256 ハッシュ値. 'timestamp' は入力ファイル名に時刻を連結した '<filename><YYYYMMDDTHHMMSS.SSS>' 形式の文字列. 'serial' はシリアル番号に入力ファイル名と時刻を連結した '<serial><filename><YYYYMMDDTHHMMSS.SSS>' 形式の文字列. デフォルト値は 'sha256'. |
| url | 文字列 | アップロード先のURL. Amazon S3 の場合は 'https://<bucket>.s3.<region>.amazonaws.com'、GCS の場合は 'https://storage.googleapis.com/<bucket>'. パス名（フォルダ名）に UTF8 日本語文字列やスペース等を用いる場合は、URL RAW エンコードを行い指定する. |
| content_type | 文字列 | HTTP ヘッダーに付加される 'Content-Type'. デフォルト値は 'application/octet-stream'. |
| conn_timeout | 整数値 | HTTP の接続タイムアウト(sec). デフォルト値は 10. |
| timeout | 整数値 | HTTP の処理タイムアウト(sec). デフォルト値は 180. |
| truststore | 文字列 | SSL 接続に用いるRoot CA 証明書のパス名. デフォルト値は '/etc/ssl/certs/ca-certificates.crt'. |
| ssl verify | 論理値 | サーバー証明書の検証を行うか否か. デフォルト値はアップロード先が WebDAV の場合はfalse、AWS S3 又はGCS の場合は true. |
| username | 文字列 | WebDAV への接続に用いる BASIC 認証ユーザ名. 'cloud' が 'webdav' の場合のみ有効. |
| password | 文字列 | WebDAV への接続に用いる BASIC 認証パスワード. 'cloud' が 'webdav' の場合のみ有効. |
| accessid | 文字列 | Amazon S3 への接続に用いるアクセスID. 'cloud' が'aws' の場合のみ有効. |
| accesskey | 文字列 | Amazon S3 への接続に用いるアクセスキー. 'cloud' が 'aws' の場合のみ有効. |
| accesskey_id | 文字列 | GCS への接続に用いるアクセスキーID. 'cloud' が'google' の場合のみ有効. |
| accesskey_secret | 文字列 | GCS への接続に用いるアクセスキーシークレット. cloud' が'google' の場合のみ有効. |
| metadata | 論理値 | メタ情報を通知するか否か. デフォルト値はtrue. |
| serial | 文字列 | ファイルの送り元を識別するためのシリアル番号. デフォルト値は OpenBlocks IoT Family のシリアル番号. |
| localname | 文字列 | デバイスのローカル名. デフォルト値は 'files 0000001'. |
| push_to | 文字列 | メタ情報の送り先ソケット名. 文字列の先頭が '@' の場合は abstract namespace と解釈する. 空の場合は、デフォルト値 '@/pd_repeater/<localname>.sock' が設定される. |
| location | 論理値 | メタ情報にOpenBlocks IoT Family に設定されてる位置情報を付加するか否か. デフォルト値は false. |
メタ情報の書式
構文
メタ情報オブジェクト
| キー | データ型 | 説明 |
|---|---|---|
| file | 文字列 | アップロードしたファイルの元のファイル名. |
| md5 | 文字列 | アップロードしたファイルのMD5 値. |
| content-type | 文字列 | HTTP ヘッダーに付加されたContent-Type. |
| mtime | 文字列 | アップロードしたファイルの更新日時. |
| size | 整数値 | アップロードしたファイルのサイズ(byte). |
| url | 文字列 | アップロードしたファイルのアップロード先 URL. |
| serial | 文字列 | アップロード元を識別するシリアル番号. |
| latitude | 実数値 | アップロード元の緯度. |
| longitude | 実数値 | アップロード元の経度. |
| elevation | 実数値 | アップロード元の標高. |
| timestamp | 文字列 | アップロードした時刻. |