emqx 42 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302
  1. #!/usr/bin/env bash
  2. # -*- tab-width:4;indent-tabs-mode:nil -*-
  3. # ex: ts=4 sw=4 et
  4. set -euo pipefail
  5. DEBUG="${DEBUG:-0}"
  6. if [ "$DEBUG" -eq 1 ]; then
  7. set -x
  8. fi
  9. if [ "$DEBUG" -eq 2 ]; then
  10. set -x
  11. export PS4='+(${BASH_SOURCE}:${LINENO}): ${FUNCNAME[0]:+${FUNCNAME[0]}(): }'
  12. fi
  13. # We need to find real directory with emqx files on all platforms
  14. # even when bin/emqx is symlinked on several levels
  15. # - readlink -f works perfectly, but `-f` flag has completely different meaning in BSD version,
  16. # so we can't use it universally.
  17. # - `stat -f%R` on MacOS does exactly what `readlink -f` does on Linux, but we can't use it
  18. # as a universal solution either because GNU stat has different syntax and this argument is invalid.
  19. # Also, version of stat which supports this syntax is only available since MacOS 12
  20. if [ "$(uname -s)" == 'Darwin' ]; then
  21. product_version="$(sw_vers -productVersion | cut -d '.' -f 1)"
  22. if [ "$product_version" -ge 12 ]; then
  23. # if homebrew coreutils package is installed, GNU version of stat can take precedence,
  24. # so we use absolute path to ensure we are calling MacOS default
  25. RUNNER_ROOT_DIR="$(cd "$(dirname "$(/usr/bin/stat -f%R "$0" || echo "$0")")"/..; pwd -P)"
  26. else
  27. # try our best to resolve link on MacOS <= 11
  28. RUNNER_ROOT_DIR="$(cd "$(dirname "$(readlink "$0" || echo "$0")")"/..; pwd -P)"
  29. fi
  30. else
  31. RUNNER_ROOT_DIR="$(cd "$(dirname "$(realpath "$0" || echo "$0")")"/..; pwd -P)"
  32. fi
  33. # shellcheck disable=SC1090,SC1091
  34. . "$RUNNER_ROOT_DIR"/releases/emqx_vars
  35. # defined in emqx_vars
  36. export RUNNER_ROOT_DIR
  37. export EMQX_ETC_DIR
  38. export REL_VSN
  39. export SCHEMA_MOD
  40. export IS_ENTERPRISE
  41. RUNNER_SCRIPT="$RUNNER_BIN_DIR/$REL_NAME"
  42. CODE_LOADING_MODE="${CODE_LOADING_MODE:-embedded}"
  43. REL_DIR="$RUNNER_ROOT_DIR/releases/$REL_VSN"
  44. WHOAMI=$(whoami)
  45. # hocon try to read environment variables starting with "EMQX_"
  46. export HOCON_ENV_OVERRIDE_PREFIX='EMQX_'
  47. export ERTS_DIR="$RUNNER_ROOT_DIR/erts-$ERTS_VSN"
  48. export BINDIR="$ERTS_DIR/bin"
  49. export EMU="beam"
  50. export PROGNAME="erl"
  51. export ERTS_LIB_DIR="$RUNNER_ROOT_DIR/lib"
  52. DYNLIBS_DIR="$RUNNER_ROOT_DIR/dynlibs"
  53. logerr() {
  54. if [ "${TERM:-dumb}" = dumb ]; then
  55. echo -e "ERROR: $*" 1>&2
  56. else
  57. echo -e "$(tput setaf 1)ERROR: $*$(tput sgr0)" 1>&2
  58. fi
  59. }
  60. logwarn() {
  61. if [ "${TERM:-dumb}" = dumb ]; then
  62. echo "WARNING: $*"
  63. else
  64. echo "$(tput setaf 3)WARNING: $*$(tput sgr0)"
  65. fi
  66. }
  67. logdebug() {
  68. if [ "$DEBUG" -eq 1 ]; then
  69. echo "DEBUG: $*"
  70. fi
  71. }
  72. die() {
  73. set +x
  74. logerr "$1"
  75. errno=${2:-1}
  76. exit "$errno"
  77. }
  78. assert_node_alive() {
  79. if ! relx_nodetool "ping" > /dev/null; then
  80. exit 1
  81. fi
  82. }
  83. usage() {
  84. local command="$1"
  85. case "$command" in
  86. start)
  87. echo "Start EMQX service in daemon mode"
  88. ;;
  89. stop)
  90. echo "Stop the running EMQX program"
  91. ;;
  92. console)
  93. echo "Boot up EMQX service in an interactive Erlang or Elixir shell"
  94. echo "This command needs a tty"
  95. ;;
  96. console_clean)
  97. echo "This command does NOT boot up the EMQX service"
  98. echo "It only starts an interactive Erlang or Elixir console with all the"
  99. echo "EMQX code available"
  100. ;;
  101. foreground)
  102. echo "Start EMQX in foreground mode without an interactive shell"
  103. ;;
  104. pid)
  105. echo "Print out EMQX process identifier"
  106. ;;
  107. ping)
  108. echo "Check if the EMQX node is up and running"
  109. echo "This command exit with 0 silently if node is running"
  110. ;;
  111. escript)
  112. echo "Execute a escript using the Erlang runtime from EMQX package installation"
  113. echo "For example $REL_NAME escript /path/to/my/escript my_arg1 my_arg2"
  114. ;;
  115. attach)
  116. echo "This command is applicable when EMQX is started in daemon mode."
  117. echo "It attaches the current shell to EMQX's control console"
  118. echo "through a named pipe."
  119. logwarn "try to use the safer alternative, remote_console command."
  120. ;;
  121. remote_console)
  122. echo "Start an interactive shell running an Erlang or Elixir node which "
  123. echo "hidden-connects to the running EMQX node".
  124. echo "This command is mostly used for troubleshooting."
  125. ;;
  126. ertspath)
  127. echo "Print path to Erlang runtime bin dir"
  128. ;;
  129. rpc)
  130. echo "Usage: $REL_NAME rpc MODULE FUNCTION [ARGS, ...]"
  131. echo "Connect to the EMQX node and make an Erlang RPC"
  132. echo "This command blocks for at most 60 seconds."
  133. echo "It exits with non-zero code in case of any RPC failure"
  134. echo "including connection error and runtime exception"
  135. ;;
  136. rpcterms)
  137. echo "Usage: $REL_NAME rpcterms MODULE FUNCTION [ARGS, ...]"
  138. echo "Connect to the EMQX node and make an Erlang RPC"
  139. echo "The result of the RPC call is pretty-printed as an "
  140. echo "Erlang term"
  141. ;;
  142. root_dir)
  143. echo "Print EMQX installation root dir"
  144. ;;
  145. eval)
  146. echo "Evaluate an Erlang expression in the EMQX node."
  147. ;;
  148. eval-ex)
  149. echo "Evaluate an Elixir expression in the EMQX node. Only applies to Elixir node"
  150. ;;
  151. versions)
  152. echo "List installed EMQX release versions and their status"
  153. ;;
  154. unpack)
  155. echo "Usage: $REL_NAME unpack [VERSION]"
  156. echo "Unpacks a release package VERSION, it assumes that this"
  157. echo "release package tarball has already been deployed at one"
  158. echo "of the following locations:"
  159. echo " releases/<relname>-<version>.tar.gz"
  160. ;;
  161. install)
  162. echo "Usage: $REL_NAME install [VERSION]"
  163. echo "Installs a release package VERSION, it assumes that this"
  164. echo "release package tarball has already been deployed at one"
  165. echo "of the following locations:"
  166. echo " releases/<relname>-<version>.tar.gz"
  167. echo ""
  168. echo " --no-permanent Install release package VERSION but"
  169. echo " don't make it permanent"
  170. ;;
  171. uninstall)
  172. echo "Usage: $REL_NAME uninstall [VERSION]"
  173. echo "Uninstalls a release VERSION, it will only accept"
  174. echo "versions that are not currently in use"
  175. ;;
  176. upgrade)
  177. echo "Usage: $REL_NAME upgrade [VERSION]"
  178. echo "Upgrades the currently running release to VERSION, it assumes"
  179. echo "that a release package tarball has already been deployed at one"
  180. echo "of the following locations:"
  181. echo " releases/<relname>-<version>.tar.gz"
  182. echo ""
  183. echo " --no-permanent Install release package VERSION but"
  184. echo " don't make it permanent"
  185. ;;
  186. downgrade)
  187. echo "Usage: $REL_NAME downgrade [VERSION]"
  188. echo "Downgrades the currently running release to VERSION, it assumes"
  189. echo "that a release package tarball has already been deployed at one"
  190. echo "of the following locations:"
  191. echo " releases/<relname>-<version>.tar.gz"
  192. echo ""
  193. echo " --no-permanent Install release package VERSION but"
  194. echo " don't make it permanent"
  195. ;;
  196. check_config)
  197. echo "Checks the EMQX config without generating any files"
  198. ;;
  199. *)
  200. echo "Usage: $REL_NAME COMMAND [help]"
  201. echo ''
  202. echo "Commonly used COMMANDs:"
  203. echo " start: Start EMQX in daemon mode"
  204. echo " console: Start EMQX in an interactive Erlang or Elixir shell"
  205. echo " foreground: Start EMQX in foreground mode without an interactive shell"
  206. echo " stop: Stop the running EMQX node"
  207. echo " ctl: Administration commands, execute '$REL_NAME ctl help' for more details"
  208. echo ''
  209. echo "More:"
  210. echo " Shell attach: remote_console | attach"
  211. # echo " Up/Down-grade: upgrade | downgrade | install | uninstall | versions" # TODO enable when supported
  212. echo " Install Info: ertspath | root_dir"
  213. echo " Runtime Status: pid | ping"
  214. echo " Validate Config: check_config"
  215. echo " Advanced: console_clean | escript | rpc | rpcterms | eval | eval-ex"
  216. echo ''
  217. echo "Execute '$REL_NAME COMMAND help' for more information"
  218. ;;
  219. esac
  220. }
  221. COMMAND="${1:-}"
  222. GREP='grep --color=never'
  223. if [ -z "$COMMAND" ]; then
  224. usage 'help'
  225. exit 1
  226. elif [ "$COMMAND" = 'help' ]; then
  227. usage 'help'
  228. exit 0
  229. fi
  230. if [ "${2:-}" = 'help' ]; then
  231. ## 'ctl' command has its own usage info
  232. if [ "$COMMAND" != 'ctl' ]; then
  233. usage "$COMMAND"
  234. exit 0
  235. fi
  236. fi
  237. ## IS_BOOT_COMMAND is set for later to inspect node name and cookie from hocon config (or env variable)
  238. case "${COMMAND}" in
  239. start|console|console_clean|foreground|check_config)
  240. IS_BOOT_COMMAND='yes'
  241. ;;
  242. ertspath)
  243. echo "$ERTS_DIR"
  244. exit 0
  245. ;;
  246. root_dir)
  247. echo "$RUNNER_ROOT_DIR"
  248. exit 0
  249. ;;
  250. *)
  251. IS_BOOT_COMMAND='no'
  252. ;;
  253. esac
  254. ## backward compatible
  255. if [ -d "$ERTS_DIR/lib" ]; then
  256. export LD_LIBRARY_PATH="$ERTS_DIR/lib:$LD_LIBRARY_PATH"
  257. fi
  258. # Simple way to check the correct user and fail early
  259. check_user() {
  260. # Validate that the user running the script is the owner of the
  261. # RUN_DIR.
  262. if [ "$RUNNER_USER" ] && [ "x$WHOAMI" != "x$RUNNER_USER" ]; then
  263. if [ "x$WHOAMI" != "xroot" ]; then
  264. echo "You need to be root or use sudo to run this command"
  265. exit 1
  266. fi
  267. CMD="DEBUG=$DEBUG \"$RUNNER_SCRIPT\" "
  268. for ARG in "$@"; do
  269. CMD="${CMD} \"$ARG\""
  270. done
  271. # This will drop privileges into the runner user
  272. # It exec's in a new shell and the current shell will exit
  273. exec su - "$RUNNER_USER" -c "$CMD"
  274. fi
  275. }
  276. # Make sure the user running this script is the owner and/or su to that user
  277. check_user "$@"
  278. ES=$?
  279. if [ "$ES" -ne 0 ]; then
  280. exit $ES
  281. fi
  282. # Make sure log directory exists
  283. mkdir -p "$EMQX_LOG_DIR"
  284. # turn off debug as this is static
  285. set +x
  286. COMPATIBILITY_CHECK='
  287. io:format("BEAM_OK~n", []),
  288. try
  289. [_|_] = L = crypto:info_lib(),
  290. io:format("CRYPTO_OK ~0p~n", [L])
  291. catch
  292. _ : _ ->
  293. %% so logger has the chance to log something
  294. timer:sleep(100),
  295. halt(1)
  296. end,
  297. try
  298. mnesia_hook:module_info(),
  299. io:format("MNESIA_OK~n", [])
  300. catch
  301. _ : _ ->
  302. io:format("WARNING: Mnesia app has no post-coommit hook support~n", []),
  303. halt(2)
  304. end,
  305. halt(0).
  306. '
  307. [ "$DEBUG" -eq 1 ] && set -x
  308. compatiblity_info() {
  309. # RELEASE_LIB is used by Elixir
  310. # set crash-dump bytes to zero to ensure no crash dump is generated when erl crashes
  311. env ERL_CRASH_DUMP_BYTES=0 "$BINDIR/$PROGNAME" \
  312. -noshell \
  313. -boot "$REL_DIR/start_clean" \
  314. -boot_var RELEASE_LIB "$ERTS_LIB_DIR/lib" \
  315. -eval "$COMPATIBILITY_CHECK"
  316. }
  317. # Collect Erlang/OTP runtime sanity and compatibility in one go
  318. maybe_use_portable_dynlibs() {
  319. # Read BUILD_INFO early as the next commands may mess up the shell
  320. BUILD_INFO="$(cat "${REL_DIR}/BUILD_INFO")"
  321. COMPATIBILITY_INFO="$(compatiblity_info 2>/dev/null || true)"
  322. if ! (echo -e "$COMPATIBILITY_INFO" | $GREP -q 'CRYPTO_OK'); then
  323. ## failed to start, might be due to missing libs, try to be portable
  324. export LD_LIBRARY_PATH="${LD_LIBRARY_PATH:-$DYNLIBS_DIR}"
  325. if [ "$LD_LIBRARY_PATH" != "$DYNLIBS_DIR" ]; then
  326. export LD_LIBRARY_PATH="$DYNLIBS_DIR:$LD_LIBRARY_PATH"
  327. fi
  328. ## Turn off debug, because COMPATIBILITY_INFO needs to capture stderr
  329. COMPATIBILITY_INFO="$(compatiblity_info 2>&1 || true)"
  330. if ! (echo -e "$COMPATIBILITY_INFO" | $GREP -q 'BEAM_OK'); then
  331. ## not able to start beam.smp
  332. logerr "$COMPATIBILITY_INFO"
  333. logerr "Please ensure it is running on the correct platform:"
  334. logerr "$BUILD_INFO"
  335. logerr "Version=$REL_VSN"
  336. logerr "Required dependencies: openssl-1.1.1 (libcrypto), libncurses and libatomic1"
  337. exit 1
  338. elif ! (echo -e "$COMPATIBILITY_INFO" | $GREP -q 'CRYPTO_OK'); then
  339. ## not able to start crypto app
  340. logerr "$COMPATIBILITY_INFO"
  341. exit 2
  342. fi
  343. logwarn "Using libs from '${DYNLIBS_DIR}' due to missing from the OS."
  344. fi
  345. }
  346. SED_REPLACE="sed -i "
  347. case $(sed --help 2>&1) in
  348. *GNU*) SED_REPLACE="sed -i ";;
  349. *BusyBox*) SED_REPLACE="sed -i ";;
  350. *) SED_REPLACE="sed -i '' ";;
  351. esac
  352. # Get node pid
  353. relx_get_pid() {
  354. if output="$(relx_nodetool rpcterms os getpid)"
  355. then
  356. # shellcheck disable=SC2001 # Escaped quote taken as closing quote in editor
  357. echo "$output" | sed -e 's/"//g'
  358. return 0
  359. else
  360. echo "$output"
  361. return 1
  362. fi
  363. }
  364. # Connect to a remote node
  365. remsh() {
  366. # Generate a unique id used to allow multiple remsh to the same node
  367. # transparently
  368. id="remsh$(gen_node_id)-${NAME}"
  369. # shellcheck disable=SC2086
  370. # Setup remote shell command to control node
  371. if [ "$IS_ELIXIR" = no ] || [ "${EMQX_CONSOLE_FLAVOR:-}" = 'erl' ] ; then
  372. set -- "$BINDIR/erl" "$NAME_TYPE" "$id" \
  373. -remsh "$NAME" -boot "$REL_DIR/start_clean" \
  374. -boot_var ERTS_LIB_DIR "$ERTS_LIB_DIR" \
  375. -boot_var RELEASE_LIB "$ERTS_LIB_DIR" \
  376. -setcookie "$COOKIE" \
  377. -hidden \
  378. -kernel net_ticktime "$TICKTIME" \
  379. $EPMD_ARGS
  380. else
  381. set -- "$REL_DIR/iex" \
  382. --remsh "$NAME" \
  383. --boot-var RELEASE_LIB "$ERTS_LIB_DIR" \
  384. --cookie "$COOKIE" \
  385. --hidden \
  386. --erl "-kernel net_ticktime $TICKTIME" \
  387. --erl "$EPMD_ARGS" \
  388. --erl "$NAME_TYPE $id" \
  389. --boot "$REL_DIR/start_clean"
  390. fi
  391. exec "$@"
  392. }
  393. # Generate a random id
  394. gen_node_id() {
  395. od -t u -N 4 /dev/urandom | head -n1 | awk '{print $2 % 1000}'
  396. }
  397. call_nodetool() {
  398. "$ERTS_DIR/bin/escript" "$RUNNER_ROOT_DIR/bin/nodetool" "$@"
  399. }
  400. # Control a node
  401. relx_nodetool() {
  402. command="$1"; shift
  403. ERL_FLAGS="${ERL_FLAGS:-} $EPMD_ARGS -setcookie $COOKIE" \
  404. call_nodetool "$NAME_TYPE" "$NAME" "$command" "$@"
  405. }
  406. call_hocon() {
  407. call_nodetool hocon "$@" \
  408. || die "call_hocon_failed: $*" $?
  409. }
  410. find_emqx_process() {
  411. ## Find the running node from 'ps -ef'
  412. ## * The grep args like '[e]mqx' but not 'emqx' is to avoid greping the grep command itself
  413. ## * The running 'remsh' and 'nodetool' processes must be excluded
  414. if [ -n "${EMQX_NODE__NAME:-}" ]; then
  415. # if node name is provided, filter by node name
  416. # shellcheck disable=SC2009
  417. ps -ef | $GREP '[e]mqx' | $GREP -v -E '(remsh|nodetool)' | $GREP -E "\s\-s?name\s${EMQX_NODE__NAME}" | $GREP -oE "\-[r]oot ${RUNNER_ROOT_DIR}.*" || true
  418. else
  419. # shellcheck disable=SC2009
  420. ps -ef | $GREP '[e]mqx' | $GREP -v -E '(remsh|nodetool)' | $GREP -oE "\-[r]oot ${RUNNER_ROOT_DIR}.*" || true
  421. fi
  422. }
  423. ## Resolve boot configs in a batch
  424. ## This is because starting the Erlang beam with all modules loaded
  425. ## and parsing HOCON config + environment variables is a non-trivial task
  426. CONF_KEYS=( 'node.data_dir' 'node.name' 'node.cookie' 'node.db_backend' 'cluster.proto_dist' 'node.dist_net_ticktime' )
  427. if [ "$IS_ENTERPRISE" = 'yes' ]; then
  428. CONF_KEYS+=( 'license.key' )
  429. fi
  430. ## To be backward compatible, read and then unset EMQX_NODE_NAME
  431. if [ -n "${EMQX_NODE_NAME:-}" ]; then
  432. export EMQX_NODE__NAME="${EMQX_NODE_NAME}"
  433. unset EMQX_NODE_NAME
  434. fi
  435. # Turn off debug as the ps output can be quite noisy
  436. set +x
  437. PS_LINE="$(find_emqx_process)"
  438. logdebug "PS_LINE=$PS_LINE"
  439. RUNNING_NODES_COUNT="$(echo -e "$PS_LINE" | sed '/^\s*$/d' | wc -l)"
  440. [ "$RUNNING_NODES_COUNT" -gt 1 ] && logdebug "More than one running node found: count=$RUNNING_NODES_COUNT"
  441. if [ "$IS_BOOT_COMMAND" = 'yes' ]; then
  442. if [ "$RUNNING_NODES_COUNT" -gt 0 ] && [ "$COMMAND" != 'check_config' ]; then
  443. running_node_name=$(echo -e "$PS_LINE" | $GREP -oE "\s\-s?name.*" | awk '{print $2}' || true)
  444. if [ -n "$running_node_name" ] && [ "$running_node_name" = "${EMQX_NODE__NAME:-}" ]; then
  445. echo "Node ${running_node_name} is already running!"
  446. exit 1
  447. fi
  448. fi
  449. [ -f "$EMQX_ETC_DIR"/emqx.conf ] || die "emqx.conf is not found in $EMQX_ETC_DIR" 1
  450. maybe_use_portable_dynlibs
  451. if [ "${EMQX_BOOT_CONFIGS:-}" = '' ]; then
  452. EMQX_BOOT_CONFIGS="$(call_hocon -s "$SCHEMA_MOD" -c "$EMQX_ETC_DIR"/emqx.conf multi_get "${CONF_KEYS[@]}")"
  453. ## export here so the 'console' command recursively called from
  454. ## 'start' command does not have to parse the configs again
  455. export EMQX_BOOT_CONFIGS
  456. fi
  457. else
  458. # For non-boot commands, we need below runtime facts to connect to the running node:
  459. # 1. The running node name;
  460. # 2. The Erlang cookie in use by the running node name;
  461. # 3. SSL options if the node is using TLS for Erlang distribution;
  462. # 4. Erlang kernel application's net_ticktime config.
  463. #
  464. # There are 3 sources of truth to get those runtime information.
  465. # Listed in the order of preference:
  466. # 1. The boot command (which can be inspected from 'ps -ef' command output)
  467. # 2. The generated vm.<time>.config file located in the dir pointed by 'node.data_dir'
  468. # 3. The bootstrap config 'etc/emqx.conf'
  469. #
  470. # If failed to read from source 1, the information is retrieved from source 3
  471. # i.e. source 2 is never used.
  472. #
  473. # NOTES:
  474. # * We should avoid getting runtime information with the 3rd approach because 'etc/emqx.conf' might
  475. # be updated after the node is started. e.g. If a user starts the node with name 'emqx@127.0.0.1'
  476. # then update the config in the file to 'node.name = "emqx@local.net"', after this change,
  477. # there would be no way stop the running node 'emqx@127.0.0.1', because 'emqx stop' command
  478. # would try to stop the new node instead.
  479. if [ "$RUNNING_NODES_COUNT" -eq 1 ]; then
  480. ## only one emqx node is running, get running args from 'ps -ef' output
  481. tmp_nodename=$(echo -e "$PS_LINE" | $GREP -oE "\s\-s?name.*" | awk '{print $2}' || true)
  482. tmp_cookie=$(echo -e "$PS_LINE" | $GREP -oE "\s\-setcookie.*" | awk '{print $2}' || true)
  483. SSL_DIST_OPTFILE="$(echo -e "$PS_LINE" | $GREP -oE '\-ssl_dist_optfile\s.+\s' | awk '{print $2}' || true)"
  484. tmp_ticktime="$(echo -e "$PS_LINE" | $GREP -oE '\s\-kernel\snet_ticktime\s.+\s' | awk '{print $3}' || true)"
  485. # data_dir is actually not needed, but kept anyway
  486. tmp_datadir="$(echo -e "$PS_LINE" | $GREP -oE "\-emqx_data_dir.*" | sed -E 's#.+emqx_data_dir[[:blank:]]##g' | sed -E 's#[[:blank:]]--$##g' || true)"
  487. if [ -z "$SSL_DIST_OPTFILE" ]; then
  488. tmp_proto='inet_tcp'
  489. else
  490. tmp_proto='inet_tls'
  491. fi
  492. ## Make the format like what call_hocon multi_get prints out, but only need 4 args
  493. EMQX_BOOT_CONFIGS="node.name=${tmp_nodename}\nnode.cookie=${tmp_cookie}\ncluster.proto_dist=${tmp_proto}\nnode.dist_net_ticktime=$tmp_ticktime\nnode.data_dir=${tmp_datadir}"
  494. else
  495. if [ "$RUNNING_NODES_COUNT" -gt 1 ]; then
  496. if [ -z "${EMQX_NODE__NAME:-}" ]; then
  497. tmp_nodenames=$(echo -e "$PS_LINE" | $GREP -oE "\s\-s?name.*" | awk '{print $2}' | tr '\n' ' ')
  498. logerr "More than one EMQX node found running (root dir: ${RUNNER_ROOT_DIR})"
  499. logerr "Running nodes: $tmp_nodenames"
  500. logerr "Make sure environment variable EMQX_NODE__NAME is set to indicate for which node this command is intended."
  501. exit 1
  502. fi
  503. else
  504. if [ -n "${EMQX_NODE__NAME:-}" ]; then
  505. die "Node $EMQX_NODE__NAME is not running?"
  506. fi
  507. fi
  508. ## We have no choice but to read the bootstrap config (with environment overrides available in the current shell)
  509. [ -f "$EMQX_ETC_DIR"/emqx.conf ] || die "emqx.conf is not found in $EMQX_ETC_DIR" 1
  510. maybe_use_portable_dynlibs
  511. EMQX_BOOT_CONFIGS="$(call_hocon -s "$SCHEMA_MOD" -c "$EMQX_ETC_DIR"/emqx.conf multi_get "${CONF_KEYS[@]}")"
  512. fi
  513. fi
  514. logdebug "EMQX_BOOT_CONFIGS: $EMQX_BOOT_CONFIGS"
  515. [ "$DEBUG" -eq 1 ] && set -x
  516. get_boot_config() {
  517. path_to_value="$1"
  518. echo -e "$EMQX_BOOT_CONFIGS" | $GREP "$path_to_value=" | sed -e "s/$path_to_value=//g" | tr -d \"
  519. }
  520. EPMD_ARGS="-start_epmd false -epmd_module ekka_epmd -proto_dist ekka"
  521. PROTO_DIST="$(get_boot_config 'cluster.proto_dist' || true)"
  522. TICKTIME="$(get_boot_config 'node.dist_net_ticktime' || echo '120')"
  523. # this environment variable is required by ekka_dist module
  524. # because proto_dist is overriden to ekka, and there is a lack of ekka_tls module
  525. export EKKA_PROTO_DIST_MOD="${PROTO_DIST:-inet_tcp}"
  526. if [ "$EKKA_PROTO_DIST_MOD" = 'inet_tls' ]; then
  527. if [ "$IS_BOOT_COMMAND" = 'yes' ]; then
  528. SSL_DIST_OPTFILE=${EMQX_SSL_DIST_OPTFILE:-"$EMQX_ETC_DIR/ssl_dist.conf"}
  529. case "$SSL_DIST_OPTFILE" in
  530. *\ *)
  531. # there is unfortunately no way to support space for this option because we'd need to grep
  532. # from 'ps -ef' result to get this option for non-boot commands (nodetool) to run
  533. set +x
  534. logerr "Got space in: $SSL_DIST_OPTFILE"
  535. logerr "No space is allowed for Erlang distribution over SSL option file path."
  536. logerr "Configure it from environment variable EMQX_SSL_DIST_OPTFILE."
  537. logerr "Or make sure emqx root path '$RUNNER_ROOT_DIR' has no space"
  538. exit 1
  539. ;;
  540. *)
  541. true
  542. ;;
  543. esac
  544. fi
  545. EPMD_ARGS="${EPMD_ARGS} -ssl_dist_optfile $SSL_DIST_OPTFILE"
  546. fi
  547. DATA_DIR="$(get_boot_config 'node.data_dir')"
  548. # ensure no trailing /
  549. DATA_DIR="${DATA_DIR%/}"
  550. if [[ $DATA_DIR != /* ]]; then
  551. # relative path
  552. DATA_DIR="${RUNNER_ROOT_DIR}/${DATA_DIR}"
  553. fi
  554. CONFIGS_DIR="$DATA_DIR/configs"
  555. mkdir -p "$CONFIGS_DIR"
  556. check_license() {
  557. if [ "$IS_ENTERPRISE" == "no" ]; then
  558. return 0
  559. fi
  560. key_license="${EMQX_LICENSE__KEY:-$(get_boot_config 'license.key')}"
  561. if [[ -n "$key_license" && ("$key_license" != "undefined") ]]; then
  562. call_nodetool check_license_key "$key_license"
  563. else
  564. set +x
  565. logerr "License not found."
  566. logerr "Please specify one via the EMQX_LICENSE__KEY variable"
  567. logerr "or via license.key in emqx-enterprise.conf."
  568. return 1
  569. fi
  570. }
  571. # When deciding which install upgrade script to run, we have to check
  572. # our own version so we may avoid infinite loops and call the correct
  573. # version.
  574. current_script_version() {
  575. curr_script=$(basename "${BASH_SOURCE[0]}")
  576. suffix=${curr_script#*-}
  577. if [[ "${suffix}" == "${curr_script}" ]]; then
  578. # there's no suffix, so we're running the default `emqx` script;
  579. # we'll have to trust the REL_VSN variable
  580. echo "$REL_VSN"
  581. else
  582. echo "${suffix}"
  583. fi
  584. }
  585. parse_semver() {
  586. echo "$1" | tr '.|-' ' '
  587. }
  588. max_version_of() {
  589. local vsn1="$1"
  590. local vsn2="$2"
  591. echo "${vsn1}" "${vsn2}" | tr " " "\n" | sort -rV | head -n1
  592. }
  593. versioned_script_path() {
  594. local script_name="$1"
  595. local vsn="$2"
  596. echo "$RUNNER_ROOT_DIR/bin/$script_name-$vsn"
  597. }
  598. does_script_version_exist() {
  599. local script_name="$1"
  600. local vsn="$2"
  601. if [[ -f "$(versioned_script_path "$script_name" "$vsn")" ]]; then
  602. return 0
  603. else
  604. return 1
  605. fi
  606. }
  607. # extract_from_package packege_path destination file1 file2
  608. extract_from_package() {
  609. local package="$1"
  610. local dest_dir="$2"
  611. shift 2
  612. tar -C "$dest_dir" -xf "$package" "$@"
  613. }
  614. am_i_the_newest_script() {
  615. local curr_vsn other_vsn
  616. curr_vsn="$(current_script_version)"
  617. other_vsn="$1"
  618. max_vsn="$(max_version_of "$other_vsn" "$curr_vsn")"
  619. if [[ "$max_vsn" == "$curr_vsn" ]]; then
  620. return 0
  621. else
  622. return 1
  623. fi
  624. }
  625. locate_package() {
  626. local package_path candidates vsn
  627. vsn="$1"
  628. if [[ "${IS_ENTERPRISE}" == "yes" ]]; then
  629. package_pattern="$RUNNER_ROOT_DIR/releases/emqx-enterprise-$vsn-*.tar.gz"
  630. else
  631. package_pattern="$RUNNER_ROOT_DIR/releases/emqx-$vsn-*.tar.gz"
  632. fi
  633. # shellcheck disable=SC2207,SC2086
  634. candidates=($(ls $package_pattern))
  635. if [[ "${#candidates[@]}" == 0 ]]; then
  636. logerr "No package matching $package_pattern found."
  637. exit 1
  638. elif [[ "${#candidates[@]}" -gt 1 ]]; then
  639. logerr "Multiple packages matching $package_pattern found. Ensure only one exists."
  640. exit 1
  641. else
  642. echo "${candidates[0]}"
  643. fi
  644. }
  645. ensure_newest_script_is_extracted() {
  646. local newest_vsn="$1"
  647. local package_path tmpdir
  648. if does_script_version_exist "emqx" "$newest_vsn" \
  649. && does_script_version_exist "install_upgrade.escript" "$newest_vsn"; then
  650. return
  651. else
  652. package_path="$(locate_package "$newest_vsn")"
  653. tmpdir="$(mktemp -dp /tmp emqx.XXXXXXXXXXX)"
  654. extract_from_package \
  655. "$package_path" \
  656. "$tmpdir" \
  657. "bin/emqx-$newest_vsn" \
  658. "bin/install_upgrade.escript-$newest_vsn"
  659. cp "$tmpdir/bin/emqx-$newest_vsn" \
  660. "$tmpdir/bin/install_upgrade.escript-$newest_vsn" \
  661. "$RUNNER_ROOT_DIR/bin/"
  662. rm -rf "$tmpdir"
  663. fi
  664. }
  665. # Run an escript in the node's environment
  666. relx_escript() {
  667. shift; scriptpath="$1"; shift
  668. "$ERTS_DIR/bin/escript" "$RUNNER_ROOT_DIR/$scriptpath" "$@"
  669. }
  670. # Output a start command for the last argument of run_erl
  671. relx_start_command() {
  672. printf "exec \"%s\" \"%s\"" "$RUNNER_SCRIPT" \
  673. "$START_OPTION"
  674. }
  675. # Function to check configs without generating them
  676. check_config() {
  677. ## this command checks the configs without generating any files
  678. call_hocon -v -s "$SCHEMA_MOD" -c "$EMQX_ETC_DIR"/emqx.conf check_schema
  679. }
  680. # Function to generate app.config and vm.args
  681. # sets two environment variables CONF_FILE and ARGS_FILE
  682. generate_config() {
  683. local name_type="$1"
  684. local node_name="$2"
  685. ## Delete the *.siz files first or it can't start after
  686. ## changing the config 'log.rotation.size'
  687. rm -f "${EMQX_LOG_DIR}"/*.siz
  688. ## timestamp for each generation
  689. local NOW_TIME
  690. NOW_TIME="$(date +'%Y.%m.%d.%H.%M.%S')"
  691. ## this command populates two files: app.<time>.config and vm.<time>.args
  692. ## NOTE: the generate command merges environment variables to the base config (emqx.conf),
  693. ## but does not include the cluster-override.conf and local-override.conf
  694. ## meaning, certain overrides will not be mapped to app.<time>.config file
  695. call_hocon -v -t "$NOW_TIME" -s "$SCHEMA_MOD" -c "$EMQX_ETC_DIR"/emqx.conf -d "$DATA_DIR"/configs generate
  696. ## filenames are per-hocon convention
  697. CONF_FILE="$CONFIGS_DIR/app.$NOW_TIME.config"
  698. ARGS_FILE="$CONFIGS_DIR/vm.$NOW_TIME.args"
  699. ## Merge hocon generated *.args into the vm.args
  700. TMP_ARG_FILE="$CONFIGS_DIR/vm.args.tmp"
  701. cp "$EMQX_ETC_DIR/vm.args" "$TMP_ARG_FILE"
  702. echo "" >> "$TMP_ARG_FILE"
  703. echo "-pa \"${REL_DIR}/consolidated\"" >> "$TMP_ARG_FILE"
  704. ## read lines from generated vm.<time>.args file
  705. ## drop comment lines, and empty lines using sed
  706. ## pipe the lines to a while loop
  707. sed '/^#/d' "$ARGS_FILE" | sed '/^$/d' | while IFS='' read -r ARG_LINE || [ -n "$ARG_LINE" ]; do
  708. ## in the loop, split the 'key[:space:]value' pair
  709. ARG_KEY=$(echo "$ARG_LINE" | awk '{$NF="";print}')
  710. ARG_VALUE=$(echo "$ARG_LINE" | awk '{print $NF}')
  711. ## use the key to look up in vm.args file for the value
  712. TMP_ARG_VALUE=$($GREP "^$ARG_KEY" "$TMP_ARG_FILE" || true | awk '{print $NF}')
  713. ## compare generated (to override) value to original (to be overridden) value
  714. if [ "$ARG_VALUE" != "$TMP_ARG_VALUE" ] ; then
  715. ## if they are different
  716. if [ -n "$TMP_ARG_VALUE" ]; then
  717. ## if the old value is present, replace it with generated value
  718. sh -c "$SED_REPLACE 's|^$ARG_KEY.*$|$ARG_LINE|' \"$TMP_ARG_FILE\""
  719. else
  720. ## otherwise append generated value to the end
  721. echo "$ARG_LINE" >> "$TMP_ARG_FILE"
  722. fi
  723. fi
  724. done
  725. echo "$name_type $node_name" >> "$TMP_ARG_FILE"
  726. echo "-mnesia dir '\"$DATA_DIR/mnesia/$NAME\"'" >> "$TMP_ARG_FILE"
  727. ## rename the generated vm.<time>.args file
  728. mv -f "$TMP_ARG_FILE" "$ARGS_FILE"
  729. }
  730. # check if a PID is down
  731. is_down() {
  732. PID="$1"
  733. if ps -p "$PID" >/dev/null; then
  734. # still around
  735. # shellcheck disable=SC2009 # this grep pattern is not a part of the progra names
  736. if ps -p "$PID" | $GREP -q 'defunct'; then
  737. # zombie state, print parent pid
  738. parent="$(ps -o ppid= -p "$PID" | tr -d ' ')"
  739. logwarn "$PID is marked <defunct>, parent: $(ps -p "$parent")"
  740. return 0
  741. fi
  742. return 1
  743. fi
  744. # it's gone
  745. return 0
  746. }
  747. wait_for() {
  748. local WAIT_TIME
  749. local CMD
  750. WAIT_TIME="$1"
  751. shift
  752. CMD="$*"
  753. while true; do
  754. if $CMD >/dev/null 2>&1; then
  755. return 0
  756. fi
  757. if [ "$WAIT_TIME" -le 0 ]; then
  758. return 1
  759. fi
  760. WAIT_TIME=$((WAIT_TIME - 1))
  761. sleep 1
  762. done
  763. }
  764. wait_until_return_val() {
  765. local RESULT
  766. local WAIT_TIME
  767. local CMD
  768. RESULT="$1"
  769. WAIT_TIME="$2"
  770. shift 2
  771. CMD="$*"
  772. while true; do
  773. if [ "$($CMD 2>/dev/null)" = "$RESULT" ]; then
  774. return 0
  775. fi
  776. if [ "$WAIT_TIME" -le 0 ]; then
  777. return 1
  778. fi
  779. WAIT_TIME=$((WAIT_TIME - 1))
  780. sleep 1
  781. done
  782. }
  783. # First, there is EMQX_DEFAULT_LOG_HANDLER which can control the default values
  784. # to be used when generating configs.
  785. # It's set in docker entrypoint and in systemd service file.
  786. #
  787. # To be backward compatible with 4.x and v5.0.0 ~ v5.0.24/e5.0.2:
  788. # if EMQX_LOG__TO is set, we try to enable handlers from environment variables.
  789. # i.e. it overrides the default value set in EMQX_DEFAULT_LOG_HANDLER
  790. tr_log_to_env() {
  791. local log_to=${EMQX_LOG__TO:-undefined}
  792. # unset because it's unknown to 5.0
  793. unset EMQX_LOG__TO
  794. case "${log_to}" in
  795. console)
  796. export EMQX_LOG__CONSOLE_HANDLER__ENABLE='true'
  797. export EMQX_LOG__FILE_HANDLERS__DEFAULT__ENABLE='false'
  798. ;;
  799. file)
  800. export EMQX_LOG__CONSOLE_HANDLER__ENABLE='false'
  801. export EMQX_LOG__FILE_HANDLERS__DEFAULT__ENABLE='true'
  802. ;;
  803. both)
  804. export EMQX_LOG__CONSOLE_HANDLER__ENABLE='true'
  805. export EMQX_LOG__FILE_HANDLERS__DEFAULT__ENABLE='true'
  806. ;;
  807. default)
  808. # want to use config file defaults, do nothing
  809. ;;
  810. undefined)
  811. # value not set, do nothing
  812. ;;
  813. *)
  814. logerr "Unknown environment value for EMQX_LOG__TO=${log_to} discarded"
  815. ;;
  816. esac
  817. }
  818. maybe_log_to_console() {
  819. if [ "${EMQX_LOG__TO:-}" = 'default' ]; then
  820. # want to use defaults, do nothing
  821. unset EMQX_LOG__TO
  822. else
  823. tr_log_to_env
  824. export EMQX_DEFAULT_LOG_HANDLER=${EMQX_DEFAULT_LOG_HANDLER:-console}
  825. fi
  826. }
  827. # Warn the user if ulimit -n is less than 1024
  828. maybe_warn_ulimit() {
  829. ULIMIT_F=$(ulimit -n)
  830. if [ "$ULIMIT_F" -lt 1024 ]; then
  831. logwarn "ulimit -n is ${ULIMIT_F}; 1024 is the recommended minimum."
  832. fi
  833. }
  834. ## Possible ways to configure emqx node name:
  835. ## 1. configure node.name in emqx.conf
  836. ## 2. override with environment variable EMQX_NODE__NAME
  837. ## Node name is either short-name (without '@'), e.g. 'emqx'
  838. ## or long name (with '@') e.g. 'emqx@example.net' or 'emqx@127.0.0.1'
  839. NAME="${EMQX_NODE__NAME:-}"
  840. if [ -z "$NAME" ]; then
  841. NAME="$(get_boot_config 'node.name')"
  842. fi
  843. # force to use 'emqx' short name
  844. [ -z "$NAME" ] && NAME='emqx'
  845. case "$NAME" in
  846. *@*)
  847. NAME_TYPE='-name'
  848. ;;
  849. *)
  850. NAME_TYPE='-sname'
  851. esac
  852. SHORT_NAME="$(echo "$NAME" | awk -F'@' '{print $1}')"
  853. HOST_NAME="$(echo "$NAME" | awk -F'@' '{print $2}')"
  854. if ! (echo "$SHORT_NAME" | grep -q '^[0-9A-Za-z_\-]\+$'); then
  855. logerr "Invalid node name, should be of format '^[0-9A-Za-z_-]+$'."
  856. exit 1
  857. fi
  858. # This also changes the program name from 'beam.smp' to node name
  859. # e.g. the 'ps' command output
  860. export ESCRIPT_NAME="$SHORT_NAME"
  861. PIPE_DIR="${PIPE_DIR:-/$DATA_DIR/${WHOAMI}_erl_pipes/$NAME/}"
  862. ## Resolve Erlang cookie.
  863. if [ -n "${EMQX_NODE_COOKIE:-}" ]; then
  864. ## To be backward compatible, read and unset EMQX_NODE_COOKIE
  865. export EMQX_NODE__COOKIE="${EMQX_NODE_COOKIE}"
  866. unset EMQX_NODE_COOKIE
  867. fi
  868. COOKIE="${EMQX_NODE__COOKIE:-}"
  869. COOKIE_IN_USE="$(get_boot_config 'node.cookie')"
  870. if [ "$IS_BOOT_COMMAND" != 'yes' ] && [ -n "$COOKIE_IN_USE" ] && [ -n "$COOKIE" ] && [ "$COOKIE" != "$COOKIE_IN_USE" ]; then
  871. die "EMQX_NODE__COOKIE is different from the cookie used by $NAME"
  872. fi
  873. [ -z "$COOKIE" ] && COOKIE="$COOKIE_IN_USE"
  874. [ -z "$COOKIE" ] && COOKIE="$EMQX_DEFAULT_ERLANG_COOKIE"
  875. maybe_warn_default_cookie() {
  876. if [ $IS_BOOT_COMMAND = 'yes' ] && [ "$COOKIE" = "$EMQX_DEFAULT_ERLANG_COOKIE" ]; then
  877. logwarn "Default (insecure) Erlang cookie is in use."
  878. logwarn "Configure node.cookie in $EMQX_ETC_DIR/emqx.conf or override from environment variable EMQX_NODE__COOKIE"
  879. logwarn "NOTE: Use the same cookie for all nodes in the cluster."
  880. fi
  881. }
  882. ## check if OTP version has mnesia_hook feature; if not, fallback to
  883. ## using Mnesia DB backend.
  884. if [[ "$IS_BOOT_COMMAND" == 'yes' && "$(get_boot_config 'node.db_backend')" == "rlog" ]]; then
  885. if ! (echo -e "$COMPATIBILITY_INFO" | grep -q 'MNESIA_OK'); then
  886. logerr "DB Backend is RLOG, but an incompatible OTP version has been detected. Falling back to using Mnesia DB backend."
  887. export EMQX_NODE__DB_BACKEND=mnesia
  888. export EMQX_NODE__DB_ROLE=core
  889. fi
  890. fi
  891. diagnose_boot_failure_and_die() {
  892. local ps_line
  893. ps_line="$(find_emqx_process)"
  894. if [ -z "$ps_line" ]; then
  895. echo "Find more information in the latest log file: ${EMQX_LOG_DIR}/erlang.log.*"
  896. exit 1
  897. fi
  898. if ! relx_nodetool "ping" > /dev/null; then
  899. logerr "$NAME seems to be running, but not responding to pings."
  900. echo "Make sure '$HOST_NAME' is a resolvable and reachable hostname."
  901. pipe_shutdown
  902. exit 2
  903. fi
  904. if ! relx_nodetool 'eval' 'true = emqx:is_running()' > /dev/null; then
  905. logerr "$NAME node is started, but failed to complete the boot sequence in time."
  906. echo "Please collect the logs in ${EMQX_LOG_DIR} and report a bug to EMQX team at https://github.com/emqx/emqx/issues/new/choose"
  907. pipe_shutdown
  908. exit 3
  909. fi
  910. }
  911. ## Only works when started in daemon mode
  912. pipe_shutdown() {
  913. if [ -d "$PIPE_DIR" ]; then
  914. echo "Shutting down $NAME from to_erl pipe."
  915. ## can not evaluate init:stop() or erlang:halt() because the shell is restricted
  916. echo 'emqx_machine:brutal_shutdown().' | "$BINDIR/to_erl" "$PIPE_DIR"
  917. fi
  918. }
  919. ## Call nodetool to stop EMQX
  920. nodetool_shutdown() {
  921. # Wait for the node to completely stop...
  922. PID="$(relx_get_pid)"
  923. if ! relx_nodetool "stop"; then
  924. die "Graceful shutdown failed PID=[$PID]"
  925. fi
  926. WAIT_TIME="${EMQX_WAIT_FOR_STOP:-120}"
  927. if ! wait_for "$WAIT_TIME" 'is_down' "$PID"; then
  928. msg="dangling after ${WAIT_TIME} seconds"
  929. # also log to syslog
  930. logger -t "${REL_NAME}[${PID}]" "STOP: $msg"
  931. # log to user console
  932. set +x
  933. logerr "Stop failed, $msg"
  934. echo "ERROR: $PID is still around"
  935. ps -p "$PID"
  936. exit 1
  937. fi
  938. echo "ok"
  939. logger -t "${REL_NAME}[${PID}]" "STOP: OK"
  940. }
  941. cd "$RUNNER_ROOT_DIR"
  942. case "${COMMAND}" in
  943. start)
  944. maybe_warn_ulimit
  945. maybe_warn_default_cookie
  946. # this flag passes down to console mode
  947. # so we know it's intended to be run in daemon mode
  948. export _EMQX_START_DAEMON_MODE=1
  949. case "$COMMAND" in
  950. start)
  951. shift
  952. START_OPTION="console"
  953. HEART_OPTION="start"
  954. ;;
  955. esac
  956. RUN_PARAM="$*"
  957. # Set arguments for the heart command
  958. set -- "$RUNNER_SCRIPT" "$HEART_OPTION"
  959. [ "$RUN_PARAM" ] && set -- "$@" "$RUN_PARAM"
  960. # Export the HEART_COMMAND
  961. HEART_COMMAND="$RUNNER_SCRIPT $COMMAND"
  962. export HEART_COMMAND
  963. ## See: http://erlang.org/doc/man/run_erl.html
  964. # Export the RUN_ERL_LOG_GENERATIONS
  965. export RUN_ERL_LOG_GENERATIONS=${RUN_ERL_LOG_GENERATIONS:-"5"}
  966. # Export the RUN_ERL_LOG_MAXSIZE
  967. export RUN_ERL_LOG_MAXSIZE=${RUN_ERL_LOG_MAXSIZE:-"10485760"}
  968. mkdir -p "$PIPE_DIR"
  969. "$BINDIR/run_erl" -daemon "$PIPE_DIR" "$EMQX_LOG_DIR" \
  970. "$(relx_start_command)"
  971. WAIT_TIME=${EMQX_WAIT_FOR_START:-120}
  972. if wait_until_return_val "true" "$WAIT_TIME" 'relx_nodetool' \
  973. 'eval' 'emqx:is_running()'; then
  974. echo "$EMQX_DESCRIPTION $REL_VSN is started successfully!"
  975. exit 0
  976. else
  977. logerr "${EMQX_DESCRIPTION} ${REL_VSN} using node name '${NAME}' failed ${WAIT_TIME} probes."
  978. diagnose_boot_failure_and_die
  979. fi
  980. ;;
  981. stop)
  982. if ! nodetool_shutdown; then
  983. pipe_shutdown
  984. fi
  985. ;;
  986. pid)
  987. ## Get the VM's pid
  988. if ! relx_get_pid; then
  989. exit 1
  990. fi
  991. ;;
  992. ping)
  993. assert_node_alive
  994. echo pong
  995. ;;
  996. escript)
  997. ## Run an escript under the node's environment
  998. if ! relx_escript "$@"; then
  999. exit 1
  1000. fi
  1001. ;;
  1002. attach)
  1003. exec "$BINDIR/to_erl" "$PIPE_DIR"
  1004. ;;
  1005. remote_console)
  1006. assert_node_alive
  1007. shift
  1008. remsh
  1009. ;;
  1010. upgrade|downgrade|install|unpack|uninstall)
  1011. if [ -z "${2:-}" ]; then
  1012. echo "Missing version argument"
  1013. echo "Usage: $REL_NAME $COMMAND {version}"
  1014. exit 1
  1015. fi
  1016. shift
  1017. assert_node_alive
  1018. curr_vsn="$(current_script_version)"
  1019. target_vsn="$1"
  1020. newest_vsn="$(max_version_of "$target_vsn" "$curr_vsn")"
  1021. ensure_newest_script_is_extracted "$newest_vsn"
  1022. # if we are not the newest script, run the same command from it
  1023. if ! am_i_the_newest_script "$newest_vsn"; then
  1024. script_path="$(versioned_script_path emqx "$newest_vsn")"
  1025. exec "$script_path" "$COMMAND" "$@"
  1026. fi
  1027. upgrade_script_path="$(versioned_script_path install_upgrade.escript "$newest_vsn")"
  1028. echo "using ${upgrade_script_path} to run ${COMMAND} $*"
  1029. ERL_FLAGS="${ERL_FLAGS:-} $EPMD_ARGS" \
  1030. exec "$BINDIR/escript" "$upgrade_script_path" \
  1031. "$COMMAND" "{'$REL_NAME', \"$NAME_TYPE\", '$NAME', '$COOKIE'}" "$@"
  1032. ;;
  1033. versions)
  1034. assert_node_alive
  1035. shift
  1036. ERL_FLAGS="${ERL_FLAGS:-} $EPMD_ARGS" \
  1037. exec "$BINDIR/escript" "$RUNNER_ROOT_DIR/bin/install_upgrade.escript" \
  1038. "versions" "{'$REL_NAME', \"$NAME_TYPE\", '$NAME', '$COOKIE'}" "$@"
  1039. ;;
  1040. console|console_clean|foreground)
  1041. # .boot file typically just $REL_NAME (ie, the app name)
  1042. # however, for debugging, sometimes start_clean.boot is useful.
  1043. # For e.g. 'setup', one may even want to name another boot script.
  1044. case "$COMMAND" in
  1045. console|foreground)
  1046. if [ -f "$REL_DIR/$REL_NAME.boot" ]; then
  1047. BOOTFILE="$REL_DIR/$REL_NAME"
  1048. else
  1049. BOOTFILE="$REL_DIR/start"
  1050. fi
  1051. ;;
  1052. console_clean)
  1053. BOOTFILE="$REL_DIR/start_clean"
  1054. ;;
  1055. esac
  1056. case "$COMMAND" in
  1057. foreground)
  1058. FOREGROUNDOPTIONS="-noshell -noinput +Bd"
  1059. ;;
  1060. *)
  1061. FOREGROUNDOPTIONS=''
  1062. ;;
  1063. esac
  1064. # set before generate_config
  1065. if [ "${_EMQX_START_DAEMON_MODE:-}" = 1 ]; then
  1066. tr_log_to_env
  1067. else
  1068. maybe_log_to_console
  1069. maybe_warn_ulimit
  1070. maybe_warn_default_cookie
  1071. fi
  1072. #generate app.config and vm.args
  1073. generate_config "$NAME_TYPE" "$NAME"
  1074. check_license
  1075. # Setup beam-required vars
  1076. EMU="beam"
  1077. PROGNAME="${0}"
  1078. export EMU
  1079. export PROGNAME
  1080. # Store passed arguments since they will be erased by `set`
  1081. # add emqx_data_dir to boot command so it is visible from 'ps -ef'
  1082. ARGS="$*"
  1083. # shellcheck disable=SC2086
  1084. # Build an array of arguments to pass to exec later on
  1085. # Build it here because this command will be used for logging.
  1086. if [ "$IS_ELIXIR" = no ] || [ "${EMQX_CONSOLE_FLAVOR:-}" = 'erl' ] ; then
  1087. # pass down RELEASE_LIB so we can switch to IS_ELIXIR=no
  1088. # to boot an Erlang node from the elixir release
  1089. set -- "$BINDIR/erlexec" \
  1090. $FOREGROUNDOPTIONS \
  1091. -boot "$BOOTFILE" \
  1092. -boot_var RELEASE_LIB "$ERTS_LIB_DIR" \
  1093. -boot_var ERTS_LIB_DIR "$ERTS_LIB_DIR" \
  1094. -mode "$CODE_LOADING_MODE" \
  1095. -config "$CONF_FILE" \
  1096. -args_file "$ARGS_FILE" \
  1097. $EPMD_ARGS
  1098. else
  1099. set -- "$REL_DIR/iex" \
  1100. --boot "$BOOTFILE" \
  1101. --boot-var RELEASE_LIB "${ERTS_LIB_DIR}" \
  1102. --erl-config "${CONF_FILE}" \
  1103. --vm-args "${ARGS_FILE}" \
  1104. --erl "$FOREGROUNDOPTIONS" \
  1105. --erl "-mode $CODE_LOADING_MODE" \
  1106. --erl "$EPMD_ARGS" \
  1107. --werl
  1108. fi
  1109. # Log the startup
  1110. logger -t "${REL_NAME}[$$]" "EXEC: $* -- ${1+$ARGS} -emqx_data_dir ${DATA_DIR}"
  1111. # Start the VM
  1112. exec "$@" -- ${1+$ARGS} -emqx_data_dir "${DATA_DIR}"
  1113. ;;
  1114. ctl)
  1115. assert_node_alive
  1116. shift
  1117. relx_nodetool rpc_infinity emqx_ctl run_command "$@"
  1118. ;;
  1119. rpc)
  1120. assert_node_alive
  1121. shift
  1122. relx_nodetool rpc "$@"
  1123. ;;
  1124. rpcterms)
  1125. assert_node_alive
  1126. shift
  1127. relx_nodetool rpcterms "$@"
  1128. ;;
  1129. eval)
  1130. assert_node_alive
  1131. shift
  1132. relx_nodetool "eval" "$@"
  1133. ;;
  1134. eval-ex)
  1135. assert_node_alive
  1136. shift
  1137. if [ "$IS_ELIXIR" = "yes" ]
  1138. then
  1139. "$REL_DIR/elixir" \
  1140. --hidden \
  1141. --name "rand-$(gen_node_id)-$NAME" \
  1142. --cookie "$COOKIE" \
  1143. --boot "$REL_DIR/start_clean" \
  1144. --boot-var RELEASE_LIB "$ERTS_LIB_DIR" \
  1145. --vm-args "$REL_DIR/remote.vm.args" \
  1146. --erl "-start_epmd false -epmd_module ekka_epmd" \
  1147. --rpc-eval "$NAME" "$@"
  1148. else
  1149. echo "EMQX node is not an Elixir node"
  1150. usage "$COMMAND"
  1151. exit 1
  1152. fi
  1153. ;;
  1154. check_config)
  1155. check_config
  1156. ;;
  1157. *)
  1158. usage "$COMMAND"
  1159. exit 1
  1160. ;;
  1161. esac
  1162. exit 0