Application Manager Installation Powered by Vertiv ========================================================== The Application Manager provides an easy way to add and remove software to a Windows system that supports the system requirements described below. This software includes platform components and applications such as Power Insight Manager and ShutDown Manager. -------------------------------------------------------------------------------------------- System Requirements -------------------------------------------------------------------------------------------- Hardware Component Description ----------- ----------------------------------------- CPU 2 CPUs - 2.0 GHz Memory 4 GB (minimum) Disk 5 GB free disk space before installation Software Component Description ------------------- ---------------------------------------------------------------------- Operating Systems Microsoft Windows (64 bit) 7, 8.1 and 10 Microsoft Windows (64-bit) Server 2012 Browsers Google Chrome 46 or higher for both desktop and mobile devices Safari Mobile 9 or higher for mobile devices Internet Explorer 11 or higher for desktops Mozilla FireFox 42 or higher for desktops -------------------------------------------------------------------------------------------- Installing Application Manager -------------------------------------------------------------------------------------------- This section describes the procedure to perform a clean installation of the Application Manager on a Windows machine. Assumptions ----------- - The Windows user must have administrative privileges. If the user does not administrative privileges, the Windows operating system will ask the user to allow the TAF installer to run. - The ZIP installation package for the Application Manager has been unzipped to a temporary local folder. Steps To Follow --------------- 1. Double click on the Application Manager executable (e.g., trellisappmgrinstaller.exe) and follow on-screen instructions until the Application Manager has been successfully installed. Note: Any ports provided during the installation must be unblocked. 2. From a browser window, enter the following address and follow on-screen instructions: https://localhost:<SERVICE_PORT> where <SERVICE_PORT> is the service port number (e.g., 8443) as shown in the example below: https://localhost:8443 -------------------------------------------------------------------------------------------- Removing Application Manager -------------------------------------------------------------------------------------------- This section describes the procedure to remove the Application Manager on a Windows machine. Steps to Follow --------------- 1. Access the "Control Panel" and select "Programs and Features" to access the list of programs installed on the Windows machine. 2. Find the "Application Manager"` program, and click on the "Uninstall"" button to remove the Application Manager. If you have any issues during the removal of the software, please refer to the Troubleshooting section of this document. -------------------------------------------------------------------------------------------- Silent Installation -------------------------------------------------------------------------------------------- The Application Manager can be installed in silent mode, which requires no user interaction. The user must provide install configuration to allow the Application Manager to be installed in silent mode. The Application Manager installer ZIP file provides a sample file "silentsample.txt" that contains DEFAULT settings for the Application Manager installer. This file MUST be customized by the user as needed. Steps To Follow --------------- 1. Make a copy of the sample file "silentsample.txt" to another file called "installer.properties". 2. Modify the default settings for the Application Manager as needed. Note: Any ports provided in the install configuration file must be unblocked. 3. Open a DOS Command window and run the following command: trellisappmgrinstaller The Application Manager will use the settings in the "installer.properties" file and run in silent mode. -------------------------------------------------------------------------------------------- Troubleshooting -------------------------------------------------------------------------------------------- Uninstalling Software --------------------- Sometimes, the removal of the Application Manager fails and there are additional steps needed to cleanup the system as described below. Steps To Follow --------------- 1. Make sure the user can view hidden files and folders. - Click on the Windows logo at the left bottom corner on the task bar and enter "hidden" on the search text box and then click on the "Show Hidden Files and Folders" link. - Make sure that the "Show hidden file, folder and drives" option is enabled. 2. Remove the install folder that was created by the Application Manager. C:\Program Files\Trellis Application Manager 3. Remove the data folder that was created by the Application Manager. C:\Users\Default\AppData\Local\Trellis Application Manager 4. Remove the registry folder that was created by the Application Manager. C:\Program Files\Zero G Registry Upgrading Windows 10 -------------------- During an automatic update of Windows 10 while the Application Manager is running, the default data folder "C:\Users\Default" used by the PostgreSQL service is being overwritten by "C:\Users\Default.migrated". Follow these steps to resolve this issue: Steps To Follow --------------- 1. Login as a Windows user with administrative privileges. 2. Click the Start button at the bottom left corner and type "Regedit" to access the Windows Registry. 3. Navigate to the "\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\postgresql-x64-9.5" registry entry. 4. Double click on the "ImagePath" key, and make sure the default data folder used by the PostgreSQL service points to "C:\Users\Default" as shown in the example below: "C:\Program Files\Trellis Application Manager\postgreSQL\bin\pg_ctl.exe" runservice -N "postgresql-x64-9.5" -D "C:\Users\Default\AppData\Local\Trellis Application Manager\postgresdata" -w (Optional) You can restart the machine, which will restart the PostgreSQL and services, and then skip the steps below. 5. Open a Windows Explorer window, type "Control Panel\All Control Panel Items\Administrative Tools", click the <ENTER> key, open the Services application, and sort the list of services by Name. 6. Restart the "postgresql-x64-9.5 - PostgreSQL Server 9.5" service. 7. Restart the "Intelligence Engine MSS Engine" service. 8. Restart the "Application Framework Database" service.