SIMPLEVISOR-CONTROL(1)

πŸ“¦ version 1.2, in epel 9

✨ SIMPLEVISOR-CONTROL ✨

okay so bestie, this is the manual page for simplevisor-control, from the simplevisor-control man page collection β€” and it's genuinely the shortcut to running simplevisor as a service. no cap. πŸ’…


🌸 NAME 🌸

simplevisor-control β€” run simplevisor as a service πŸŽ€


πŸ¦‹ SYNOPSIS πŸ¦‹

simplevisor-control command [path]

πŸ’– DESCRIPTION πŸ’–

The simplevisor-control script is literally the way you run simplevisor as a service. iconic behavior only. πŸ‘‘

heads up bestie: if this script is used, the pidfile value specified in the simplevisor configuration file gets ignored. not "maybe", not "sometimes" β€” ignored. so don't be surprised when it's not the one in charge, mkay? 😭

⭐ OPTIONS ⭐

  • command β€” the thing you're telling it to do. run simplevisor-control help to list the available commands, bestie, that's literally what it's for 🫢
  • path β€” for how path behaves, go look at the simplevisor man page. trust me, it's all there ✨

πŸ”₯ EXAMPLES πŸ”₯

On Linux you can look at the script shipped in the examples folder β€” it's called simplevisor-new-instance, and it creates folders and the configuration to run a simplevisor instance. it's giving starter pack 🌈

mkdir -p /var/lib/myinstance/bin
mkdir -p /var/lib/myinstance/data
mkdir -p /var/lib/myinstance/etc

Create a file /var/lib/myinstance/bin/service with content and make it executable:

#!/bin/sh
#
# init script that can be symlinked from /etc/init.d
#

# chkconfig: - 90 15
# description: my simplevisor instance

. "/var/lib/myinstance/etc/simplevisor.profile"
exec "/usr/bin/simplevisor-control" ${1+"$@"}

/var/lib/myinstance/etc/simplevisor.profile could look like:

# main
export SIMPLEVISOR_NAME=myinstance
# if you want to run it as another user:
#export SIMPLEVISOR_USER=games
export SIMPLEVISOR_CONF=/var/lib/myinstance/etc/simplevisor.conf
export SIMPLEVISOR_PIDFILE=/var/lib/myinstance/data/simplevisor.pid
export SIMPLEVISOR_LOCKFILE=/var/lib/myinstance/data/simplevisor.lock

Create /var/lib/myinstance/etc/simplevisor.conf according to simplevisor documentation. yes, go read the docs, it's worth it, i promise πŸ“š

For Red Hat or Fedora you can symlink the service script:

ln -s /var/lib/myinstance/bin/service /etc/init.d/myinstance

And use it as a normal service:

/sbin/service myinstance start|stop|status|restart|check

like, that's it. that's the whole vibe check and it passed πŸ¦‹πŸ’œ


🧚 AUTHOR 🧚

Massimo Paladin <massimo.paladin@gmail.com>

Copyright (C) CERN 2013-2016


and that's the page, bestie β€” sign-off time πŸŽ€βœ¨ this one's dated 2016-06-27, and it belongs to SIMPLEVISOR-CONTROL(1), the simplevisor-control man page. mwah πŸ’– go start some services, you've got this πŸ‘‘

πŸ“¦ where this page comes from