ferrero-opentext/Python-Version/MARKDOWN_DOCS/CREATIVEX_DEPLOYMENT.md

CreativeX Service Deployment Guide

This guide explains how to deploy the CreativeX Scoring Service as a background systemd service.

Prerequisites

• The application must be installed in /opt/ferrero-opentext/Python-Version.
• The virtual environment must be at /opt/ferrero-opentext/Python-Version/venv.
• The user running the service is assumed to be daveporter (adjust if necessary).

1. Install the Service

Copy the service file to the systemd directory:

sudo cp scripts/creativex-service.service /etc/systemd/system/

2. Reload Systemd

Reload the systemd daemon to recognize the new service:

sudo systemctl daemon-reload

3. Enable and Start

Enable the service to start on boot, and start it immediately:

sudo systemctl enable creativex-service
sudo systemctl start creativex-service

4. Verify Status

Check if the service is running correctly:

sudo systemctl status creativex-service

You should see Active: active (running).

5. View Logs

You can view the service logs in two ways:

Option A: Systemd Journal

sudo journalctl -u creativex-service -f

Option B: Application Logs

tail -f logs/creativex_service.log

Troubleshooting

If the service fails to start:

1. Check permissions on the scripts directory.
2. Verify the paths in /etc/systemd/system/creativex-service.service.
3. Ensure the virtual environment python executable works.