Troubleshooting

Game download

Stuck during game download

Machines can get stuck during game downloads, but will mostly retry and eventually recover by themselves.

Symptoms:

• Game download spinner stays on indefinitely in the cloud portal. See screenshot above.
• Error messages in the log on the cloud portal, e.g. Error reading executable dir.
• Log messages in the cloud portal indicating that game download failed despite multiple retries.

Common reasons:

• Internet unstable or interrupted during game download
• Power outage during downloads

If a machine doesn’t recover by itself, it can mostly be recovered by the following steps:

1. Establish a terminal connection to the machine
2. Switch to the player user with the following command: sudo su player
3. Switch to the players home directory: cd
4. Remove all unfinished game downloads: rm -r Assets/cinemataztic-games/*.part
5. Delete the players local config: rm conf-db.json
6. Restart the player software: sudo systemctl restart cinemataztic-player
7. Monitor the machine in the cloud to ensure the game download is restarted and succeeds. See screenshot below.

Display

Wrong screen resolution

Machines sometimes get wrong screen resolution after rebooting. The Cinemataztic boxes should always be set to 1920x1080 @ 60Hz.

Symptoms:

• Red warning dot next to the screen in cloud.cinemataztic.com as well as warning message in the “player” card.
• On site: the game only fills a small part of the screen. This is due to the machine showing a 1920x1080 pixels image on a 4K display setting.

Common reasons:

• Typically caused by the connected equipment (i.e. projector / screen server) requesting a specific resolution and frame rate e.g. default 4K.

To set the correct screen resolution perform the following commands:

1. Establish a terminal connection to the machine
2. Switch to the player user with the following command: sudo su player
3. Export the display variable: export DISPLAY=:0
4. Use the xrandr command to list display options
5. Set the resolution: xrandr --output HDMI-0 --mode 1920x1080 --rate 60.00 (this sets the resolution to 1920x1080 at 60Hz for the display named HDMI-0)
6. Confirm that the correct resolution and framerate has been set: xrandr. The active setting will be marked with an asterix *
7. Confirm on cloud.cinemataztic.com that the resolution warning disappears.

Audio

No audio

Common cause is that the device isn’t set to output to the correct sink.

1. Log in to the machine as cinemataztic user
2. Change to the player user
3. Export DISPLAY variable: export DISPLAY=:0
4. List available sinks: pactl list sinks
5. Identify the correct sink index: e.g. if using HDMI on the PCI NVIDIA graphics card look for the sink that outputs to NVIDIA (see screenshot example)
6. Set the default sink (e.g. set to index 0 if desired): pactl set-default-sink 0