OK - Here are my fully fleshed out and tested instructions:
Installing Vision Client on ChromeOS and Chrome OS Flex
Prerequisites
- The machine should be running either ChromeOS or ChromeOS Flex
- Enable the Linux Developer Environment:
- The following instructions are taken from this Google article, which also has tips for troubleshooting and installing other linux apps.
- On ChromeOS/Flex, at the bottom right, select the time.
- Select Settings
About ChromeOS
Developers.
- Next to "Linux development environment," select Set up.
- Follow the on-screen instructions. Setup can take 10 minutes or more
- A terminal window opens to a Debian environment. You can run Linux commands, install more tools using the APT package manager, and customize your shell.
- Some notes about the Linux Developer Environment.
- Enabling this in ChromeOS creates a “virtual machine” that runs a limited version of LinuxOS Debian (called crostini) alongside ChromeOS. It is capable of running most of what is available in a typical Debian Linux installation, but not everything.
- The virtual machine is named “Penguin” by default. So, when you run a terminal session, you will be
username@penguin
. - You can start a linux terminal session from the applications menu in Chrome OS (available via the little circle at the bottom left of the screen). The icon looks like… a penguin… sort of.
- Install Java Runtime Environment (JRE) for Debian
- From the wiki at debian dot org:
- From the terminal run:
Then run:sudo apt update
sudo apt-get install default-jre
Install Vision Client Launcher
-
Navigate to your Vision gateway and download the installer for Linux. The installer is compressed in a .tar package named
visionclientlauncher.tar.gz
-
Download the installer to the “Linux Files” directory in ChromeOS or move it there after you download it (use the ChromeOS “FIles” app to find it at My Files/Linux Files, or use the
mv
command from the Linux terminal to move it to your home directory).- Note: the “Linux Files” directory is a graphical view into your Linux user account’s home directory (for instance, in my case this is
/home/paulc/
). Thus, whatever you place in your Linux user home directory will appear in this folder, and vice versa.
- Note: the “Linux Files” directory is a graphical view into your Linux user account’s home directory (for instance, in my case this is
The next few steps are based on the threads from this post at the Inductive Automation Users Forum:
-
Unpack the
visionclientlauncher.tar
package:- From the Linux terminal, cd to your home directory and run:
tar -xvf visionclientlauncher.tar.gz
-
Move the unpacked
visonclientlauncher/
folder to the appropriate location, depending on if you’re installing for all users or just one:-
If you want to install it for all users, then:
- Move the
visionclientlauncher
folder somewhere in/usr/local/
or/usr/share/
or/opt/
, - Then copy just the
visionclientlauncher.desktop
file into/usr/share/applications/
.
- Move the
-
If you want to install it for just one particular user:
- Move the
visionclientlauncher/
folder into the user’s home directory - Then copy just the
visionclientlauncher.desktop
file to~/.local/share/applications
.
- Move the
-
-
Change the permissions visionclientlauncher folder:
sudo chmod -R 775 visionclientlauncher
-
Within visionclientlauncher/app, change the visionclientlauncher.sh and the launcher-vision-client-linux.jar file to be executable -
sudo chmod +x visionclientlauncher.sh sudo chmod +x launcher-vision-client-linux.jar
-
Using Nano, vi, or your preferred text editor, edit the copied version of the
visionclientlauncher.desktop
file that you copied in step 3 above to change the paths accordingly (see below). Note that because these directories are protected, you'll need to invoke your text editor as sudo. -
You should now be able to load the Vision Client Launcher from the Applications pane (access from the circle icon at the bottom left of the screen)
-
Add the icon shortcut to the taskbar.
Example edits for the visionclientlauncher.desktop file
The visionclientlauncher.desktop
file is very important, as it provides the OS with the information needed to open the Vision Client Launcher when a user clicks on the icon in the applications folder in the Chrome OS GUI. Thus, if you don’t get this right, the application simply won’t load. The reference to the icon tells the GUI what icon to use in the applications folder and other locations. If you get this wrong then the GUI will simply choose the default “linux app” penguin icon.
I was using a shared machine, and needed the Vision program to be available just to me. So I moved the visionclientlauncher/
folder to the root level of my home directory at /home/paulc/
. Then I edited the visionclientlauncher.desktop
file to look like this:
[Desktop Entry]
Encoding=UTF-8
Version=1.1
Type=Application
Terminal=False
Icon=/home/paulc/visionclientlauncher/app/launcher.png
Name=Vision Client Launcher
Exec=/home/paulc/visionclientlauncher/app/visionclientlauncher.sh -Dapp.h
Path=/home/paulc/visionclientlauncher/app/
If you’re installing for all users, and you’ve saved to /usr/local/
then your visionclientlauncher.desktop
file should look like this:
[Desktop Entry]
Encoding=UTF-8
Version=1.1
Type=Application
Terminal=False
Icon=/usr/local/visionclientlauncher/app/launcher.png
Name=Vision Client Launcher
Exec=/usr/local/visionclientlauncher/app/visionclientlauncher.sh -Dapp.h
Path=/usr/local/visionclientlauncher/app/
You get the idea. The paths for Icon, Exec and Path just need to match whatever location you’ve chosen.
Good luck!