blob: 0db46cc610c6cc3caa60cf8cb250232bfb1a4af1 (
plain) (
tree)
|
|
:: This batch file handles managing an Erlang node as a Windows service.
::
:: Commands provided:
::
:: * install - install the release as a Windows service
:: * start - start the service and Erlang node
:: * stop - stop the service and Erlang node
:: * restart - run the stop command and start command
:: * uninstall - uninstall the service and kill a running node
:: * ping - check if the node is running
:: * console - start the Erlang release in a `werl` Windows shell
:: * attach - connect to a running node and open an interactive console
:: * remote_console - alias for attach
:: * list - display a listing of installed Erlang services
:: * usage - display available commands
:: Set variables that describe the release
@set rel_name={{ rel_name }}
@set rel_vsn={{ rel_vsn }}
@set erts_vsn={{ erts_vsn }}
@set erl_opts={{ erl_opts }}
:: Discover the release root directory from the directory
:: of this script
@set script_dir=%~dp0
@for %%A in ("%script_dir%\..") do @(
set release_root_dir=%%~fA
)
@set "rel_dir=%release_root_dir%\releases\%rel_vsn%"
@call :find_erts_dir
@call :find_sys_config
@call :set_boot_script_var
@set service_name=%rel_name%_%rel_vsn%
@set bindir=%erts_dir%\bin
@set vm_args=%rel_dir%\vm.args
@set progname=erl.exe
@set clean_boot_script=%release_root_dir%\bin\start_clean
@set "erlsrv=%bindir%\erlsrv.exe"
@set "epmd=%bindir%\epmd.exe"
@set "escript=%bindir%\escript.exe"
@set "werl=%bindir%\werl.exe"
@set "erl=%bindir%\erl.exe"
@set "nodetool=%release_root_dir%\bin\nodetool"
@set "extensions0={{ extensions }}"
@set "extensions1=%extensions0:|= %"
@set "extensions=%extensions1: undefined=%"
:: Extract node type and name from vm.args
@for /f "usebackq tokens=1-2" %%I in ('findstr /b "\-name \-sname" "%vm_args%"') do @(
set node_type=%%I
set node_name=%%J
)
@for /f "delims=@ tokens=1-2" %%I in ("%node_name%") do @(
set node_name=%%I
set hostname=%%J
)
:: if no hostname is set, attempt to pick one from the env
@if "" == "%hostname%" @(
if "-sname" == "%node_type%" (
if not "" == "%COMPUTERNAME%" (
set "hostname=%COMPUTERNAME%"
)
) else (
if not "" == "%COMPUTERNAME%" (
if not "" == "%USERDNSDOMAIN%" (
set "hostname=%COMPUTERNAME%.%USERDNSDOMAIN%"
)
)
)
)
:: Add @ to hostname if not empty so that we can just concatenate values safely
@if not "" == "%hostname%" @(
set "hostname=@%hostname%"
)
:: Extract cookie from vm.args
@for /f "usebackq tokens=1-2" %%I in ('findstr /b \-setcookie "%vm_args%"') do @(
set cookie=%%J
)
:: Write the erl.ini file to set up paths relative to this script
@call :write_ini
:: Collect any additional VM args into erl_opts
@setlocal EnableDelayedExpansion
@for /f "usebackq tokens=1-2" %%I in ('findstr /r "^[^#]" "%vm_args%"') do @(
if not "%%I" == "-name" (
if not "%%I" == "-sname" (
if not "%%I" == "-setcookie" (
set erl_opts=!erl_opts! %%I %%J
)
)
)
)
@endlocal && set erl_opts=%erl_opts%
:: If a start.boot file is not present, copy one from the named .boot file
@if not exist "%rel_dir%\start.boot" (
copy "%rel_dir%\%rel_name%.boot" "%rel_dir%\start.boot" >nul
)
@if "%1"=="help" @goto usage
@if "%1"=="install" @goto install
@if "%1"=="uninstall" @goto uninstall
@if "%1"=="start" @goto start
@if "%1"=="stop" @goto stop
@if "%1"=="restart" @call :stop && @goto start
@if "%1"=="upgrade" @goto relup
@if "%1"=="downgrade" @goto relup
@if "%1"=="console" @goto console
@if "%1"=="ping" @goto ping
@if "%1"=="list" @goto list
@if "%1"=="attach" @goto attach
@if "%1"=="remote_console" @goto attach
@if "%1"=="" @goto usage
@call :is_extension "%1"
@if "%ERRORLEVEL%"=="0" @goto run_extension
@echo Unknown command: "%1"
@goto :eof
:: Find the ERTS dir
:find_erts_dir
@set "possible_erts_dir=%release_root_dir%\erts-%erts_vsn%"
@if exist "%possible_erts_dir%" (
call :set_erts_dir_from_default
) else (
call :set_erts_dir_from_erl
)
@goto :eof
:: Set the ERTS dir from the passed in erts_vsn
:set_erts_dir_from_default
@set "erts_dir=%possible_erts_dir%"
@set "rootdir=%release_root_dir%"
@goto :eof
:: Set the ERTS dir from erl
:set_erts_dir_from_erl
@for /f "delims=" %%i in ('where erl') do @(
set "erl=%%i"
)
@for /f "delims=" %%i in ('"%erl%" -boot no_dot_erlang -noshell -eval "io:format(\"~s\", [filename:nativename(code:root_dir())])." -s init stop') do @(
set "erl_root=%%i"
)
@set "erts_dir=%erl_root%\erts-%erts_vsn%"
@set "rootdir=%erl_root%"
@goto :eof
:: Find the sys.config file
:find_sys_config
@set "possible_sys=%rel_dir%\sys.config"
@if exist "%possible_sys%" (
set sys_config=-config "%possible_sys%"
) else (
@if exist "%possible_sys%.orig" (
ren "%possible_sys%.orig" sys.config
set sys_config=-config "%possible_sys%"
)
)
@goto :eof
:: Find the vm.args file
:find_vm_args
@if not exist "%vm_args%" (
@if exist "%vm_args%.orig" (
ren "%vm_args%.orig" vm.args
)
)
@goto :eof
:: set boot_script variable
:set_boot_script_var
@if exist "%rel_dir%\%rel_name%.boot" (
set "boot_script=%rel_dir%\%rel_name%"
) else (
set "boot_script=%rel_dir%\start"
)
@goto :eof
:: Write the erl.ini file
:write_ini
@set erl_ini=%erts_dir%\bin\erl.ini
@set converted_bindir=%bindir:\=\\%
@set converted_rootdir=%rootdir:\=\\%
@echo [erlang] > "%erl_ini%"
@echo Bindir=%converted_bindir% >> "%erl_ini%"
@echo Progname=%progname% >> "%erl_ini%"
@echo Rootdir=%converted_rootdir% >> "%erl_ini%"
@goto :eof
:: Display usage information
:usage
@if "%2"=="install" (
@echo "Usage: %rel_name% install [VERSION]"
@echo "Installs a release package VERSION, it assumes that this"
@echo "release package tarball has already been deployed at one"
@echo "of the following locations:"
@echo " releases/<relname>-<version>.tar.gz"
@echo " releases/<version>/<relname>-<version>.tar.gz"
@echo " releases/<version>/<relname>.tar.gz"
@echo ""
@echo " --no-permanent Install release package VERSION but"
@echo " don't make it permanent"
@goto :eof
)
@if "%2"=="uninstall" (
@echo "Usage: %rel_name% uninstall [VERSION]"
@echo "Uninstalls a release VERSION, it will only accept"
@echo "versions that are not currently in use"
@goto :eof
)
@if "%2"=="upgrade" (
@echo "Usage: %rel_name% upgrade [VERSION]"
@echo "Upgrades the currently running release to VERSION, it assumes"
@echo "that a release package tarball has already been deployed at one"
@echo "of the following locations:"
@echo " releases/<relname>-<version>.tar.gz"
@echo " releases/<version>/<relname>-<version>.tar.gz"
@echo " releases/<version>/<relname>.tar.gz"
@echo ""
@echo " --no-permanent Install release package VERSION but"
@echo " don't make it permanent"
@goto :eof
)
@if "%2"=="downgrade" (
@echo "Usage: %rel_name% downgrade [VERSION]"
@echo "Downgrades the currently running release to VERSION, it assumes"
@echo "that a release package tarball has already been deployed at one"
@echo "of the following locations:"
@echo " releases/<relname>-<version>.tar.gz"
@echo " releases/<version>/<relname>-<version>.tar.gz"
@echo " releases/<version>/<relname>.tar.gz"
@echo ""
@echo " --no-permanent Install release package VERSION but"
@echo " don't make it permanent"
@goto :eof
)
@call :is_extension "%2"
@if "%ERRORLEVEL%"=="0" (
@if exist "%script_dir%\extensions\%2.cmd" (
call "%script_dir%\extensions\%2.cmd" help
@goto :eof
)
)
set commands=install uninstall start stop restart upgrade downgrade console ping list attach remote_console
if not "%extensions%"=="" (
set "commands=%commands% %extensions%"
)
@echo Usage: %~n0 ^(%commands: =^|%^)
@goto :eof
:: Install the release as a Windows service
:: or install the specified version passed as argument
:install
set args=%erl_opts% -setcookie %cookie% ++ -rootdir \"%rootdir%\"
set start_erl=%erts_dir%\bin\start_erl.exe
set description=Erlang node %node_name%%hostname% in %rootdir%
@if "" == "%2" (
:: Install the service
%erlsrv% add %service_name% %node_type% "%node_name%%hostname%" -c "%description%" -w "%rootdir%" -m "%start_erl%" -args "%args%" -stopaction "init:stop()."
) else (
:: relup and reldown
goto relup
)
@goto :eof
:: Uninstall the Windows service
:uninstall
@%erlsrv% remove %service_name%
@%epmd% -kill
@goto :eof
:: Start the Windows service
:start
@call :ensure_dot_erlang_cookie
@%erlsrv% start %service_name%
@goto :eof
:: Stop the Windows service
:stop
@%erlsrv% stop %service_name%
@goto :eof
:: Relup and reldown
:relup
@if "" == "%2" (
echo Missing version argument
echo Usage: %rel_name% %1 {version}
set ERRORLEVEL=1
exit /b %ERRORLEVEL%
)
@%escript% "%rootdir%/bin/install_upgrade.escript" "install" "{'%rel_name%', \"%node_type%\", '%node_name%%hostname%', '%cookie%'}" "%2" "%3"
@goto :eof
:: Start a console
:console
@call :ensure_dot_erlang_cookie
@set boot=-boot "%boot_script%" -boot_var RELEASE_DIR "%release_root_dir%"
@start "%rel_name% console" %werl% %boot% %sys_config% ^
-args_file "%vm_args%"
@goto :eof
:: Ping the running node
:ping
@%escript% %nodetool% ping %node_type% "%node_name%%hostname%" -setcookie "%cookie%"
@goto :eof
:: List installed Erlang services
:list
@%erlsrv% list %service_name%
@goto :eof
:: Attach to a running node
:attach
@set boot=-boot "%clean_boot_script%" -boot_var RELEASE_DIR "%release_root_dir%"
@start "%node_name% attach" %werl% %boot% ^
-remsh %node_name%%hostname% %node_type% console -setcookie %cookie%
@goto :eof
:: Run extension script
:run_extension
@if exist "%script_dir%\extensions\%1.cmd" (
set _extension_params=%*
call set _extension_params=%%_extension_params:*%1=%%
call "%script_dir%\extensions\%1.cmd" %%_extension_params%%
)
@goto :eof
:: Local Functions
:is_extension
@set "ext=%~1"
:: Check for entries in the list, not at the ends
@call set "ext_test_1=x%%extensions: %ext% =%%"
:: Check for entry at the start of the list
@call set "ext_test_2=x%%extensions:%ext% =%%"
:: Check for entry at the end of the list
@call set "ext_test_3=x%%extensions: %ext%=%%"
@if not "%ext_test_1%"=="x%extensions%" exit /b 0
@if not "%ext_test_2%"=="x%extensions%" exit /b 0
@if not "%ext_test_3%"=="x%extensions%" exit /b 0
@exit /b 1
:ensure_dot_erlang_cookie
:: Run a dummy distributed erlang node just to ensure that %HOMEPATH%\.erlang.cookie exists.
:: This action is best-effort and could fail because of the way the system is set up.
:: Failures are logged, but ignored.
:: Create random dummy node name
@set /a "_rand_nr=%RANDOM%+100000"
@set "dummy_name=dummy-%_rand_nr%"
:: Run node and capture output in local var
@for /f "delims=" %%i in ('%erl% -sname %dummy_name% -boot no_dot_erlang -noshell -eval "halt()."') do @(
set "dummy_node_output=%%i"
)
:: Check for execution error
@if "%dummy_node_output%" neq "" @(
echo Creating .erlang.cookie failed: "%dummy_node_output%"
)
:: Clear all local variables
@set "dummy_node_output="
@exit /b 0
|