Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
blocks:porteus_kiosk_dev [2020-11-17 06:49] mattias created |
blocks:porteus_kiosk_dev [2024-03-13 07:57] (current) mattias [Using SSH] |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== PIXILAB Player ====== | + | ====== PIXILAB Player |
- | PIXILAB Player | + | Sometimes it is useful to create |
+ | SSH access to the player, | ||
- | This is how it works: | + | Follow the [[blocks:porteus_kiosk|guide to build a standard kiosk]] but use the settings provided here. |
- | * Download a small ISO image and write it to a USB stick. | + | === Configuration File === |
- | * Boot the target computer from this USB stick. | + | |
- | * Connect the computer to the Internet to download a web browser. | + | |
- | * Make some choices as to how the player should operate. | + | |
- | * A complete operating system, including the browser, is written either to a USB stick or an internal drive. | + | |
- | * Restart the computer. | + | |
- | This guide describes in detail how you can make a player for use as a Display Spot with Blocks. We recommend using an [[https:// | + | Use the text file method |
- | + | ||
- | You need to add RAM to the computer. While 2 GB is for most applications, | + | |
- | You do not need any HD/SSD – just a USB memory stick to boot from. | + | |
- | + | ||
- | ==== Obtaining the Installer ==== | + | |
- | + | ||
- | Start by downloading the ISO image of [[http:// | + | |
- | ==== Starting the Installer ==== | + | |
- | + | ||
- | Connect the USB stick to the player | + | |
- | + | ||
- | Since the browser isn't included in the ISO, you must connect the player computer to a network that has Internet access. Preferably, this network should support automatic network configuration (DHCP) to simplify the setup. | + | |
- | + | ||
- | ==== Installation Settings ==== | + | |
- | + | ||
- | Once the installer ISO has started, you should see a screen like this one. | + | |
- | + | ||
- | {{ : | + | |
- | + | ||
- | Assuming you're using a wired Ethernet connection, click the leftmost button. | + | |
- | + | ||
- | Next, choose " | + | |
- | + | ||
- | {{ : | + | |
- | + | ||
- | Click " | + | |
- | + | ||
- | {{ : | + | |
- | + | ||
- | Select which browser to use. Chrome usually has the best performance. A confirmation/ | + | |
- | + | ||
- | {{ : | + | |
- | + | ||
- | A network connection will be established (this may take some time). If a license agreement is presented, read and agree to it. Your browser of choice will be downloaded. | + | |
- | + | ||
- | At the next page, you have the choice of either doing all settings manually, or loading them in from a text file on a USB stick. The text file method is faster, while the manual method allows for greater flexibility in choosing the options you want. | + | |
- | + | ||
- | {{ : | + | |
- | + | ||
- | === Automatic Configuration === | + | |
- | + | ||
- | If you want to use the text file method, | + | |
< | < | ||
Line 60: | Line 14: | ||
dhcp=yes | dhcp=yes | ||
browser=chrome | browser=chrome | ||
- | homepage_append=mac | ||
homepage=http:// | homepage=http:// | ||
- | hide_mouse=yes | ||
- | disable_navigation_bar=yes | ||
disable_private_mode=yes | disable_private_mode=yes | ||
- | homepage_check=PIXILAB Blocks Server can't be reached. Please check your network connection. | ||
wake_on_lan=yes | wake_on_lan=yes | ||
disable_zoom_controls=yes | disable_zoom_controls=yes | ||
- | additional_components=uefi.zip initrdpxe.xz | ||
persistence=session | persistence=session | ||
- | timezone=Factory | ||
primary_keyboard_layout=us | primary_keyboard_layout=us | ||
- | </ | + | additional_components=uefi.zip initrdpxe.xz 08-ssh.xzm |
- | + | root_password=pixi | |
- | Choose "Load configuration from removable media". When prompted to do so (not before), insert the USB stick containing the //kiosk-config.txt// | + | hide_mouse=no |
+ | disable_navigation_bar=no | ||
- | If you need to display any custom content that shows time-related data, you may want to set the value of the timezone parameter to your local zone, from one of [[https:// | ||
- | |||
- | If you want to use a keyboard with the player, specify the desired keyboard layout using the value of the primary_keyboard_layout parameter , from one of [[https:// | ||
- | |||
- | If you want to configure a NTP server use the ntp_server parameter. If the parameter is not present, then default NTP server is ' | ||
- | < | ||
- | ntp_server=server.org | ||
</ | </ | ||
- | === Manual Configuration === | + | The differences compared to a standard setting are: |
+ | * Add 08-ssh.xzm module to enable SSH. | ||
+ | * Set root-password for SSH access. | ||
+ | * Show the mouse | ||
+ | * Show the navigation bar | ||
- | If you choose to do the configuration manually, here are some options you most likely need to set. | ||
- | * Enable Wake on LAN. | ||
- | * Enable Home Page, setting the url to '' | ||
- | * Private mode; disable. | ||
- | * Zoom Controls; disable. | ||
- | * Navigation bar; disable. | ||
- | * Mouse Cursor; Disable (with "Hide Permanently" | ||
- | * The additional components mentioned above (uefi.zip pixilab.xzm), | ||
- | The second point above (as well as the // | ||
- | ==== Disable Automatic Fixes ==== | ||
- | Choose " | ||
- | {{ : | + | ==== Using SSH ==== |
- | Then click Next to proceed. | + | In case you need to access the player with SSH, you first have to find its IP number. This can be found in the Blocks editor under Display spot settings/ |
- | ==== Specifying Installation Drive ==== | + | To log on, use a ssh enabled terminal window. |
- | Choose | + | :!: On Windows, you must enable //OpenSSH Client// under "Windows optional features". |
- | {{ : | ||
- | Click " | + | < |
+ | $ ssh root@[ipnumber] | ||
+ | </ | ||
+ | Enter the password specified in the kiosk-config file. | ||
- | ==== Making multiple players ==== | + | On your computer used to access the player over SSH, you may have to reset the // |
- | While the above step is sufficient for installing PIXILAB Player onto one bootable device, it can be quite tedious to repeat this procedure if you want the same configuration on numerous players. To install | + | - Open the // |
+ | - Delete | ||
+ | - Save the file. | ||
+ | - Use the ssh command again, as shown above, to access the player | ||
- | Once the new dialog appears, insert a removable, FAT32-formatted, | + | To avoid the known host issue one can use: |
- | + | < | |
- | An ISO file will be placed at the root level of the USB drive. Use Etcher on another computer to flash any USB drive with the ISO, as described above. | + | $ ssh -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null root@[ip-number] |
- | + | </ | |
- | :!: Using [[https:// | + | Ip number |
- | + | ||
- | ==== Booting the player over the network ==== | + | |
- | + | ||
- | If you're using our [[blocks: | + | |
- | + | ||
- | * No USB stick is needed for each player. | + | |
- | * The player resides only on the server, making it easy to update. | + | |
- | * The configuration of all players also resides in a single place, making it easier to apply changes without making new USB sticks. | + | |
- | + | ||
- | In order to use this feature, your player PCs must support network boot based on the UEFI standard. This is supported by all reasonably modern NUC computers. Follow the instructions found [[blocks: | + | |
- | ===== Using the Display Spot ===== | + | |
- | + | ||
- | Connect the computer to your the network used by the Blocks server. For the above settings to work, you need to have at least a DHCP server on this network (which may be the one built into the [[blocks: | + | |
- | + | ||
- | ==== Power Management ==== | + | |
- | + | ||
- | When used with Blocks 2.2 or later, you can control the power of the player as well as the attached display. This works with most modern NUC models. In order to power up the player, make sure "wake on LAN" is enabled. This is specified in the configuration file above, but on some PCs this must also be enabled in the BIOS settings. | + | |
- | + | ||
- | The display' | + | |
- | + | ||
- | * If the display supports CEC control (often called something else by display manufacturers), | + | |
- | * If you're using a computer-style display, it may not support CEC. Instead it will typically turn itself off and on automatically as the computer is turned off/on. Make sure to enable this automatic power management feature of our display. | + | |
- | + | ||
- | If you want to use the CEC method, you need to enter the BIOS settings of the NUC. Navigate to ADVANCED, | + | |
- | + | ||
- | {{ :blocks: | + | |
- | + | ||
- | To make sure your NUC-based display spot restarts after a power failure, in BIOS settings select "Last State" under Advanced, Power, Secondary Power Settings, After Power Failure. | + | |
- | {{ : | + | |
- | + | ||
- | ==== Booting your players from the Blocks server ==== | + | |
- | + | ||
- | As an alternative to booting from a USB stick, you may chose to boot the players over the network from your Blocks server. This method is known as network booting or PXE booting. | + | |
- | Before attempting to boot the player from the server, make a USB stick as described above, and make sure your player works properly. | + | |
- | + | ||
- | To enable network booting of you player, do the following (where individual steps may vary depending on the BIOS in the player computer): | + | |
- | + | ||
- | * Open the player' | + | |
- | * Select "Boot USB Devices First" to make it boot from USB if one is attached. | + | |
- | * Select "Boot Network Device Last" to make it boot from the server if no USB key is connected. | + | |
- | * Select " | + | |
- | * Disable " | + | |
- | * Disable " | + | |
- | * Select " | + | |
- | + | ||
- | Follow [[blocks: | + | |
- | + | ||
- | ==== Manage Pixilab Player Chrome Policies from the Blocks server ==== | + | |
- | + | ||
- | In some cases, when using the Chrome browser with PIXILAB Player, you may need to override the browser' | + | |
- | + | ||
- | < | + | |
- | + | ||
- | The " | + | |
- | + | ||
- | < | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | + | ||
- | + | ||
- | More information on Chrome policies and syntax | + |