Skip to end of banner
Go to start of banner

WinGet Automated Installation of GTP Software

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

User Installation via WinGet

Installation/update of GTP software is handled using the WinGet Package Manager. A user with Admin rights can install individual apps and optionally install an AutoUpdate task.

  1. Uninstall all GTP (Required) - Uninstall all GTP software prior to version 6.3.1 under:

    1. Windows Add Remove Programs.

    2. or the Apps > Apps & features > App list page.

  2. Open a Command Prompt and Run As Administrator (Required) - All GTP software is installed via WinGet using the Windows Command Prompt.

    1. On the computer search for command prompt then select the Run as administrator option.

  3. Install GTP Source (Required) - Skip this step only if GTP software has been previously installed on the computer using WinGet.

    1. In the command prompt copy/paste the following and then press enter:
      WinGet source add -n GTPSoftware -a https://WinGet.gtp.one/d1588e01-761c-48ff-b102-2776fc4f8ec5 -t "Microsoft.Rest"

      1. GTP WinGet source is now registered on the PC.

    2. If the following message “WinGet is not recognized as an internal or external command” displays, see the Install Winget for Windows section below.

    3. If GTP Source has already been registered on the computer, a message similar to the following “A source with the given name already exists…” will display. This message can be ignored. Move on to Install Software.

  4. Install Software - For the software you want to install on each computer, copy/paste the install command (highlighted in gray starting with WinGet). Once pasted, press enter and the command will run and install. No further action is need until the installation is complete. If the Successfully Installed message does not display, contact the STRATUS Service Desk.  See the GTP STRATUS Addin for and example.

    1. GTP Lightning
      WinGet install GTPSoftware.Lightning -s GTPSoftware

    2. GTP Print
      WinGet install GTPSoftware.Print -s GTPSoftware

    3. GTP STRATUS Addin
      WinGet install GTPSoftware.AddIn -s GTPSoftware
      Example:


      Success!

      Error. If you get an error running this step, see the section below on what to do next.

    4. GTP Workstation
      WinGet install GTPSoftware.Workstation -s GTPSoftware

    5. GTP WireWorks (not yet released - install won’t work)
      WinGet install GTPSoftware.WireWorks -s GTPSoftware

    6. GTP SchematicViewer (not yet released - install won’t work)
      WinGet install GTPSoftware.SchematicViewer -s GTPSoftware

  5. AutoUpdate (Optional-Recommended)

    1. The AutoUpdate task will check for updates of all installed GTP Software:

      1. at 1am local time

      2. when a user logs in

      3. Note: This is the same method used by MS Edge.

      4. Note: Other package managers such as Homebrew or Chocolatey can be supported in the future depending on demand.

    2. Enable AutoUpdate - In order to enable automatic-updates install the following via copy/paste into the Command Prompt:
      WinGet install GTPSoftware.AutoUpdate -s GTPSoftware

    3. Disable AutoUpdate - To disable automatic updates after AutoUpdate has been installed (Enable AutoUpdate above), uninstall this process with the following via copy/paste into the Command Prompt:
      WinGet uninstall GTPSoftware.AutoUpdate

  6. Remove Tasks (Optional) - This step can be done anytime and will not impact the AutoUpdate. To cleanup tasks if any GTP Software version was installed prior to v6.3.1 you’ll can manually remove all Tasks from the items from the Windows Task Scheduler that have GTP or STRATUS in the name.

    1. Using Windows search, enter Task Scheduler and open the Task Scheduler App.

    2. Delete all Tasks - Delete all Tasks that have GTP or STRATUS in the name.

Company Installation

For companies who do not want to install GTP Applications using the AutoUpdate feature, they can choose to either:

  1. Manually install GTP Software and updates

  2. Or use an MDM tool such as KACE, MaaS360, InTune, etc.

    1. Note: Installation/update of GTP software using this method is supported via .msi installers.

  3. A historical log of the msi based installers for GTP Applications can be found at the link below. Also use this link to download GTP Applications when there is a mandatory update. See the Release History article for more information.

Version Compatibility 

Version compatibility between major/minor releases for the STRATUS web site and GTP Apps is provided. For example if you have version 6.1.x of the Addin installed it will remain compatible with any 6.1.x version of the STRATUS Web site. However if we a fix is released in the Addin, the Addin would need to be installed in order to receive the fix. These fixes are noted in the release notes. When the STRATUS web site is updated to a newer major/minor version the all apps have to be updated to that same version before they can be used.

WinGet Tools

Install WinGet for Windows

For older Windows versions, the WinGet command may not be found and the WinGet source cannot be registered on the PC. In this case, the following message will display.

To install WinGet, following the instructions in this Microsoft article. https://learn.microsoft.com/en-us/windows/package-manager/winget/

Note: The instructions note that installing WinGet is done via Windows PowerShell.

To open Windows PowerShell

  1. On the pc search for and open PowerShell.

  2. The PowerShell app will display.

  3. Copy/paste the command from the instructions (below) and then press enter.
    Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe

  4. WinGet is now installed.

Search for Available GTP Software Versions

To search for available GTP software versions.

  1. On the pc search for command prompt then select the Run as administrator option.

  2. Copy/paste the following into the Command Prompt:
    winget search -q "GTP" -s GTPSoftware

  3. A list of available software similar to the following will display.

Install a Specific GTP Software Version

To install a specific software version:

  1. Search for available software versions to identify the ID and Version. See the Search for Available Software Versions section above.

  2. On the pc search for command prompt then select the Run as administrator option.

  3. Copy/paste a command similar to the following into the Command Prompt substituting the ID determined in the search for GTPSoftware.Print and the Version number for 6.3.1174.
    WinGet install GTPSoftware.Print -v 6.3.1174 -s GTPSoftware

What if The Installer Failed with Error Code 1603?

image-20240122-202028.png

In the event that this happens, you can replace the word “install” with “show”. E.g., if Autoupdate isn’t installing, run this command:

winget show GTPSoftware.Autoupdate -s GTPSoftware

And this generated an Installer Url hyperlink to an msi file, as below:

image-20240122-202432.png

The “Installer Url:” is a link to a working MSI installer that does NOT depend upon winget.

What If the Program I Install Will Not Login to STRATUS?

If, after an install, you run one of the apps that requires a login (this can be the Revit addin, the AutoCad addin, etc., the Workstation App, the Printer App,..), and if you get a message like this

image-20240202-183844.png

At this point, it is likely a WebView2 installer issue.

We automatically install WebView2 with our software: https://developer.microsoft.com/en-us/microsoft-edge/webview2/ However, in the event of the above error, consider going into Windows Add/Remove programs, and search for WebView2, and then “Modify” the installation to perform a repair.

  • No labels

© Copyright 2022 GTP Services, LLC All rights reserved. | About | Contact