Versions Compared

Old Version 4

changes.mady.by.user Alan Prothero

Saved on

compared with

New Version Current

changes.mady.by.user Alan Prothero

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • If the services is not registered then the rpm installation has not executed properly (or at all) and you should consult the relevant installation documentation before raising a support case

  • If the services is registered then the problem is not related to your MettleCI installation and you and/or your system administrator should diagnose your operating system configuration.

Diagnostics

Unix - RHEL

If you ran the MettleCI Workbench installer using rpm then the dm-mettleci-workbench service should have been set up to be automatically invoked during system boot when it was registered.

...

Code Block
# Check the service is installed
$> chkconfig --list | grep -i mettleci
dm-mettleci-workbench	0:off	1:off	2:on	3:on	4:on	5:on	6:off

$> chkconfig dm-mettleci-workbench
(followed IMMEDIATELY by)
$> echo $? 
(should return zero)

# Check the service is running (failure)
$> service dm-mettleci-workbench status
/opt/dm/mci/METTLE_UI.pid dead but pidfile exists

# Check the service is running (running)
$> service dm-mettleci-workbench status
---------------------------------------
MettleCI Workbench is running
---------------------------------------

# Check if the systemd service has been generated successfully
$> systemctl status dm-mettleci-workbench
● dm-mettleci-workbench.service - SYSV: DataMigrators Workbench
   Loaded: loaded (/etc/rc.d/init.d/dm-mettleci-workbench; generated)
   Active: inactive (dead)
     Docs: man:systemd-sysv-generator(8)
$> systemctl daemon-reload
$> systemctl start dm-mettleci-workbench
$> systemctl status dm-mettleci-workbench
● dm-mettleci-workbench.service - SYSV: DataMigrators Workbench
   Loaded: loaded (/etc/rc.d/init.d/dm-mettleci-workbench; generated)
   Active: active (exited) since Thu 2022-10-20 14:11:22 AEDT; 2s ago
     Docs: man:systemd-sysv-generator(8)
  Process: 12060 ExecStart=/etc/rc.d/init.d/dm-mettleci-workbench start (code=exited, status=0/SUCCESS)

Oct 20 14:11:22 engn dm-mettleci-workbench[12060]: ---------------------------------------
Oct 20 14:11:22 engn dm-mettleci-workbench[12060]: ---------------------------------------
Oct 20 14:11:22 engn dm-mettleci-workbench[12060]: MettleCI Workbench is running
Oct 20 14:11:22 engn dm-mettleci-workbench[12060]: ---------------------------------------
Oct 20 14:11:22 engn systemd[1]: dm-mettleci-workbench.service: Child 12060 belongs to dm-mettleci-workbench.service.
Oct 20 14:11:22 engn systemd[1]: dm-mettleci-workbench.service: Control process exited, code=exited status=0
Oct 20 14:11:22 engn systemd[1]: dm-mettleci-workbench.service: Got final SIGCHLD for state start.
Oct 20 14:11:22 engn systemd[1]: dm-mettleci-workbench.service: Changed start -> exited
Oct 20 14:11:22 engn systemd[1]: dm-mettleci-workbench.service: Job dm-mettleci-workbench.service/start finished, re>
Oct 20 14:11:22 engn systemd[1]: Started SYSV: DataMigrators Workbench.

# Check if the systemd service is enabled
$> systemctl is-enabled dm-mettleci-workbench
dm-mettleci-workbench.service is not a native service, redirecting to systemd-sysv-install.
Executing: /usr/lib/systemd/systemd-sysv-install is-enabled dm-mettleci-workbench
enabled

# Check the systemd service settings
$> systemctl cat dm-mettleci-workbench.service
# /run/systemd/generator.late/dm-mettleci-workbench.service
# Automatically generated by systemd-sysv-generator

[Unit]
Documentation=man:systemd-sysv-generator(8)
SourcePath=/etc/rc.d/init.d/dm-mettleci-workbench
Description=SYSV: DataMigrators Workbench
Before=multi-user.target
Before=multi-user.target
Before=multi-user.target
Before=graphical.target
After=ISFAgents.service
After=ODFEngine.service

[Service]
Type=forking
Restart=no
TimeoutSec=5min
IgnoreSIGPIPE=no
KillMode=process
GuessMainPID=no
RemainAfterExit=yes
ExecStart=/etc/rc.d/init.d/dm-mettleci-workbench start
ExecStop=/etc/rc.d/init.d/dm-mettleci-workbench stop

Known Issue when /opt is a Remote Mount

If the /opt directory is a remote mount, then the mount may not be ready when the MettleCI service tries to start.

In this situation, the service will not start on boot but starts normally when executed manually.

To rectify this, login as root and execute the following commands:-

Code Block
$> rm /etc/init.d/dm-mettleci-workbench
$> cp /opt/dm/mci/dm-mettleci-workbench /etc/init.d/dm-mettleci-workbench
$> systemctl daemon-reload

NOTE: The above commands must be repeated each time that MettleCI is upgraded

Run the Systemd Service Generator in Debug mode

If the output of the following commands is:-

...