Home

Installation troubleshooting

This section provides information for troubleshooting and recovery.

Diagnosing issues from log files

Check the following log files to diagnose issues:

Installation process is broken

Whenever the installation process gets broken, do the following:

  1. Stop Unravel.

    manager stop

    If the manager does not work, open the services directory, each service has a stop.sh script. Stop the service monitor (monit). and then run the stop.sh script.

    In case you do not have stop.sh scripts, send SIGTERM to all the services starting with to the service monitor (monit)

    Note

    Avoid using SIGKILL since that may cause some file corruption.

  2. Reinstall Unravel using the content in the data directory.

Files got deleted or corrupted

  1. Stop Unravel.

  2. Assuming that you have installed Unravel in /opt, run the following command:

    <Unravel installation directory>/manager refresh

    This regenerates all the scripts and configuration files.

    In case the refresh command did not regenerate the files or the manager is broken, then check <Unravel installation directory>/data/conf/current.yaml and run the following. The current.yaml file shows the current version that is installed.

    <Unravel installation directory>/versions/X.Y.Z/setup --config=<Unravel installation directory>/data/conf/unravel.yaml
  3. Start Unravel.

    <Unravel installation directory>/manager start

Unravel software got deleted

  1. Stop Unravel.

  2. Check <Unravel installation directory>/data/conf/current.yaml for the current version that is installed.

  3. Unpack that same version in the exact location where it was deployed earlier.

    tar zxf unravel-SAME-VERSION.tar.gz -C /opt
  4. Run the following:

    <Unravel installation directory>/versions/X.Y.Z/setup --config=<Unravel installation directory>/data/conf/unravel.yaml
  5. Start the manager.

    <Unravel installation directory>/manager start

Restoring Unravel from a backup

  1. Stop Unravel.

  2. Restore the backup of the data directory.

  3. Open data/conf/unravel.effective.yaml and check for the following key paths:

    • base: <Unravel installation directory>

    • data: <Unravel installation directory>/data

  4. Make sure that the data is restored to the right location.

  5. Make sure the unravel user has full access and ownership of the base location and everything in it.

  6. Check< Unravel installation directory>/data/conf/current.yaml for the current version that is installed.

  7. Unpack that same version in the exact location where it was deployed earlier.

    tar zxf unravel-SAME-VERSION.tar.gz -C /opt
  8. Run the following:

    <Unravel installation directory>/versions/X.Y.Z/setup --config=<Unravel installation directory>/data/conf/unravel.yaml
  9. Start Unravel.

    <Unravel installation directory>/manager start

On-demand services not starting

If Unravel is installed in RHEL 7.7 environment, the following issues can occur while starting OnDemand service:

  • Unsafe symlink failure: To resolve this issue, you must manually edit the /etc/init.d and /etc/systemd/system files and change the location for PID file creation from usr/local/unravel/ondemand to /var/run.

    rhel77errorondemand.png
  • /lib/lsb/init-functions not existing: To resolve this issue, you must remove the existing /lib/lsb/init-functions file and install the redhat-lsb-core package:

    rmdir /lib/lsb/init-functions
    yum install redhat-lsb-core