Configuring Supervisor for Unopim

When managing processes for your Unopim project, Supervisor can be a key tool to ensure everything runs smoothly and efficiently. Here’s a guide on how to set up Supervisor to handle your Unopim processes.

The supervisor is the most commonly used and recommended process control for UnoPim.

How to setup?

Install supervisor by running the commands after that follow the below points.

apt update
apt install supervisor

1. Location of Configuration Files

Supervisor configuration files are typically found in the /etc/supervisor/conf.d directory. You’ll create a new configuration file here to specify how Supervisor should manage your Unopim processes.

2. Creating the Configuration File

Let’s say you want to manage a process for handling tasks in Unopim. You would create a configuration file, for instance, named unopim-worker.conf, in the /etc/supervisor/conf.d directory. Here’s an example configuration:

[program:unopim-worker]
command=/usr/bin/php /home/users/deepak.kumar/www/html/unopim/artisan queue:work
autostart=true
autorestart=true
user=deepak.kumar
numprocs=8
process_name=%(program_name)s_%(process_num)02d
redirect_stderr=true
stderr_logfile=/storage/logs/unopim_worker.err.log
stdout_logfile=/storage/logs/unopim_worker.out.log
stopasgroup=true

Explanation of Configuration Directives:

• command: This specifies the command to run the Unopim queue worker.
• autostart: Ensures that the worker starts automatically when Supervisor starts.
• autorestart: Configures Supervisor to restart the worker if it crashes.
• user: Defines the user under which the worker process will run.
• numprocs: Indicates the number of worker processes to run simultaneously (8 in this example).
• process_name: Specifies the naming template for the worker processes.
• redirect_stderr: Ensures that standard error output is redirected to the specified log file.
• stderr_logfile and stdout_logfile: Paths to the log files for capturing error and output logs.
• stopasgroup: Ensures that when the worker is stopped, all related processes are stopped together.

3. Starting Supervisor

After creating and saving your configuration file, you need to update Supervisor’s configuration and start the processes. Use the following commands:

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start unopim-worker:*

• sudo supervisorctl reread: Tells Supervisor to read the new configuration files.
• sudo supervisorctl update: Updates Supervisor with the new configuration settings.
• sudo supervisorctl start unopim-worker:*: Starts the processes defined in the unopim-worker program configuration.

For further details and advanced configurations, you can refer to the Supervisor documentation. This will provide additional insights into how you can leverage Supervisor for managing your Unopim project effectively.

Support

So, that was much about the  Process control in UnoPim for any queries or doubts reach out to us at support@webkul.com. You can also raise a ticket at our HelpDesk System.