p2pool-salvium/docs/BSD_RC_SCRIPT.MD

Setting up P2Pool as a service controlled by a RC script (FreeBSD, and possibly other)

In order to use this RC script, it is required to create a p2pool user account on the system for this service. An example passwd(5) line for this user would be:

p2pool:*:818:818::0:0:Monero P2Pool:/var/db/p2pool:/usr/sbin/nologin

Also an example group(5) line:

p2pool:*:818:

When creating such an user and a group, make sure the UID and GID aren't being used by any other user/group in the system. The home directory of the user will be used as the data directory of P2Pool; set it to your desired location as needed.

The RC script assumes the P2Pool executable is installed as /usr/local/bin/p2pool.

/usr/local/etc/rc.d/p2pool

#!/bin/sh

# PROVIDE: p2pool
# REQUIRE: LOGIN FILESYSTEMS
# KEYWORD: shutdown

. /etc/rc.subr

name=p2pool
rcvar=p2pool_enable

load_rc_config $name

: ${p2pool_enable:="NO"} ${p2pool_local_api:="NO"}

[ -z "$p2pool_wallet" ] && exit 1
p2pool_user=p2pool
p2pool_home="`getent passwd ${p2pool_user} | cut -d : -f 6`"
[ -z "$p2pool_home" ] && exit 1
p2pool_env="HOME=$p2pool_home"
p2pool_chdir="$p2pool_home"
procname=/usr/local/bin/p2pool
pidfile="$p2pool_home/p2pool.pid"
command=/usr/sbin/daemon
flags="-p ${pidfile} -f -- ${procname} ${p2pool_flags} --data-dir ${p2pool_home} --wallet ${p2pool_wallet}"
[ -n "${p2pool_api_path}" ] && flags="${flags} --data-api ${p2pool_api_path}"
if checkyesno p2pool_local_api; then
	if [ -n "${p2pool_api_path}" ]; then
		flags="${flags} --local-api"
	else
		echo 'Warning: p2pool_local_api="YES" requires p2pool_api_path being set, ignoring' 1>&2
	fi
fi
start_precmd="p2pool_prestart"
stop_postcmd="rm -f ${pidfile}"

p2pool_prestart() {
	if [ -n "${p2pool_api_path}" ]; then
		[ -d "${p2pool_api_path}" ] || mkdir -p "${p2pool_api_path}"
		gid="`getent passwd ${p2pool_user} | cut -d : -f 4`"
		chown ${p2pool_user}:${gid} "${p2pool_api_path}"
	fi
}

run_rc_command "$1"

Configuration variables in /etc/rc.conf (or /etc/rc.conf.local)

• p2pool_enable Set to YES to enable this service; required.
• p2pool_wallet Your wallet address; required.
• p2pool_api_path Path to API directory (See p2pool option --data-api), this directory will be created automatically if not already exists, on service startup; optional.
• p2pool_local_api Set to YES to enable creation of local path in API directory (See p2pool option --local-api), requires p2pool_api_path also being set; optional.
• p2pool_flags Additional options you want to pass to p2pool; optional.

Example

p2pool_enable="YES"
p2pool_wallet="44MnN1f3Eto8DZYUWuE5XZNUtE3vcRzt2j6PzqWpPau34e6Cf4fAxt6X2MBmrm6F9YMEiMNjN6W4Shn4pLcfNAja621jwyg"
p2pool_api_path="/tmp/p2pool-api"
p2pool_local_api="YES"
p2pool_flags="--host 127.0.0.1 --in-peers 200"

/usr/local/etc/newsyslog.conf.d/p2pool.conf (optional)

You can create this drop-in newsyslog(8) configuration file to periodically rotate the P2Pool log file. The drop-in location /usr/local/etc/newsyslog.conf.d/ assumes that /etc/newsyslog.conf contains an include directive for searching drop-in configuration files in it.

This example assumes /var/db/p2pool as your P2Pool data directory.

# log file			owner:group		mode	count	size (KiB)	when	flags	pid file				signal
/var/db/p2pool/p2pool.log	p2pool:p2pool		640	16	65536		@0101T	BEJ	/var/db/p2pool/p2pool.pid		SIGUSR1

You should adjust the count, size, when and/or flags fields to fit your needs.