App Manager User Guide 4.x

Article last updated:

The zSpace App Manager provides a simple way for you to download, install, and update many of the zSpace applications, content, and demos. By downloading and using zSpace App Manager you agree to the zSpace Programs Master Terms and Conditions.

This article is for the most recent version of App Manager, 4.x. If you are still using the prior release of App Manager, please update App Manager first.


Contents


Legal Notice

Note: zSpace-enabled software applications can be proprietary to zSpace ("zSpace Software") or may be proprietary to a third party ("Third Party Software"). Certain software (and/or content) may be installed on hardware supplied by zSpace ("Embedded Software"). All software is collectively referred to as the "Software." All Software is licensed and not sold. License terms are set forth in a separate license agreement. All zSpace Software may be used only with the zSpace product for which it was supplied and may not be copied or modified. Third Party Software may be subject to license terms provided by the third party accompanying the Third Party Software. Embedded Software may only be used on the hardware with which it was provided. Software license terms and conditions are available at https://zspace.com/downloads.

 

Download and Installation

All zSpace computers ship with App Manager pre-installed. In the case you need to install App Manager or update from versions of App Manager prior to 4.0, please see updating and Installing zSpace Applications.

For complete list of applications supported by zSpace App Manager, all other zSpace supported applications, and where to download them, please see zSpace Software Matrix.

User Guide

Internet connection is required to use App Manager. If you are not connected, App Manager displays the error message: Failed to contact the alias server. You will need to restart App Manager once connected to the Internet.

To launch App Manager

  1. Click on the Windows start button and type App Manager. Click on the App Manager in the search results.
    App Manager requires Administrator rights to install software. If you are prompted, enter the administrator password to continue. If you do not have this password, please reach out to your network IT team.
  2. At startup, App Manager displays status message: Updating. Checking for update. Next, you may see a message stating Checking Applications States where a scan of your system is performed. This process may take up to a minute. Finally, all zSpace applications which can be installed, or are installed, will be shown.

User Interface

Along the top of App Manager are 4 menu options as described below.

Library (default view)

SSN-Library.png

Here, all applications which are supported by zSpace App Manager are displayed. The Library is divided into 3 sections: Available Updates, Available Software, and Installed Software.

Settings

SSN-Settings.png

There are 3 settings options as explained below.

Selecting alternate Channel (source)

App Manager, as of version 3.0.0, supports selecting different channels for downloads. When an alternate channel is selected, the available downloads for that channel will be displayed. The currently available channels are:

For assistance on determining what channel you should use for your zSpace lab, please see Updating your zSpace to 2019.
Some applications and their updates are only available by selecting appropriate channels.
  • zSpace 2019  - The currently released zSpace 2019 version of zSpace applications. Most users should use this version.
  • zSpace Classic - Use this for zSpace 300, zSpace AIO, and zSpace AIO Pro where you are currently using the EDU Server.

Max download speed

App Manager supports the ability to limit download speeds. This setting allows a user to limit or control the speed at which downloads are performed. The default option is Unlimited.

Language

Currently App Manager is supported in the following languages: US English, Chinese Simplified, Turkish, Spanish, and Russian.

Help

The Help menu item links to online resource for App Manager, this article here.

About

The about menu will give you basic information about the App Manager application.

Managing your application library

Updating applications

  1. If not already selected, select the Library menu item.
  2. If there are available updates, click on SSN-UpdateAllButton.png Update All button in the upper right hand corner. This will update all applications which have available updates.
  3. You can also manage individual applications. To do this, there are Update, Uninstall, and Repair options.
    • SSN-UpdateButton.png will update the individual application.
    • SSN-UninstallButton.png will uninstall the individual application.
    • SSN-RepairButton.png will repair an existing installation. Repair checks the files on the system versus what is expected and reinstall any missing or corrupted files. Repair should only be used when an application is not working or directed by zSpace Support. Selecting repair may also check other applications which are dependent on the currently selected application.

Installing applications

  1. If not already selected, select the Library menu item. 
  2. You can manage individual applications. To do this, select the SSN-Install.png  Install button to the right of the application title. Installing an application may also install other applications on which the currently selected application is depends. 

Dependencies

App Manager uses dependencies to group related packages. If you start the install or update of a package that has dependencies, App Manager will install required dependencies automatically.

Uninstall applications

Use the SSN-UninstallButton.png Uninstall button to uninstall applications. When needed, each application must be individually uninstalled.

Optional offline installation

For the current version of App Manager, this feature has been disabled. This feature will be included in future releases of App Manager.

Nightly Updates

A new feature was introduced with App Manager version 3.0. Updates are now automatically done nightly at 2am. These updates are done at a system level, therefore, being logged into the system is not required. Only the last selected repository will be updated.

Tips to take advantage of the nightly update feature:

  • If your computers have been shutoff for a long time such as over a long holiday break, turn on your zSpace and manually run your Windows updates. This will help your system be up to date before the zSpace Nightly Updates run reducing the chance of the updates conflicting with each other.
  • This feature will work with zSpace model 300, AIO, AIO Pro, and zSpace Laptop running Windows 10.
  • All running zSpace applications are closed including App Manager when Nightly Updates start.
  • Nightly update will only run if App Manager is connected to the Internet.
  • For zSpace 300, AIO, and AIO Pro, leave the zSpace powered on. The zSpace will put themselves to sleep after all updates are complete.
  • For zSpace laptops, they must be connected to a power source. They can be left in sleep mode. The laptop will put themselves to sleep after all updates are complete.

This feature can be disabled by:

  1. Click on the Windows Start button and type Task Scheduler. Click on Task Scheduler in the search results.
  2. In the left panel, click Task Scheduler Library and in the center panel browse to the zSpace App Manager Nightly Update.
  3. Right click on zSpace App Manager Nightly Update and select disable.
  4. *Double clicking on zSpace App Manager Nightly Update will allow you make other changes to this task.

The default options for this feature are:

  • Wake computer to run this task.
  • Run daily at 2am.
  • Only run if computer is on AC power.
  • Each time App Manager is updated, these defaults are reset.

Limitations

  • zSpace AIO needs to be on BIOS ASP_0240.23 to wake properly from sleep. Your BIOS version can be checked using zSpace Configuration Check.
  • zSpace 300 needs to have allow wake timers set to enable. This can be done by:
    • Click the Windows start button and type Edit power plan. Click on the search result to open. 
    • Click on Change advanced power settings.
    • Click and expand Sleep -> Allow wake timers. Set allow wake timers to Enable

Command Line Interface (CLI) and App Manager IT guide

From a Command Prompt window you can enter App Manager CLI arguments. For more on this, please see the App Manager IT guide.

Troubleshooting

When launching zSpace App Manager, you see the following error message "Checking for update Failed to contact the alias service Read operation No DNS entry found for host".

mceclip0.png

This is caused by App Manager not being able to connect to our data servers. To resolve this:

  1. Check to make sure you have an active Internet Connection. 
  2. Review the required URLs for App Manager. Working with your IT group, verify the proper URLs are accessible. 

When launching zSpace App Manager you see an error message "Failed to access remote metafile Read operation JSON error", can be resolved by the following.

AppManagerLaunch.png

  1. Launch Internet Explorer.
  2. Go to www.microsoft.com.
  3. Close Internet explorer and launch App Manager again.

When installing or updating files, you may notice values before the installation progress bar. The left most value is the total file contents remaining to be downloaded or read. The remote read speed (middle value) is the current download speed. When performing an update, old content will not be downloaded again and will only be scanned for correctness. In this case, the local read speed (right most value) is the speed in which previously downloaded content is scanned.

Page-6-Image-8.png

Release Notes

Current release notes for App Manager can be found here

Complete archive release notes can be found here.

Known Issues

  • To update to App Manager 4.0.4.1 and above, you must already be on App Manager 3.1.x installed. To first update to App Manager 3.1.x, please see Updating and Installing zSpace Applications.
  • To install zCentral, Windows .NET framework 4.7.1 is required. This can be installed by following Microsoft's directions here: https://www.microsoft.com/en-us/download/details.aspx?id=56115
  • Offline Installation is not currently available. This will be added in a future release of App Manager.
  • Applications which were installed with earlier versions of App Manager which are no longer available cannot be uninstalled. 
Have more questions? Submit a request

Comments