Jump to content

Publish

From SpinetiX Wiki
Note  
This page is about publishing content from Elementi. The information below may not apply to versions before Elementi 2025.

Introduction

Publishing content from Elementi refers to an optimized process of copying the content within a project to a list of target devices, such as SpinetiX players, third-party DSOS players, web servers (see “Publish Location” section below), or USB storage devices.

The publishing process consists of the following steps:

  1. Compare the content from the project with the one present on the target location.
  2. Remove from the target location all the files that are no longer present in the project being published.
  3. Copy the new and/or modified files to the target location. Unmodified files will be skipped!
Note Notes:
  • Only a single project can exist on the player at any given time; therefore, it is not possible to publish more than one project at the same time. You can, however, copy different projects into a "master" project and use a playlist or a schedule to cycle through them.
  • Publishing to a player is recommended over uploading the content directly to it because when a slightly modified project is (re)published, only the differences will be copied to the target location, thus saving both time and bandwidth
  • The Etag and/or Last-Modified HTTP directives are used to determine if a file was modified or not. See the “Caching” page for more details.
  • The publishing is done via the WebDAV protocol on port 9802 (secure) or 81.
  • Starting with Elementi 2018, secured publishing using TLS-SRP is activated by default for DSOS players that are automatically discovered. An update of the user password might be required to activate SRP.

Tutorial

To publish a project from Elementi onto one or more players within the same network, follow these steps:

Browse panel
Browse panel
  1. Go to the Browse panel.
  2. From the "Projects" tab, select your project and double-click to open it.
    • The project is open in the last tab on the right.
    • Notice that the "Send to cloud" and "Publish" buttons become active.
  3. Click on the "Publish" button.
  4. Publish dialog
    Publish dialog
    The "Publish" dialog opens, displaying the list of target devices where the project will be published to.
    • This list is empty if the project has never been published before, and is already filled up otherwise.
    • Elementi stores the list of target devices for each project.
  5. Add/Remove Publish targets
    Add/Remove Publish targets
    If you need to change the list of devices, click on the "Add/Remove" button.
    • All the devices are shown on the list on the right side. You can add/remove target devices using drag-and-drop or the arrow buttons situated between the two lists.
    • The target devices can be: DSOS players, USB storage drives, collections of devices, and Publish Locations.
    • Click the 🆗 button when done.
  6. Click the "Publish" button.
  7. A dialog opens showing the publishing progress onto the selected targets ― wait for the publishing to complete.
Note Notes:
  • Interrupting a publishing event might have unpredictable results; republish the project if that happens.
  • If you have a large project, publishing it may take a considerable time during which the screen may remain black. This can be avoided by adding a “publish screen” content (can be an image or a layout) inside your project.
  • Content created with Elementi usually requires a minimum firmware version on the player, which Elementi checks before publishing ― if lower than the required version, the publishing is stopped and an error message is displayed.
  • The publish target is not secure. Do you want to continue?
    Starting with Elementi 2021 Update 5 a confirmation message appears before publishing via insecure channels (i.e., plain HTTP, HTTPS with self-signed certificate), for instance when the players have been manually added into Elementi or the user password has not been updated to activate SRP.

Send to cloud

Added in Elementi 2021.

The "Send to cloud" button can be used to publish an Elementi project to an ARYA Enterprise cloud account. For that, follow these steps:

Send to cloud publishing
Send to cloud publishing
Send to cloud publishing (full)
Send to cloud publishing (full)
  1. Go to the Browse panel.
  2. Select a project (or double-click to open it).
  3. Click on the Send to cloud button.
  4. If you haven't logged in before, you need to provide the email and password of an ARYA Enterprise account.
    • You can click the "Stay logged in on this computer" option for faster publish.
    • If you need to log out from an ARYA account, go to Menu > Help > Cloud Account... option from the toolbar and click the "Logout" button.
    • Note that ARYA users created with a social login (Google, Facebook) cannot be used for logging into an ARYA Enterprise account from Elementi.
  5. The "Send to cloud" dialog opens, displaying the list of target accounts where the project will be published to.
    • This list is empty if the project has never been published before and already filled up otherwise. After publishing, Elementi stores (per project) the list of target accounts.
  6. To change the list of accounts, click on the "Add/Remove" button. This will extend the pop-up window.
    • All the user's accounts are shown on the right side list. You can add/remove target accounts using drag & drop or the arrow buttons situated between the two lists.
  7. Click on the "Send to cloud" button.
  8. A dialog opens showing the publishing progress onto the selected targets - wait for the publishing to complete.

Publish Location

Applies to Elementi M and Elementi X.

Publish Location icon
Publish Location icon

The Publish Location feature of Elementi M/X offers the possibility to publish content directly on a web server, thus facilitating content deployment for large setups involving a centralized content server or for those cases when is not possible to push content directly on the players, for instance, due to firewall / NAT usage.

See full article on Publish Location.

Publish screen content

This feature is useful when the publish takes a significant amount of time, during which nothing is displayed on the screen (i.e., black screen). To avoid the black screen, the project being published should contain either an image named publish_screen.png or a layout named publish_screen.

See full article on Publish screen.

Publish using different ports

Applies to Elementi M and Elementi X.

The ports used for publishing are 81 (for HTTP) and 9802 (for secure HTTP). These cannot be changed on the player side - if they are not opened for direct access, then you should publish your project on a web server (Publish Location) and use Pull Mode to retrieve it from there.

Alternatively, you can use port forwarding in your internal network - for instance, port 5555 forwarded to 81. In this case, follow these steps:

  1. Open "Devices" and add a new "Publish Location".
  2. Enter the hostname (e.g., spx-hmp-001d502000b2) or the IP address of the player and specify the port used (i.e., 5555).
  3. If the player is password protected for publishing, then enter the user name and the password.
  4. Save and test that you can publish to the player.

Troubleshooting

Device discovery is not essential for publishing, but if it's not working properly, make sure to check the player's network settings first, as this could also solve your problems with publishing.

If the player is automatically discovered and appears under Devices tab in Browse panel, but you cannot publish onto it, this is usually due to one of the following problems:

  • IP-related: Your player may have a static address that is outside the routing address space on your network. Open Control Center using the local address of the player and set the IP to dynamic or to a static address that you can reach.
  • Port-related: To publish from Elementi, the ports 81 and/or 9802 must be open for outbound communication on your PC, and no firewall or router should be blocking these ports on the player;
  • Proxy settings: Many publishing problems can be resolved by using "No proxy" instead of the default "Use system settings" setting.
  • Antivirus software: If you are using antivirus software, make sure to configure it to fully allow all Elementi operations, for instance, by adding Elementi to the exclusion list.
  • Windows 10 update breaking the player name resolution: Details below.
  • Fusion interface is enabled on HMP200 or lower: Disable Fusion to be able to publish to the device.
Note Notes:

Known issues

Known error message displayed when trying to publish:

  • Device not present
    The target device is currently not available, or its name has changed.
  • Firmware not compatible
    Content created with Elementi usually requires a minimum firmware version on the player, which Elementi checks before publishing ― if lower than the required version, the publishing is stopped and an error message is displayed. The solution is to update the firmware on those devices.
  • Problem detected with target device. Widgets using channels will not work properly. Are you sure you want to continue?
    This happens when trying to publish a project containing data-driven widgets and one or more of the target players have not been added to Cockpit. To solve the issue, open the Control Center and add the player to Cockpit using the same account as the one used to register the Elementi license into Cockpit.
  • Listing device failed
    This error means that Elementi cannot connect to the target device - see below for more details.

Listing device failed

This error means that Elementi cannot connect to the target device - there could be different reasons for that, so click the "Details" button to get more information about the error, like:

  • "Server or proxy hostname lookup failed : '/' -> Could not resolve hostname [...]: The requested name is valid, but no data of the requested type was found"
    This occurs when the player is detected as offline by Elementi or when the Bonjour plugin (responsible for the device name resolution) is deactivated. See also the note below about Windows 10.
  • "Could not connect to server: No connection ... because the target machine actively refused it."
    Starting with firmware 4.3.0, the player default behavior is to allow connections to publish server over secure HTTP only - this error occurs when publishing from an outdated software (older than Elementi 2017) or on a manually added player for which the option "Use HTTPS" is not checked.
  • "Could not connect to server: HTTP PROPFIND [...] Connection refused"
    This could occur when trying to publish on a DSOS player that is managed with SpinetiX ARYA or that doesn't have a Feature Set activated on it.
  • "Could not connect to server" (other messages)
    This can occur when the player has been detected online by Elementi at the time of publishing, but the network connection got lost in the meantime. Make sure that the player is still online and then try again.
  • "HTTP Error: Command PropFind in '/' -> 0: SSL handshake failed ... sslv3 alert handshake failure"
    This can occur when Elementi tries to publish using TLS-SRP on HMP350 and HMP300 devices with firmware 4.3.0 or later, but the user password hasn't been updated on the player to activate SRP. Updating the user password will solve this.
  • "HTTP Error: Command PropFind in '/' -> 0: Server certificate issued for a different hostname, issuer not trusted"
    This can occur when trying to publish from an older version of Elementi onto HMP350 and HMP300 devices with firmware 4.3.0 or later, which only allow connections to the publish server over secure HTTP. The solution is to update Elementi. Or change the server security configuration on the player.
Note Win10 issue:
On certain Windows 10 machines, one of the Windows updates deactivated the Bonjour plugin responsible for the name resolution, and consequently, publishing content from Elementi onto players fails with a "Listing device failed... Could not resolve hostname" error. To fix this, you should check for new updates from Windows and apply them. If the problem persists, then uninstall both Elementi and Bonjour from Control Panel, and then install the latest Elementi version.

See also