Best practices for 8.1 Designer Launcher install on Linux?

Is there a “Best Practices” for installing the Designer app under Linux (Debian in my case) for Ignition 8.1?

I’m not sure if this is an Ignition or Linux question.

After downloading from the Gateway page, I end up with designerlauncher.tar.gz which contains the folder “designerlauncher”, which contains:

So where is the best/proper place to put all of these files?

2 Likes

I expand them to ~/designerlauncher-x.y.z/ until I’ve qualified whether they play nice with prior versions. Then I drop the version number, replacing the best prior that all my various shortcuts point at.

But you still keep the files in your home directory (~), rather than a system wide location? And does that allow the Linux system to pick up on the icon and make use of it?

I'm going to answer my own question here.

The designerlauncher.desktop file is a file that specifies where an application exists and how a Linux desktop such as Gnome (or other freedesktop.org compliant applications) can start it from an icon. These desktop systems assign icons to applications by registering each application's ".desktop" file.

There are 2 main locations where the ".desktop" file should be placed in order for this to occur:

  1. /usr/share/applications => For globally accessible applications by all users
  2. ~/.local/share/applications => For applications only accessible by the logged in user

Ideally you would place the designer.desktop file in one of those two locations, and place the executables somewhere else (that somewhere being described within the .desktop file). However the designerlauncher.desktop file specifies the location of the executables relative to the location of .desktop file itself. As taken from the .desktop file the app directory is defined as being in a sub-directory within the directory where the .desktop file is located:

Exec=bash -c 'cd "$(dirname "$1")/app" && ./designerlauncher.sh &' . %k

As I didn't want to:

  1. Pollute the global applications directory with the designerlauncher executables
  2. Rewrite the bash script to point to a different location

I simply copied the contents of the tar.gz file to my local applications directory. Given that I extracted the tar.gz file to ~/Downloads directory. I did this by executing the command line:

cp -rp ~/Downloads/designerlauncher/* ~/.local/share/applications

The "r" option means recursive, and the "p" option is to preserve file attributes.

With this done my Debian desktop could find the Designer Launcher application (I may have needed to log out and in again to refresh the desktop). Also just did exactly the same process for a Ubuntu based system.

Ideally the app and runtime directories should not be in the same directory as the .desktop file, but for testing purposes it works for me.

Next step is finding out where the designerlauncher puts the shortcuts for the projects!

6 Likes

Right, wrong, or indifferent here is what I have and it is working. Extract the tar ball, then put the designerlauncher folder in this directory: /[home]/.local/share/ignition where [home] is the home directory for your user account.

Put the .desktop folder in this directory /[home]/.local/share/applications. Then, make sure the desktop file is below replacing [home] with the user home directory:

[Desktop Entry]
Encoding=UTF-8
Exec=/[home]/.local/share/ignition/designerlauncher/runtime/bin/java -jar /[home]/.local/share/ignition/designerlauncher/app/launcher-designer-linux.jar
Icon=/[home]/.local/share/ignition/designerlauncher/app/launcher.png
Name[en_US]=Designer Launcher
Name=Designer Launcher
Path=.
StartupNotify=true
Terminal=false
Type=Application
Version=1.0

What I like about this is that is uses the portable java version that comes with the designerlauncher instead of mucking up your host java version.

It would be super nice if Inductive Automation made some deb and rpm packages for the Designer Launcher and the Vision Client launcher.

Enjoy!

1 Like

maybe post your request on ideas.inductiveautomation.com and tell people to vote :wink:
Anyway, thanks for your contribution.

I'm running Ubuntu and something that worked for me was to extract the .tar.gz into the desktop. Once in the desktop opened the folder "designerlauncher". Then opened the terminal in the folder. In the terminal wrote : gtk-launch designerlauncher.desktop

I tried everything you described in this thread, but I still have a java error when trying to open Designer.

In ~/.ignition/clientlauncher-data/ there should be a designerlauncher.log file.

In that, there will be a log message that says "Starting Java with the following parameters: ..."

Upload the designerlauncher.log file.

Copy the full command and paste/run it in a separate terminal and then provide the full output here.

I don't see subfolder /clientlauncher-data/ in /.ignition/ folder.
There is only empty subfolder /install/ inside.

Hmm, are you looking on the same system and under the same user that the Designer Launcher application is being run from?

Exactly. There is only one user on this system:

Well, in this screenshot you're logged in as root, not your user.

Looked under /home/root/.ignition?

Additional info:
I checked this on 2 different VM (Ubuntu 20.04 LTS and 22.04 LTS).
Gateway ver:
8.1.42.
Java ver:
openjdk version "21.0.3" 2024-04-16
OpenJDK Runtime Environment (build 21.0.3+9-Ubuntu-1ubuntu120.04.1)
OpenJDK 64-Bit Server VM (build 21.0.3+9-Ubuntu-1ubuntu120.04.1, mixed mode, sharing)

Don't run as root.

Expand the tarball into your actual home directory.

Run /home/$whatever/designerlauncher/app/designerlauncher.sh, as $whatever, not as root.

Don't run as root.

(My daily driver is Kubuntu 20.04, soon to be 22.04. I do this all the time, on bare metal.)

FWIW, I replace Ignition launcher shortcuts with .desktop files in this format:

[Desktop Entry]
Encoding=UTF-8
Version=1.1
Path=/home/philip/designerlauncher/app/
Type=Application
Terminal=false
Icon=/home/philip/.ignition/clientlauncher-data/images/DesignerIcon.png
Name=Designers
Exec=/home/philip/designerlauncher/app/designerlauncher.sh -Dapp.home=/home/philip/.ignition/clientlauncher-data
1 Like

It seems that in the meantime my colleague solved the problem.
I changed owner of /.ignition/ by:

sudo chown -R tomaszn .ignition

After that, Designer opens without any problem.

I haven't performed any operations as root before. I only logged in as root in the terminal when I was looking for the log file.
My colleague did the same test and had the same java error.
Changing permissions for /.ignition/ helped.