decimal App Documentation

User Tools

Site Tools

Trace:
decimalauncher:decimallauncher

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
decimalauncher:decimallauncher [2022/04/05 14:12] – [Installation] dpatenaudedecimalauncher:decimallauncher [2025/02/28 14:27] (current) – [Hotfix for March 2023] decimal
Line 14: Line 14:
   * Allow installation and updates of applications   * Allow installation and updates of applications
   * Verify the authenticity of all applications before opening   * Verify the authenticity of all applications before opening
 +
 +==== Version History ====
 +
 +Please refer to the [[decimalauncher:versions|decimal Launcher version history]] for the complete listing of all versions and release notes.
  
 ===== Installation ===== ===== Installation =====
Line 29: Line 33:
 ==== All User Installation ==== ==== All User Installation ====
  
-If it's desired to install the application for all users, IT departments may install the software for a single user and then manually copy and push the application directory and desktop/start menu shortcuts out to users on each computer.  +If it's desired to install the application for all users, IT departments may install the software for a single user and then manually copy and push the application directory and desktop/start menu shortcuts out to users on each computer.
- +
-**Note:** The single user installation is the preferred installation method. The all user installation provides a way to push out the application to all users on a work station, but the next time the application pulls an update it will be installed locally for the current user that installed the update. +
- +
-  - Install the decimal Launcher for a single user +
-  - Copy the installation directory (C:\Users\<User>\AppData\Local\Programs\decimal Launcher) and manually push this directory to each user folder or a shared user folder +
-  - Create a shortcut to the decimal Launcher.exe file in each user's start menu and/or desktop. Ensure this shortcut is labeled 'decimal Launcher'. +
-    - In the event the decimal Launcher needs to pull and install a new update, the update will be installed to the current user's AppData folder (C:\Users\<User>\AppData\Local\Programs\decimal Launcher) and not the manually placed decimal Launcher folder. Any existing application shortcuts in the start menu or desktop titled 'decimal Launcher' will be replaced. Note: the existing shortcuts that point to the manually placed launcher folder will only be replaced with shortcuts that point to the user's AppData folder if the original shortcuts were named 'decimal Launcher'.+
  
 <WRAP center round important 70%> <WRAP center round important 70%>
-**Note:** \\+**Permission Note for All User Installation:** \\
 The decimal Launcher application may require occasional updates. These updates are not optional and will prevent the user from using the Launcher and any software it manages until the update is performed. Therefore, it is strongly recommended to push out Launcher installs to folders that end users have write access to so that updates can be automatically performed without requiring IT intervention and delaying user software access. The decimal Launcher application may require occasional updates. These updates are not optional and will prevent the user from using the Launcher and any software it manages until the update is performed. Therefore, it is strongly recommended to push out Launcher installs to folders that end users have write access to so that updates can be automatically performed without requiring IT intervention and delaying user software access.
 </WRAP> </WRAP>
-  
  
-The same process can be used to install the software for centralized or Citrix systems.+=== Notes Regarding All User Installation === 
 + 
 +  - **The single user installation is the preferred installation method.** The all user installation provides a way to push out the application to all users on a work station, but the next time the application pulls an update it will be installed locally for the current user that installed the update. .decimal does not recommend the all user installation option and this may cause problems depending on your hospital/workstation security. 
 +  - **Users will be required to re-download each application as application downloads are saved to the currently logged in Windows user folder.** Application downloads should be small and fast from .decimal's servers. Most of .decimal's customer applications (e.g.: p.d) allow editing the application's settings to point to a shared centralized patient database. 
 +  - **In the event the decimal Launcher needs to pull and install a new update, the update will be installed to the current user's AppData folder** (C:\Users\<User>\AppData\Local\Programs\decimal Launcher) and not the manually placed decimal Launcher folder. Any existing application shortcuts in the start menu or desktop titled 'decimal Launcher' will be replaced. Note: the existing shortcuts that point to the manually placed launcher folder will only be replaced with shortcuts that point to the user's AppData folder if the original shortcuts were named 'decimal Launcher'. 
 + 
 +=== Installation Process === 
 + 
 +  - Install the decimal Launcher for a single user 
 +  - Copy the installation directory (C:\Users\<User>\AppData\Local\Programs\decimal Launcher) and manually push this directory to each user folder or a shared/public user folder 
 +  - Create a shortcut to the decimal Launcher.exe file in each user's start menu and/or desktop. Ensure this shortcut is labeled 'decimal Launcher'. This shortcut naming is required per Note #3 above under the "Notes Regarding All User Installation". 
  
 ===== Authentication ===== ===== Authentication =====
Line 74: Line 81:
 ===== Installing Applications ===== ===== Installing Applications =====
 ==== Downloading applications ==== ==== Downloading applications ====
-The primary function of the Launcher is to download .decimal applications. After logging into the Launcher and selections a site you will be presented with the applications available for that site. After selecting an app if you do not have it installed then the Launcher will have a "Download" button available.+The primary function of the Launcher is to download .decimal applications. After logging into the Launcher and selecting a site you will be presented with the applications available for that site. After selecting an app if you do not have it installed then the Launcher will have a "Download" button available.
  
-Pressing the “download” button will download the version of the app that is listed. After downloading or if you have the app already installed the button will change to a “Launch” button. The application is now ready to opened and used as normal.+Pressing the “download” button will download the version of the app that is listed. After downloading or if you have the app already installed the button will change to a “Launch” button. The application is now ready to be opened and used as normal.
  
 <imgcaption downloading_apps|Downloading Applications> <imgcaption downloading_apps|Downloading Applications>
Line 104: Line 111:
 The decimal Launcher provides a “Sandbox” area to install new versions of applications in order to test them before Clinical release. This area is separate from all of your Clinical applications so they will not affect any patient data. The decimal Launcher provides a “Sandbox” area to install new versions of applications in order to test them before Clinical release. This area is separate from all of your Clinical applications so they will not affect any patient data.
  
-NOTE: This option will only appear for users with elevated “Physics” or higher permissions on their decimal account.+NOTE: This option will only appear for users with the user level 'Elevated' (for Physics access) on their decimal account.
  
 ==== Setting the Sandbox App Version ==== ==== Setting the Sandbox App Version ====
Line 134: Line 141:
   * **Inactivity Timeout:**   * **Inactivity Timeout:**
     * The application inactivity timeout is set to 10 minutes by default. If the user performs no keyboard/mouse interactions within the application within that time period they will be automatically logged out and required to re-authenticate      * The application inactivity timeout is set to 10 minutes by default. If the user performs no keyboard/mouse interactions within the application within that time period they will be automatically logged out and required to re-authenticate 
-    * **NOTE:** This value can be changed in the App settings+    * **NOTE:** This value can be changed in the [[decimalauncher:decimallauncher#app_settings|App settings]]
   * **Session Timeout:**   * **Session Timeout:**
     * Once a user logs in using [[https://auth0.com/|Auth0]] the user's authentication session token is valid for 10 hours. After which they will be required to login and re-authenticate to the decimal Launcher. Any applications launched from the decimal Launcher that are using this token will need to be relaunched once the user has re-authenticated in the decimal Launcher     * Once a user logs in using [[https://auth0.com/|Auth0]] the user's authentication session token is valid for 10 hours. After which they will be required to login and re-authenticate to the decimal Launcher. Any applications launched from the decimal Launcher that are using this token will need to be relaunched once the user has re-authenticated in the decimal Launcher
Line 164: Line 171:
  
 Make sure to "SAVE" your changes once you are done to ensure you do not lose them. Make sure to "SAVE" your changes once you are done to ensure you do not lose them.
-<imgcaption app_settings|Edit App Settings>{{ 2022-04-05_10_01_37-.decimal_launcher.png?direct&400 |}}</imgcaption>+<imgcaption app_settings|Edit App Settings>{{ 2022-04-05_10_01_37-.decimal_launcher.png?direct |}}</imgcaption>
  
-NOTE: Your setting are saved locally to the "Launcher-settings.json" file in "C:\Users\<YOUR USER>\AppData\Local\dotdecimal\decimalLauncher\". 
-It is possible to edit this file to change the values for each setting but it is not recommended. If you change a setting to value that would break the application (ie: setting the Timeout to 0 or a negative value) that setting will be reset to the default again.  
 ---- ----
  
Line 174: Line 179:
 For questions, comments, support requests, bug reporting, or to schedule a training session, please contact our customer support team at: For questions, comments, support requests, bug reporting, or to schedule a training session, please contact our customer support team at:
  1-800-255-1613  1-800-255-1613
 +
 +==== Common Technical Issues ====
 +
 +This section details a few very common errors and resolutions end users can experience while using the decimal Launcher. If you experience an issue not on this list or have questions please contact .decimal customer support.
 +
 +=== Hidden Text Error for February 2025 ===
 +
 +<WRAP center round important 60%>
 +**February 2025 Launcher Login Hidden Text Error**:\\
 +Please see the section below for resolving login issues where text does not appear while typing in the decimal Launcher application.
 +</WRAP>
 +
 +
 +On February 28th, 2025 .decimal's cloud authentication provider performed maintenance on their services. This resulted in the decimal Launcher having a minor display error, where the placeholder text "Email Address" and "Password" does not shrink away while typing as shown below. Please note that this issue is only a display error and the text you are typing is properly being entered into the application. So the decimal Launcher Application can continue to be used as normal, you just will not be able to see the first 14 characters typed in the email or password fields. 
 +
 +{{ :decimalauncher:launcher_error_feb2025.png?650 |}}
 +
 +We are working on a fix to correct the issue and the Launcher Application will automatically update when this fix is released. No further action is needed at this time, you may simply continue to use the Launcher application normally.
 +Sorry for any inconvenience. If you have any questions please contact .decimal Customer Support at E-Mail: customersupport@dotdecimal.com or Phone: 1.800.255.1613.
 +
 +=== Request Failed (401) ===
 +
 +{{ :decimalauncher:2022-08-31_09_39_45-.decimal_launcher.png?400 |}}
 +
 +  * **Error:** Request failed with status code 401
 +  * **Explanation:** The user authentication token sent to .decimal servers is incorrect. This is typically due to Web Security Appliances (WSAs) intercepting/inspecting our HTTPS traffic on the hospital's network, which can change the authentication request headers.
 +  * **Solution:**
 +    * Follow the [[support:it_troubleshooting#common_issues_and_resolutions|IT Support Common Issues and Troubleshooting Steps]] guide for WSAs and unrestricting .decimal HTTPS traffic.
 +    * Note: If your IT department has applied any security updates to whitelist .decimal servers, this //may// required users to logout and re-login or reboot the workstation to apply the new policy updates. This step is entirely dependent on your clinic's IT security setup and policies and how those policies have been implemented. For assistance please contact your IT department.
 +
  
 ---- ----
Line 183: Line 218:
 ==== Minimum System Requirements ==== ==== Minimum System Requirements ====
  
-| Operating System | 64-bit Windows 10 |+| Operating System | 64-bit Windows 10/11 |
 | Processor        | Dual Core 2.2+ GHz Intel or equivalent processor  | | Processor        | Dual Core 2.2+ GHz Intel or equivalent processor  |
 | Memory           | 4 GB RAM | | Memory           | 4 GB RAM |
Line 192: Line 227:
 | Permissions      | Local user install permissions (non-admin) | | Permissions      | Local user install permissions (non-admin) |
  
-**Note: decimal Launcher is a lightweight [[https://www.electronjs.org/|ElectronJS]] application and does not require moderate hardware resources. But the applications it installs and manages could require much more substantial resources. Refer to each app's individual userguide for it's specific hardware system requirements.**+**Note: decimal Launcher is a lightweight [[https://www.electronjs.org/|ElectronJS]] application and does not require moderate hardware resources. But the applications it installs and manages could require much more substantial resources. Refer to each app's individual userguide for its specific hardware system requirements.**
  
  
Line 205: Line 240:
 ^ Server URL ^ Port  ^ ^ Server URL ^ Port  ^
 | direct.dotdecimal.com (64.128.252.104) | 443 | | direct.dotdecimal.com (64.128.252.104) | 443 |
 +| auth.dotdecimal.com | 443 |
 +| auth0.com | 443 |
 | [[https://auth0.com/docs/guides/ip-whitelist|Auth0 IPs]] (Login Authentication) | 443 | | [[https://auth0.com/docs/guides/ip-whitelist|Auth0 IPs]] (Login Authentication) | 443 |
 | [[https://www.microsoft.com/en-us/download/details.aspx?id=56519|Azure EastUS IPs]] (Azure Blob Storage) | 443 | | [[https://www.microsoft.com/en-us/download/details.aspx?id=56519|Azure EastUS IPs]] (Azure Blob Storage) | 443 |
Line 211: Line 248:
  
 ---- ----
 +<WRAP center 10%>//USR-018//</WRAP>
 +
 ;#; ;#;
-//Copyright © 2020 .decimal, LLC. +//Copyright © 2020-2024 .decimal, LLC. 
 All Rights Reserved.// \\ All Rights Reserved.// \\
 .decimal, LLC. 121 Central Park Place, Sanford, FL 32771. 1-800-255-1613 .decimal, LLC. 121 Central Park Place, Sanford, FL 32771. 1-800-255-1613
 ;#; ;#;
  
decimalauncher/decimallauncher.1649167956.txt.gz · Last modified: 2022/04/05 14:12 by dpatenaude