Publish

From SpinetiX Support Wiki

Jump to: navigation, search

This page is about publishing from Elementi / HMD. For the "publish action", see the Pull mode page.

Introduction

Publishing from Elementi / HMD refers to an optimized process of sending content (i.e. a project) created with Elementi / HMD to any combination of the following:

The publish is done via the WebDAV protocol (on port 81) and 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!
    • 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.


Note Notes:
  • 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.
  • It is not possible to publish multiple projects in the same time. Furthermore, only a single project can exists on the HMP at any given time.
  • The publish fails when Fusion mode is enabled on HMP.
  • Interrupting a publishing event might have unpredictable results.

Publishing from Elementi

Publish dialog
Add/Remove Publish target

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, collection of devices and Publish Locations (i.e. WebDAV-enabled servers).
  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. A new dialog opens, showing the progress of the publish on the selected targets.
    • Content created with Elementi requires firmware version 3.x on the HMP - when publishing, Elementi checks the HMP firmware and stops the publishing if that is lower than version 3.0.0!
    • Content created with Elementi 2015 requires firmware version 3.2.x on the HMP - when publishing, Elementi 2015 checks the HMP firmware and stops the publishing if that is lower than version 3.2.0!


Note Note:
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. To avoid this, refer to Publish screen article.

Video tutorial

Publishing from HMD

The publish process is described in detail in the "Publish" section of the HMD User Manual.

When using the publish process, a dialog is opened to indicate the progress of the operation.

Manual publish

  • Open My Devices in a first tab. Identify the HMP on which you want to publish.
  • Open My Projects in a second tab.
  • Drag and drop the project you want to copy to the device you want to update.
    Hovering over the My Devices tab while the mouse button is held down will cause the tab to be opened.

Quick publish

  • Once a project has been published manually to device, it can be published again using the quick publish button

Publishing on multiple devices

It is possible to publish the same Project to a group of devices in a single operation. This can be used for Synchronized content for instance.

  • Go to "My devices" in your "Workspace"
  • Create a "New collection"
  • Find the HMPs where you want to publish your project to, and move them into the newly created folder
  • Drag and drop the project onto the collection of devices
  • A dialogue will open indicating the status of the publish on all devices

Shared project

If you have HMD Professional, you can create a shared project to manage the content from the WebDAV server directly from HMD. You can then publish any local Project directly on the WebDAV server using HMD.

Here is an example to create a shared project using MyDrive server:

  • Open HMD and go to My Devices.
  • Using the right-click menu, select New Shared Project and enter:
    • Host name: webdav.mydrive.ch;
    • Path to folder : MyProjectName;
    • Type: Shared Project;
    • User name and Password.
Once you press OK, you may see a warning "Invalid collection type". This means that the folder was not created by HMD. You can safely answer yes to the question.
  • To publish your project onto the WebDAV server
    • Drag and drop the project onto the shared project.

Troubleshooting publishing

  • If the HMP is discovered automatically and appears under "Devices" view in Elementi / "My Devices" in HMD, but you cannot publish onto it, this is usually due to one of following problems:
    • Port-related: To publish from Elementi / HMD, port 81 must be open for outbound communication on your PC and no firewall or router should be blocking port 81 on the HMP;
    • 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.
    • Anti-virus software: If you are using an anti-virus software, make sure to configure it to fully allow all Elementi / HMD operations, for instance by adding Elementi / HMD on the exclusion list.
  • Device discovery is not essential for publishing but if it's not working properly, check Networking settings first as this could also solve your problems with publishing.
  • Many publishing problems can be resolved by correcting your Proxy settings.
  • If the screen remains blank or black with a blinking rectangle after publishing, then check that the index.svg file is spelled correctly and all in lower-case.

Elementi issues

  • Firmware not compatible
    Content created with Elementi requires at least firmware version 3.0.0 on the target HMP device(s) - when publishing, Elementi checks the HMP firmware and returns this error if that is lower. Furthermore, some widgets added within later versions of Elementi might require even a newer firmware version, for instance, the graph widgets added within Elementi 3.1 require firmware 3.1.0 on the HMP.
  • Listing device failed
    This error means that Elementi cannot connect to the target device. There could be different reasons for this error - clicking on the "Details" button opens the error details dialog with additional details 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 target device has been detected as offline by Elementi.
    • "Could not connect to server" - this occurs when the target device has been detected online by Elementi, but lost the network connection in the meantime.
  • Device not present
    The target device is currently not available, or its name changed.

HMD issues

  • Dragging and dropping onto a device does not trigger the publish. This is because you are dropping a collection (folder), not a project. Make sure that the content you are dropping is a project by right-clicking on it and selecting Set Type > HMPxxx project.
  • Error message: "Removal of resource files/ failed: Bad request : Command: WebDAV [...]" or any "Removal of resource [...] 403" error - you have Fusion mode enabled on the device. Disable Fusion before publishing.
  • Error message: "[...] XML parse error at line [...]" - the firmware on the device is corrupted. Follow the instructions under Firmware to reinstall via the Recovery console.
  • Error message: "This version of Hyper Media Director can only manage local resources. You must upgrade to the PRO version in order to enable publication on shared project" - you are trying to publish to a shared project or WebDAV server from HMD Lite. If you are publishing on an HMP device, the the firmware on that device is not recognized by your current version of HMD and you need to update it.
This page was last modified on 2 December 2016, at 12:47.