Publish

From SpinetiX Support Wiki

(Redirected from Publishing)
Jump to: navigation, search

This page is about direct publishing from Elementi. For HMD, see Publish from HMD. For indirect publishing from a server, see the Content pull page.

Introduction

Publishing content from Elementi refers to an optimized process of copying a project to a list of target devices - usually one or more HMP devices. The list of target devices can also contain USB storage devices and Publish Locations (i.e. web servers).

The publish 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 exists on the HMP at any given time, therefore it is not possible to publish more than one project in the same time.
  • Publishing to an HMP is recommended over uploading the content directly to the HMP because when a slightly modified project is (re)published, only the differences will actually be copied to 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 Caching page for more details. .
  • The publish is done via the WebDAV protocol on port 81 or 9802 for secure publishing.
  • Starting with Elementi 2018, secured publishing using TLS-SRP is activated by default for HMP350 and HMP300 devices discovered automatically. That might require an update of the user password to activate SRP.

Tutorial


Publish dialog
Add/Remove Publish targets

To publish a project using Elementi follow these steps:

  1. Go to the Browse panel.
  2. Select a project (or double-click to open it). The "Publish" button becomes active.
  3. Click on the "Publish" button.
  4. 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 already filled up otherwise. After a publish, Elementi stores (per project) the list of target devices.
    • The following can be target devices: HMP, USB storage drives, collections, and Publish Locations.
  5. To change the list of devices, click on the "Add/Remove" button. This will extend the pop-up window.
    • All the devices are showed on the right side list. You can add / remove target devices using drag & drop or the arrow buttons situated between the two lists.
  6. Click on the "Publish" button.
  7. A dialog opens showing the publishing progress onto the selected targets - wait for the publish to complete.
Note Notes:
  • Interrupting a publishing event might have unpredictable results - republish the project if that happens.
  • A publish action that takes a significant amount of time could potentially lead to nothing being displayed on the screen (i.e. black screen) during this period - this can be avoided by using a temporary publish screen.
  • Content created with Elementi usually require a minimum firmware version on the HMP - during publish, Elementi checks the target HMP firmware and if that is lower than the required version, then the publish is stopped and an appropriate error message is displayed.

Publish screen

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 Location

Applies to Elementi M and Elementi X.

Publish Location icon

The Publish Location feature of Elementi M / X offers the possibility to publish content directly on a content 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 HMP (for instance, due to firewall / NAT usage).

See full article on Publish Location.

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 HMP side - if they are not opened for direct access, then should use a 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 HMP 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 HMP is automatically discovered and appears under Devices tab in Browse panel, but you cannot publish onto it, this is usually due to one of following problems:

  • IP-related : Your HMP may have a static address which is outside the routing address space on your network. Open HMP 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 HMP;
  • Proxy settings : Many publishing problems can be resolved by using "No proxy" instead of the default "Use system settings" setting.
  • Anti-virus software : If you are using an anti-virus software, make sure to configure it to fully allow all Elementi operations, for instance by adding Elementi on 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 changed.
  • Firmware not compatible
    Content created with Elementi usually require a minimum firmware version on the HMP - during publish, Elementi checks the target HMP firmware and, if that is lower than the required version, then the publish is stopped and this error message is displayed. The solution is to update the firmware on those devices.
  • Listing device failed
    This error means that Elementi cannot connect to the target device - click the "Details" button for 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 with 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 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" (other messages)
      This can occur when the player has been detected online by Elementi at the publish time, 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.


Note Win10 issue:
On certain Windows 10 machines, one of the Windows updates deactivated the Bonjour plugin responsible with 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 reinstall Elementi.

See also

This page was last modified on 12 March 2019, at 18:03.