robot_upstart install啟動命令參數(shù)分析
命令示例
rosrun robot_upstart install --interface lo --master "http://127.0.0.1:11311" --user root --setup /home/test/ros_ws/setup.bash test_bringup/launch/test_start.launch --logdir /home/test/logs
沒有指定job（service）名稱就用“test_bringup”中的"test"
參數(shù)說明
usage: install [-h] [--job JOB] [--interface ethN] [--user NAME]
[--setup path/to/setup.bash] [--rosdistro DISTRO]
[--master http://MASTER:11311] [--logdir path/to/logs]
[--augment] [--provider [upstart|systemd]] [--symlink]
pkg/path [pkg/path ...]
--job 指定job(service)名稱耸弄，如果沒有制定，就使用package中的一部分 (一般為‘_’之前的單詞）
--interface 指定網(wǎng)絡接口
--user 指定用戶啟動launch腳本
--setup 指定使用特殊工程下的setup.bash文件赚抡。
--rosdistro 指定ros的發(fā)布版本
--master 指定ROS_MASTER_URI
--logdir 指定日志文件目錄
--augment=False 不創(chuàng)建job既荚，只是拷貝用戶文件待笑。默認job已經(jīng)創(chuàng)建成功
pkg/path 安裝job launch的package和path名稱乳幸，保持路徑以包名開頭(不可使用絕對或workspace最top路徑)
--provider 指定 provider 在無法自動檢測正確的 provider 情況下
--symlink=False 創(chuàng)建軟鏈接肝集，而不是拷貝啟動腳本瞻坝。
成功執(zhí)行后，說明
- /etc/init/下生成 test.conf
# THIS IS A GENERATED FILE, NOT RECOMMENDED TO EDIT.
description "bringup test"
start on local-filesystems
stop on runlevel [016]
console log
respawn
exec test-start
pre-stop exec test-stop
- /etc/ros下產(chǎn)生
/etc/ros$ tree
.
├── indigo
│ └── test.d
│ ├── test_start.launch
└── rosdep
└── sources.list.d
└── 20-default.list
4 directories, 3 files
其中 test.d下有
/etc/ros/indigo/test.d$ cat .installed_files
/etc/ros/indigo/test.d/test_start.launch
/etc/ros/indigo/test.d/.installed_files
/usr/sbin/test-stop
/usr/sbin/test-start
/etc/init/test.conf
- 查看日志
sudo tail -f -n 10 /var/log/upstart/test.log
啟動時的log和節(jié)點運行的log都在這里面 （注意：這個test.log為服務名）
如果launch啟動失敗杏瞻，會提示log記錄的全路徑所刀，按照提示就是能找到launch啟動失敗的詳細信息，可以幫助問題定位捞挥。
額外信息
cat /usr/sbin/test-start
#!/bin/bash
# THIS IS A GENERATED FILE, NOT RECOMMENDED TO EDIT.
function log() {
logger -s -p user.$1 ${@:2}
}
log info "test: Using workspace setup file /home/test/ros_ws/install/setup.bash"
source /home/test/ros_ws/install/setup.bash
JOB_FOLDER=/etc/ros/indigo/test.d
log_path="/home/test/logs"
if [[ ! -d $log_path ]]; then
CREATED_LOGDIR=true
trap 'CREATED_LOGDIR=false' ERR
log warn "test: The log directory you specified \"$log_path\" does not exist. Attempting to create."
mkdir -p $log_path 2>/dev/null
chown root:root $log_path 2>/dev/null
chmod ug+wr $log_path 2>/dev/null
trap - ERR
# if log_path could not be created, default to tmp
if [[ $CREATED_LOGDIR == false ]]; then
log warn "test: The log directory you specified \"$log_path\" cannot be created. Defaulting to \"/tmp\"!"
log_path="/tmp"
fi
fi
export ROS_HOSTNAME=$(hostname)
export ROS_MASTER_URI=http://127.0.0.1:11311
log info "test: Launching ROS_HOSTNAME=$ROS_HOSTNAME, ROS_IP=$ROS_IP, ROS_MASTER_URI=$ROS_MASTER_URI, ROS_LOG_DIR=$log_path"
# If xacro files are present in job folder, generate and expand an amalgamated urdf.
XACRO_FILENAME=$log_path/test.xacro
XACRO_ROBOT_NAME=$(echo "test" | cut -d- -f1)
rosrun robot_upstart mkxacro $JOB_FOLDER $XACRO_ROBOT_NAME > $XACRO_FILENAME
if [[ "$?" == "0" ]]; then
URDF_FILENAME=$log_path/test.urdf
rosrun xacro xacro $XACRO_FILENAME -o $URDF_FILENAME
if [[ "$?" == "0" ]]; then
log info "test: Generated URDF: $URDF_FILENAME"
else
log warn "test: URDF macro expansion failure. Robot description will not function."
fi
export ROBOT_URDF_FILENAME=$URDF_FILENAME
fi
# Assemble amalgamated launchfile.
LAUNCH_FILENAME=$log_path/test.launch
rosrun robot_upstart mklaunch $JOB_FOLDER > $LAUNCH_FILENAME
if [[ "$?" != "0" ]]; then
log err "test: Unable to generate amalgamated launchfile."
exit 1
fi
log info "test: Generated launchfile: $LAUNCH_FILENAME"
# Warn and exit if setuidgid is missing from the system.
which setuidgid > /dev/null
if [ "$?" != "0" ]; then
log err "test: Can't launch as unprivileged user without setuidgid. Please install daemontools package."
exit 1
fi
# Punch it.
export ROS_HOME=$(echo ~root)/.ros
export ROS_LOG_DIR=$log_path
setuidgid root roslaunch $LAUNCH_FILENAME &
PID=$!
log info "test: Started roslaunch as background process, PID $PID, ROS_LOG_DIR=$ROS_LOG_DIR"
echo "$PID" > $log_path/test.pid
wait "$PID"
cat /usr/sbin/test-stop
#!/bin/bash
# THIS IS A GENERATED FILE, NOT RECOMMENDED TO EDIT.
PID=$(cat /home/test/logs/test.pid)
logger -p user.info "Attempting to stop test (PID $PID)"
kill $PID
