netx/scripts/start_netx.sh

#!/usr/bin/env bash
set -euo pipefail

# netx Linux start script (API + Web)
# - API: python -m netx_api.main (default 8890)
# - Web: Vite dev server (default 8505, external)
#
# PID/log files are stored in: scripts/.run/

usage() {
  cat <<'EOF'
Usage: ./scripts/start_netx.sh [options]

Options:
  --python-cmd <path>   Python executable. Default: /usr/local/python_env_new/bin/python3
                        (or env PYTHON_CMD if set)
  --node-cmd <path>     Node.js executable (requires v20+).
                        Default: /usr/local/nodejs/node-v24.16.0-linux-x64/bin/node
  --npm-cmd <path>      npm executable. Default: npm in same directory as NODE_CMD
  --bind-host <host>    API bind host (sets NETX_HOST). Default: 127.0.0.1
  --port <port>         API port (sets NETX_PORT). Default: 8890
  --web-host <host>     Web bind host. Default: 0.0.0.0
  --web-port <port>     Web port. Default: 8505
  --api-only            Start API only (no Node/npm on this host)
  --inline-schedulers   Keep collectors inside API (no worker process)
  --skip-install        Skip pip/npm install steps
  -h, --help            Show help

Notes:
  - By default starts API + worker (config_sync / lldp / port_traffic) + optional web.
  - Sets NETX_RUN_INLINE_SCHEDULERS=false unless --inline-schedulers is passed.
  - Runs with system/host Python (no .venv).
  - Web uses isolated Node at /usr/local/nodejs/node-v24.16.0-linux-x64 (not system PATH).
  - Override with NODE_CMD / --node-cmd if install path differs.
  - Or use --api-only and serve web/dist via Nginx (no Node on this host).
  - If repo root has a .env file, it will be sourced (exported).
EOF
}

check_node_version() {
  local node_cmd="$1"
  local version major
  if ! version="$("${node_cmd}" -v 2>/dev/null | sed 's/^v//')"; then
    echo "[ERR] node_version_check_failed: ${node_cmd}" >&2
    exit 1
  fi
  major="${version%%.*}"
  if [[ -z "${major}" ]] || [[ "${major}" -lt 20 ]]; then
    echo "[ERR] node_version_too_old: requires Node.js 20+, current: v${version}" >&2
    echo "      Does not require upgrading system Node. Options:" >&2
        echo "        1) Set NODE_CMD to Node 20+ binary (default: /usr/local/nodejs/node-v24.16.0-linux-x64/bin/node)" >&2
    echo "        2) API only:         ./scripts/start_netx.sh --api-only" >&2
    exit 1
  fi
}

resolve_node_tools() {
  NODE_CMD="${NODE_CMD:-/usr/local/nodejs/node-v24.16.0-linux-x64/bin/node}"

  if [[ "${NODE_CMD}" == */* ]]; then
    if [[ ! -x "${NODE_CMD}" ]]; then
      echo "[ERR] node_not_found: ${NODE_CMD}" >&2
      exit 1
    fi
    NODE_BIN_DIR="$(cd "$(dirname "${NODE_CMD}")" && pwd)"
    export PATH="${NODE_BIN_DIR}:${PATH}"
    NPM_CMD="${NPM_CMD:-${NODE_BIN_DIR}/npm}"
  else
    if ! command -v "${NODE_CMD}" >/dev/null 2>&1; then
      echo "[ERR] node_not_found: ${NODE_CMD} (not in PATH)" >&2
      echo "      Set NODE_CMD or pass --node-cmd <path>" >&2
      exit 1
    fi
    NODE_CMD="$(command -v "${NODE_CMD}")"
    NPM_CMD="${NPM_CMD:-npm}"
  fi

  if [[ "${NPM_CMD}" == */* ]]; then
    if [[ ! -x "${NPM_CMD}" ]]; then
      echo "[ERR] npm_not_found: ${NPM_CMD}" >&2
      exit 1
    fi
  elif ! command -v "${NPM_CMD}" >/dev/null 2>&1; then
    echo "[ERR] npm_not_found: ${NPM_CMD} (not in PATH)" >&2
    exit 1
  else
    NPM_CMD="$(command -v "${NPM_CMD}")"
  fi

  check_node_version "${NODE_CMD}"
}

ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
RUN_DIR="${ROOT_DIR}/scripts/.run"
mkdir -p "${RUN_DIR}"

PID_FILE="${RUN_DIR}/netx.pid"
LOG_FILE="${RUN_DIR}/netx.out.log"
ERR_FILE="${RUN_DIR}/netx.err.log"
WORKER_PID_FILE="${RUN_DIR}/worker.pid"
WORKER_LOG_FILE="${RUN_DIR}/worker.out.log"
WORKER_ERR_FILE="${RUN_DIR}/worker.err.log"
WEB_PID_FILE="${RUN_DIR}/web.pid"
WEB_LOG_FILE="${RUN_DIR}/web.out.log"
WEB_ERR_FILE="${RUN_DIR}/web.err.log"

PYTHON_CMD="${PYTHON_CMD:-/usr/local/python_env_new/bin/python3}"
NODE_CMD="${NODE_CMD:-/usr/local/nodejs/node-v24.16.0-linux-x64/bin/node}"
API_BIND_HOST="127.0.0.1"
API_PORT="8890"
WEB_BIND_HOST="0.0.0.0"
WEB_PORT="8505"
SKIP_INSTALL="0"
API_ONLY="0"
INLINE_SCHEDULERS="0"

while [[ $# -gt 0 ]]; do
  case "$1" in
    --python-cmd) PYTHON_CMD="${2:-}"; shift 2 ;;
    --node-cmd) NODE_CMD="${2:-}"; shift 2 ;;
    --npm-cmd) NPM_CMD="${2:-}"; shift 2 ;;
    --bind-host) API_BIND_HOST="${2:-}"; shift 2 ;;
    --port) API_PORT="${2:-}"; shift 2 ;;
    --web-host) WEB_BIND_HOST="${2:-}"; shift 2 ;;
    --web-port) WEB_PORT="${2:-}"; shift 2 ;;
    --api-only) API_ONLY="1"; shift ;;
    --inline-schedulers) INLINE_SCHEDULERS="1"; shift ;;
    --skip-install) SKIP_INSTALL="1"; shift ;;
    -h|--help) usage; exit 0 ;;
    *) echo "[ERR] Unknown arg: $1" >&2; usage; exit 2 ;;
  esac
done

cd "${ROOT_DIR}"

if [[ -f "${PID_FILE}" ]] || [[ -f "${WEB_PID_FILE}" ]]; then
  echo "[INFO] Existing PID file(s) found under ${RUN_DIR}."
  echo "       If services are not actually running, remove PID files or run ./scripts/stop_netx.sh"
fi

if [[ -f "${ROOT_DIR}/.env" ]]; then
  set -a
  # shellcheck disable=SC1091
  source "${ROOT_DIR}/.env"
  set +a
fi

export NETX_HOST="${API_BIND_HOST}"
export NETX_PORT="${API_PORT}"
export PYTHONPATH="${ROOT_DIR}${PYTHONPATH:+:${PYTHONPATH}}"
if [[ "${INLINE_SCHEDULERS}" == "1" ]]; then
  export NETX_RUN_INLINE_SCHEDULERS="true"
else
  export NETX_RUN_INLINE_SCHEDULERS="false"
fi

if [[ ! -x "${PYTHON_CMD}" ]]; then
  echo "[ERR] python_not_found: ${PYTHON_CMD}" >&2
  echo "      Set PYTHON_CMD or pass --python-cmd <path>" >&2
  exit 1
fi

echo "==> Project root: ${ROOT_DIR}"
echo "==> Using python: ${PYTHON_CMD}"

if [[ "${SKIP_INSTALL}" != "1" ]]; then
  echo "==> Installing backend dependencies"
  "${PYTHON_CMD}" -m pip install -r "${ROOT_DIR}/requirements.txt"
else
  echo "==> Skip dependency install"
fi

BASE_URL="http://${API_BIND_HOST}:${API_PORT}"

if [[ "${API_ONLY}" != "1" ]]; then
  resolve_node_tools
  echo "==> Using node:   ${NODE_CMD} ($("${NODE_CMD}" -v))"
  echo "==> Using npm:    ${NPM_CMD} ($("${NPM_CMD}" -v))"

  WEB_ROOT="${ROOT_DIR}/web"
  if [[ ! -d "${WEB_ROOT}" ]]; then
    echo "[ERR] web/ not found: ${WEB_ROOT}" >&2
    exit 1
  fi

  if [[ "${SKIP_INSTALL}" != "1" ]] || [[ ! -d "${WEB_ROOT}/node_modules" ]]; then
    echo "==> Installing web dependencies (npm install)"
    (cd "${WEB_ROOT}" && "${NPM_CMD}" install)
  else
    echo "==> Skip web dependency install (node_modules exists)"
  fi
fi

WEB_URL="http://${WEB_BIND_HOST}:${WEB_PORT}"

echo ""
echo "==> netx API URL"
echo "Base:          ${BASE_URL}/"
echo "Health:        ${BASE_URL}/health"
echo "Ready:         ${BASE_URL}/health/ready"
echo "Metrics:       ${BASE_URL}/metrics"
echo "Integrations:  ${BASE_URL}/v1/integrations/status"
if [[ "${INLINE_SCHEDULERS}" == "1" ]]; then
  echo "Schedulers:    inline with API (--inline-schedulers)"
else
  echo "Schedulers:    external worker (auto-started by this script)"
fi
if [[ "${API_ONLY}" == "1" ]]; then
  echo ""
  echo "==> Web: skipped (--api-only). Serve web/dist via Nginx or run dev on another host."
else
  echo ""
  echo "==> netx UI URL"
  echo "Vite Dev UI:   ${WEB_URL}/"
fi
echo ""

echo "==> Starting netx API in background"
(
  cd "${ROOT_DIR}"
  nohup "${PYTHON_CMD}" -m netx_api.main >"${LOG_FILE}" 2>"${ERR_FILE}" &
  echo $! > "${PID_FILE}"
)
API_PID="$(cat "${PID_FILE}")"
echo "netx.pid = ${PID_FILE}"
echo "PID      = ${API_PID}"
echo "Log      = ${LOG_FILE}"
echo "Err      = ${ERR_FILE}"

if [[ "${INLINE_SCHEDULERS}" != "1" ]]; then
  echo "==> Starting netx worker (config_sync / lldp / port_traffic)"
  (
    cd "${ROOT_DIR}"
    nohup "${PYTHON_CMD}" -m netx_api.worker >"${WORKER_LOG_FILE}" 2>"${WORKER_ERR_FILE}" &
    echo $! > "${WORKER_PID_FILE}"
  )
  WORKER_PID="$(cat "${WORKER_PID_FILE}")"
  echo "worker.pid = ${WORKER_PID_FILE}"
  echo "PID        = ${WORKER_PID}"
  echo "Log        = ${WORKER_LOG_FILE}"
  echo "Err        = ${WORKER_ERR_FILE}"

  REPLICAS="${NETX_BIZ_STATE_WORKER_REPLICAS:-2}"
  if [[ "${REPLICAS}" -lt 1 ]]; then REPLICAS=1; fi
  BIZ_DIR="${RUN_DIR}/biz_state_workers"
  mkdir -p "${BIZ_DIR}"
  echo "==> Starting biz_state workers (replicas=${REPLICAS})"
  for ((i=0; i<REPLICAS; i++)); do
    (
      cd "${ROOT_DIR}"
      nohup "${PYTHON_CMD}" -m netx_api.biz_state_worker \
        >"${BIZ_DIR}/worker${i}.out.log" 2>"${BIZ_DIR}/worker${i}.err.log" &
      echo $! > "${BIZ_DIR}/worker${i}.pid"
    )
    echo "biz_state_worker[${i}] PID=$(cat "${BIZ_DIR}/worker${i}.pid")"
  done
fi

if [[ "${API_ONLY}" != "1" ]]; then
  echo "==> Starting Vite dev server in background"
  (
    cd "${WEB_ROOT}"
    nohup "${NPM_CMD}" run dev -- --host "${WEB_BIND_HOST}" --port "${WEB_PORT}" \
      >"${WEB_LOG_FILE}" 2>"${WEB_ERR_FILE}" &
    echo $! > "${WEB_PID_FILE}"
  )
  WEB_PID="$(cat "${WEB_PID_FILE}")"
  echo "web.pid  = ${WEB_PID_FILE}"
  echo "PID      = ${WEB_PID}"
  echo "Log      = ${WEB_LOG_FILE}"
  echo "Err      = ${WEB_ERR_FILE}"
fi

echo ""
if [[ "${API_ONLY}" == "1" ]]; then
  echo "==> API(+worker) started (--api-only)."
else
  echo "==> Background services started; API/worker/web keep running."
fi