Before you install the Cortex player on a Linux device, make sure you meet the System requirements. After you confirm that you met the requirements, complete the following procedure.
Note: You do not need to install any certificates. Cortex’s certificates are provided by Amazon Web Services (AWS).
To install Cortex on Linux with Fleet
- Log in to Fleet at fleet.cortexpowered.com.
- Click Download in the side navigation bar. The Cortex Downloads view appears.
- Click Download in the Linux section and save the
installer .shfile. - Open a terminal window and navigate to the directory under which you saved the
installer .shfile. -
Enter the following command:
$ chmod +x installer.sh $ sudo ./installer.sh -u <username>Note: Do not include $ when running the command. This is a symbol to indicate these are bash commands. You also must append the <username>. Example sudo ./installer.sh -u mediaownername
If you don't know your current username, you can easily find it by using one of the following commands to get your current username:
$ whoami -
To run the Cortex Player, ensure that you run the command as the username specified during installation. Enter the following command:
$ /opt/cortex/player/current/CortexPlayer
Additional notes
- The installer loads the latest Cortex player for user
<username>under/opt/cortex/player/<version>. - The installer also creates a symbolic link to the latest version.
/opt/cortex/player/currentalways points to the latest installed version. - Currently, old versions of Cortex player are kept indefinitely under
/opt/cortex/player. However, it is safe to delete older versions if you need to save some disk space.
Confirm the installation was successful
Ensure the Cortex Player is running:
To verify that the Cortex Player is running, use the following command:
ps aux | grep cortex-player-chromeosIf the player is running, you should see a process listed for the Cortex Player.
Ensure the Cortex Updater is running:
The Cortex Updater ensures that the player is up and running and handles upgrades. If the updater is not running and the player is killed, the player will not automatically start again. If the updater is running and the player is killed for some reason, the updater will attempt to restart the player.
To check if the Cortex Updater is running, use the following command:
ps aux | grep cortex/updateEnsure the autostart file is created:
To ensure that the Cortex Player automatically starts if the device reboots, check if the autostart file (cortex.desktop) exists. The following commands will help you verify this:
-
First, get the home directory of the user specified during installation:
UHOME=$(getent passwd "$USER" | cut -d: -f6) -
Define the autostart directory:
AUTOSTART_DIR="$UHOME/.config/autostart" -
Check if the
cortex.desktopfile exists in the autostart directory:AUTOSTART_FILE="$AUTOSTART_DIR/cortex.desktop" -
If the file exists, the player will automatically start on system reboot. To confirm, you can check if the file exists by listing the contents of the directory:
ls $AUTOSTART_DIRIf
cortex.desktopappears in the list, the autostart file has been created successfully.