メインコンテンツまでスキップ

バイナリパッケージからの提供

概要​

バイナリパッケージ環境でapi-agentをインストールするガイドです。 exemone-api-agent-v3.0.508.3バージョンを例にします。

1. ダウンロード​

ダウンロード場所はどこでも構いません。

cd exemone
mkdir agent
cd agent
<여기에 api-agent 다운로드>

tar -zxvf exemone-api-agent-v3.0.508.3.tar.gz # 解凍

2. binsディレクトリに実行バイナリをコピー​

cd exemone-api-agent-v3.0.508.3
cp exemone-api-agent-v3.0.508.3 /home/exemone/exemone/bins/exemone-api-agent/

3. licenses作成​

cd /home/exemone/exemone/licenses
mkdir exemone-api-agent

cd /home/exemone/exemone/agent/exemone-api-agent-v3.0.508.3
cp -r licenses home/exemone/exemone/licenses/exemone-api-agent

4. .envにバージョン入力​

cd /home/exemone/exemone
vi .env
EXEMONE_API_AGENT=exemone-api-agent-v3.0.508.3

5. api-agent実行&停止スクリプト​

cd /home/exemone/exemone/services/exemone-api-agent

  • start.sh
#!/bin/bash
set -e
if [ -z "${EXEMONE_HOME}" ]; then
    export EXEMONE_HOME="$(dirname $(dirname $(pwd)))"
    echo "set EXEMONE_HOME=$EXEMONE_HOME"
fi
. "${EXEMONE_HOME}/scripts/lib.sh"

# 変数設定
cur_dir=$(pwd)

# Load .env file if it exists in current directory
if [ -f "${cur_dir}/.env" ]; then
    set -a  # Enable auto-export
    source "${cur_dir}/.env"
    set +a  # Disable auto-export
fi
service_name=$(basename "${cur_dir}")
pid_file=${cur_dir}/${service_name}.pid
binary_file=${EXEMONE_HOME}/bins/exemone-api-agent/${EXEMONE_API_AGENT}
config_file=${cur_dir}/configs/agent.yaml
signal_file=${cur_dir}/signal.act
lockfile=${cur_dir}/${service_name}.lock

(
  flock -n 200 || { log INFO "${service_name} start.sh already running. Exiting."; exit 1; }

  log INFO "Start ${service_name} init"
  # LD_LIBRARY_PATHの設定
  if [[ -z "${LD_LIBRARY_PATH}" ]]; then
      export LD_LIBRARY_PATH=${EXEMONE_HOME}/libs
  elif [[ ! ${LD_LIBRARY_PATH} =~ ${EXEMONE_HOME}/libs ]]; then
      export LD_LIBRARY_PATH="${EXEMONE_HOME}/libs:${LD_LIBRARY_PATH}"
  fi

  # 既存に実行中のプロセスを終了
  if [ -f "${pid_file}" ]; then
      log "INFO" "Stop ${service_name} process before start process"
      stop_process "${service_name}" "${pid_file}"
  fi

    # 実行中のsignalがあれば削除
  if [ -f "${signal_file}" ]; then
      rm -f "${signal_file}"
  fi

  # プロセス開始
  log "INFO" "Start ${service_name} process"
  nohup "${binary_file}" start --config "${config_file}" > /dev/null 2>&1 & echo -n $! > "${pid_file}"

  # プロセス開始確認
  sleep 1
  check_process "${service_name}" "${pid_file}"
) 200>"${lockfile}"

stop.sh

#!/bin/bash
set -e
if [ -z ${EXEMONE_HOME} ]; then
    export EXEMONE_HOME="$(dirname $(dirname $(pwd)))"
    echo "set EXEMONE_HOME=$EXEMONE_HOME"
fi
. ${EXEMONE_HOME}/scripts/lib.sh

# 現在のディレクトリ名
cur_dir=$(pwd)
service_name=$(basename ${cur_dir})
pid_file=${cur_dir}/${service_name}.pid
signal_file=${cur_dir}/signal.act

touch ${signal_file}
stop_process ${service_name} ${pid_file}

version.sh

set -e
if [ -z ${EXEMONE_HOME} ]; then
    export EXEMONE_HOME="$(dirname $(dirname $(pwd)))"
    echo "set EXEMONE_HOME=$EXEMONE_HOME"
fi
. ${EXEMONE_HOME}/scripts/lib.sh

# 現在のディレクトリ名
cur_dir=$(pwd)
service_name=$(basename ${cur_dir})
binary_path=${EXEMONE_HOME}/bins/exemone-api-agent/${EXEMONE_API_AGENT}

${binary_path} version

6. 権限の付与​

cd services/exemone-api-agent/
chmod +x *.sh

7. observer動作のためのファイル追加​

cd /home/exemone/exemone/services/exemone-api-agent vi observer.properties

monitoring=true

8. onectlファイル修正​

修正事項が多いため、既存のonectlファイルを該当onectlファイルに置き換えます。

権限の付与

chmod +x onectl

動作例​

実行

[exemone@localhost exemone]$ ./onectl start api-agent
Starting service : exemone-api-agent
[2025-11-05 13:17:25] EXEMONE INFO Start exemone-api-agent init
[2025-11-05 13:17:25] EXEMONE INFO Start exemone-api-agent process
[2025-11-05 13:17:26] EXEMONE INFO exemone-api-agent process is started. pid: 1499726

ログ確認

[exemone@localhost exemone]$ ./onectl log api-agent
Selected service: exemone-api-agent
2025-11-05 13:06:13 INF receive start service=url-agent
2025-11-05 13:06:13 INF send loop start service=url-agent
2025-11-05 13:06:18 INF [STAT][INIT] service=url-agent
2025-11-05 13:17:25 INF [SNED] send agent info service=url-agent
2025-11-05 13:17:25 INF check instance start service=url-agent
2025-11-05 13:17:25 INF receive loop start service=url-agent
2025-11-05 13:17:25 INF send loop start service=url-agent
2025-11-05 13:17:25 INF receive start service=url-agent
2025-11-05 13:17:25 INF collect start service=url-agent
2025-11-05 13:17:30 INF [STAT][INIT] service=url-agent

バージョン確認

[exemone@localhost exemone]$ ./onectl ver api-agent
Checking version of service : exemone-api-agent
exemONE service Version: v3.0.508.3, CommitID: 4887b2d5
BuildTime: Mon Nov  3 06:50:07 UTC 2025, Build With go1.20.4

停止

[exemone@localhost exemone]$ ./onectl stop api-agent
Stoping service : exemone-api-agent
[2025-11-05 13:18:16] EXEMONE INFO Stop exemone-api-agent process. pid: 1499726