Troubleshooting Raven Pro and Raven Lite on Linux Systems

Introduction

Raven Pro and Raven Lite User’s have reported several problems when attempting to install the software on Linux systems. I have listed solutions to these problems below in the order you are likely to encounter them during installation.

Note that we have tested Raven Pro and Raven Lite only in Ubuntu.

Solutions

1. Solution #1
   If you installed Raven more than a year ago or you are using an installer you downloaded more than a year ago, you may be using an older version of Raven. We would recommend that you delete all Raven files and folders, then install the latest version of Raven.
   • Raven Pro
     • Delete folders
       • ~/RavenPro1.6
       • /opt/RavenPro1.6
     • Install Raven Pro 1.6.5.
   • Raven Lite
     • Delete folders
       • ~/RavenLite2
       • /Opt/RavenLite2
     • Install Raven Lite 2.0.5.
2. Solution #2
   If you find that the Raven installer fails to download completely or that the downloaded installer is corrupted or that installer payload initialization failed, it may be that you didn’t wait long enough for the installer to download. The Raven installers are big and may take some time to download. If waiting a few minutes doesn’t help, you can find additional troubleshooting steps in Raven Does Not Download / Download is Corrupt.
3. Solution #3
   Raven Pro may be failing to find a valid RavenPro1.6.ini file (or Raven Lite may be failing to find a valid RavenLite2.ini file).
   • Symptoms
     • Raven fails to open.
     • Raven opens, but some of the settings windows are blank. (For example, selecting “Preferences” from the Edit menu opens a blank window.)
     • Terminal may report an exception in “JavaFX Application Thread”.
     Solutions
     • Solution #3a: Open Raven using the desktop shell script (.sh file) installed by the installer. Details in the Raven Pro and Raven Lite installation instructions.
     • Solution #3b: The Raven installer may have failed to write the ini file. You can find solutions for:
       • Raven Pro
       • Raven Lite
       Solution #3c: Some users report that /opt/RavenPro1.6/RavenPro.sh or /opt/RavenLite2/RavenLite.sh cannot find their correct user name. You should be able to fix the problem by editing a line in RavenPro.sh or Raven Lite.sh using your default text editor.
       • Solution #3c1: Replace the text at line 44 with
         RAVENUSER=$(who | awk ‘{print $1}; exit’)
       • Solution #3c2: Replace the text at line 44 with
         RAVENUSER=$(who | head -n 1 | awk ‘{print $1}’)
       • Solution #3c3: Replace the text at line 57 with an instructions that hard codes your home directory. For example, if your user name is “mike”, replace line 57 with
         HOMEDIR=”/home/mike”