Installation Guide AT&T Integrated Dispatch Console 3.0 October 2016
Table of Content 1. Introduction... 3 1.1. Purpose and Scope... 3 1.2. Terms and Definitions... 3 1.3. About this Manual... 5 1.4. What s New in this Release?... 6 2. Hardware and Software Prerequisites... 9 2.1. Hardware Requirements... 9 2.2. Software Requirements... 9 2.3. Network Requirements and Settings... 11 2.4. Application Checklist... 12 3. Installing Integrated Dispatch Console... 11 4. Uninstallation Process... 21 4.1. Uninstalling Integrated Dispatch Console from the Start Menu... 21 4.2. Uninstalling Integrated Dispatch Console from the Control Panel... 23 5. Upgrading Integrated Dispatch Console... 26 5.1. Integrated Dispatch Console Support Ending Notification... 27 5.2. Integrated Dispatch Console Deny Notification... 30 6. Troubleshooting... 34
1. Introduction Integrated Dispatch Console is a feature rich windows-based application that enables organizations to effectively manage daily dispatch operations. Integrated Dispatch Console provides PTT calling, location, alerts, and indicates presence through an intuitive user interface. Integrated Dispatch Console allows a dispatcher to operate from a centralized corporate facility and manage the activities for a set of mobile users (also called fleet members) working in the field. This enables an organization to effectively manage the day to day dispatch operations and rapidly respond to incidents, urgent situations, customer requests, facility events, and other situations that require quick actions. For more detailed information, refer to the Integrated Dispatch Console User Guide. The Integrated Dispatch Console Installation Guide provides step by step information about the installation procedure. It also explains the un-installation and upgrade procedures for Integrated Dispatch Console. 1.1. Purpose and Scope This document is intended for personnel responsible for installing Integrated Dispatch Console. 1.2. Terms and Definitions The following table provides the definitions of the abbreviations and acronyms used in this document. Term Definition CAT GUI Corporate Administration Tool - Using this tool, the corporate administrator manages contacts and groups for corporate subscribers. These contacts and groups are downloaded to the handset of a corporate subscriber. Graphical User Interface A consistent set of graphical rules that allow a user to work with a computer. Release 3.0 Document Version: 1.0 3
IP LAN LCMS PoC PTT WyUpdate Internet Protocol The network layer protocol in the TCP/IP communications protocol suite. IP is the protocol used for sending data from one computer to another on the Internet. Local Area Network Life Cycle Management Server Push-to-Talk over Cellular A service that enables users to make instant (realtime) group and one-to-one calls. Push-To-Talk WyUpdate is a third party tool which checks for Integrated Dispatch Console upgrade availability. Release 3.0 Document Version: 1.0 4
1.3. About this Manual This document provides an overview and step-by-step instructions for downloading and installing Integrated Dispatch Console. This document is organized as follows: "Introduction" This chapter introduces Integrated Dispatch Console. "Hardware and Software Prerequisites" This chapter provides the information about the minimum hardware and software requirements for downloading and installing Integrated Dispatch Console. "Installing Integrated Dispatch Console" This chapter provides a detailed installation process for Integrated Dispatch Console. "Uninstallation Process" This chapter provides the un-installation process for Integrated Dispatch Console. "Upgrading Integrated Dispatch Console" This chapter provides the upgrade process for Integrated Dispatch Console. "Troubleshooting" This chapter provides details on installation errors and log files that you might encounter when you are installing or upgrading Integrated Dispatch Console. Release 3.0 Document Version: 1.0 5
1.4. What s New in this Release? Support of multiple dispatchers for a dispatcher group Multiple dispatchers can be assigned to a dispatch group which was restricted to one in the earlier versions of the Integrated Dispatch Console. It is possible for you to see if any other dispatcher has joined the call if the group is monitored. Clear All Selection button A new Clear All Selection button is introduced to clear all the selections across various tabs in Contacts and Groups on a single click. Auto refresh of logs An enhancement to automatically refresh the Alert log, Call log and Activity log without dispatcher clicking refresh button manually is added. Quick synchronization of updates with Corporate Administration Tool (CAT) All the changes done through the CAT are synchronized to Integrated Dispatch Console without any strikeout on Integrated Dispatch Console. The Dispatcher will be notified through a visual toast message whenever a contact or group is deleted in CAT. Activity Logs A new log tab Activity Logs is added to view all the operational, network and administration events occurred in the Integrated Dispatch Console. Help Icon A new help icon is added, which on clicking will redirect the dispatcher to the web page where Integrated Dispatch Console guides can be accessed. Play tones when the dispatcher is in a call A new setting to play tone is added under Tones and Notifications. If enabled, an audible notification tone is played for the incoming call or Instant Personal Alert (IPA), when the dispatcher is on another call. Notifications when application is running in the background A new setting for visual notification is added under Tones and Notifications. If enabled, a visual notification is displayed to notify the dispatcher when the application is running in the background (minimized). Silent rejoin Release 3.0 Document Version: 1.0 6
When dispatcher initiates a call to an already in session pre-arranged group from any of the following ways, the floor will not be given to the dispatcher automatically: - From monitoring groups - From call logs - By initiating a call to a missed group call - By initiating a call by selecting the same group from Contacts and Groups. Release 3.0 Document Version: 1.0 7
If the floor is not available (i.e. some other participant has a floor), the dispatcher can join the call and start hearing the voice. If the floor is available, the dispatcher can join the call silently without taking the floor. Client upgrade notification Integrated Dispatch Console in earlier releases, provides a pop-up message whenever updated version of Integrated Dispatch Console is available. In the current release of Dispatch version, it is possible to block the user from login in until either a newer version of dispatch is upgraded or OS version is upgraded. This is an optional feature which needs Life Cycle management Server (LCMS) deployed which will manage the life cycle of Integrated Dispatch Console and other PTT Clients. Alert reminder A new reminder setting under Alerts are added to allow the alert tones for IPA to repeat once, repeat configured number of times or continuously when the alert state is unattended. Integrated Dispatch Console will stop repeat the tone as per the repeat configuration after which the alert will be shown as unattended. View Archival Utility A separate Archival Utility Tool has been provided with this version to help the user to view the archived or backup data from the previous version of Integrated Dispatch Console. The dispatcher can browse or enter the correct path of the archive or backup file to view the logs and play the recorded calls. Release 3.0 Document Version: 1.0 8
2. Hardware and Software Prerequisites This chapter provides minimum hardware and software requirements for the Integrated Dispatch Console. 2.1. Hardware Requirements Following are the minimum hardware requirements for using Integrated Dispatch Console. Processor: Dual Core 2.1 GHz (minimum) Intel Core i5 or above RAM (Memory): 4 GB (minimum) Minimum required Hard Disk space: 1GB required for the installation (5GB or higher is recommended depending on your storage needs) Note: The disk space specified includes the space required for recording the call conversation, storage of reports, and also for storage of backup files. Monitor: 20.1 inches or better flat panel LCD Monitor with a 1600X1200 resolution setting (recommended). A standard sound card supporting a headset and speaker 2+ Mbps Data Connectivity Note: You must disable firewall services on your laptop/desktop before installing the Integrated Dispatch Console. Ports 443, 80 and 8080 must be open to both install and run Integrated Dispatch Console. Integrated Dispatch Console does not support authenticated HTTP/SOCKS proxies to establish a connection with the PTT server. The communication path between Integrated Dispatch Console and the PTT server uses a TLS connection. 2.2. Software Requirements Release 3.0 Document Version: 1.0 9
Following are the software requirements for Integrated Dispatch Console: Windows 7 Professional Edition SP1 32-bit or 64-bit version (en-us OS only) Or Windows 8.0/8.1, Windows 8.0/8.1 Pro or Enterprise 32 bit or 64 bit version (en-us OS only) Or Windows 10 Pro or Enterprise 32 bit or 64 bit version (en-us OS only) Internet Explorer (IE) 11 or Microsoft Edge 25 with File Download and Script options enabled (DOT) Net Framework 3.5 and above Windows Media Player 10 and above Release 3.0 Document Version: 1.0 1
Note: When you install the Windows 10, the Windows Media Player may not be available in the installer package. Admin need to install the Windows Media Player manually. 2.3. Network Requirements and Settings The minimum network requirement needed is 2+ Mbps Data Connectivity. To avoid the network failure related issues while using Integrated Dispatch Console, open the firewall settings for the below mentioned IP categories in Port 80, 8080 and 443 for outbound traffic. Range of sub netted IP address belongs to Production serving setup Range of sub netted IP address belongs to Production Geo setup Range of sub netted IP address belongs to load balance server of the Production servingsetup Range of sub netted IP address belongs to load balance server of the Production Geo setup. Note: Please disable firewall services on your laptop/desktop before installing the Integrated Dispatch Console. Ports 443, 80 and 8080 must be open to both install and run the Integrated Dispatch Console. File download must be enabled in Internet Explorer. To check or enable the File download option, perform the following steps from the Internet Explorer menu: 1. Click Tools > Internet Options > Security. 2. Click Custom level. On the Settings work area, scroll down to Downloads and ensure that the File download option is enabled as shown below. Release 3.0 Document Version: 1.0 1
Image 2.1 - Internet Explorer File Download Enabled Option 2.4. Application Checklist Review the following checklist before proceeding with the installation. If you are not certain your PC meets the below requirements you may want to check with your IT department to confirm compatibility. 1. The installer of the Integrated Dispatch Console must have administrative rights to install at system level. Administrative Privileges are not required to use Integrated Dispatch Console. Go to Control panel of the user account and check whether the user has admin privileges. An administrator must have the following permissions: Permission to install or un-install any software Permission to start, stop, or restart services Permission to create, modify, or delete files or folders on local drives. Release 3.0 Document Version: 1.0 1
2. Verify that the Web card URI path is accessible from Browser. Try accessing the web card URI link from the IE browser. For example: https:// wgp.kodiaknetworks.com/dispatcher/dispatcher.config Kindly check with the IT support for the Web card URI path. Once you have accessed the link, check to see whether the configuration values are shown. When the web card URI path is not accessible from the browser, the user will see a failed to download configuration files error. Release 3.0 Document Version: 1.0 1
3. Verify that the Google Map path is accessible from your Browser. Try accessing the following link from the IE browser: https:// maps.googleapis.com/maps/api/js?sensor=true IE will prompt for a file download if it is successful. If Google map is not accessible or if you encounter a script related exception error, then the Google map path is not accessible from the browser. 4. Verify that you have turned off the VPN. 5. Verify that the Firewall/Proxy is set up correctly for server IPs and port 443, 8080. Check your Firewall / Proxy settings. If you have not verified your firewall or proxy settings, you may end up with an Activation Failure error, network down error, or partial services down error. 6. Verify that the browser you are using is IE11 or Microsoft Edge 25. 7. Verify that Media Player 10 or above is installed. Release 3.0 Document Version: 1.0 10
3. Installing Integrated Dispatch Console This section provides step-by-step instructions for installing Integrated Dispatch Console. Follow the process below after logging into your windows user account. Note: Be sure to disable the VPN on your laptop/desktop before downloading the preinstaller and during the Integrated Dispatch Console installation. However, during the launching of the application, you do not need to disable the VPN. To Install Integrated Dispatch Console 1. Click the link given in the PoC activation e-mail to download the Integrated Dispatch Console pre-installer. This activation e-mail also contains the activation key information for initializing Integrated Dispatch Console. Image 3.1 - Activation e-mail for Integrated Dispatch Console 2. Double-click the Integrated Dispatch Console pre-installer. 3. Select the language for the Installation Instructions and Integrated Dispatch Console. Note that in this release, only English is supported. Select English, and then click OK. Release 3.0 Document Version: 1.0 11
Image 3.2 - Integrated Dispatch Console 4. The Integrated Dispatch Console installer is launched and a Welcome to Integrated Dispatch Console Setup Wizard window is displayed as shown below. Image 3.3 - Welcome wizard 5. Click Next to proceed with the installation. An End User License Agreement Window is displayed as shown below. Release 3.0 Document Version: 1.0 12
Image 3.4 - End User License Agreement 6. Review the terms of the license agreement. Check the I accept the terms in the License Agreement box to accept the terms, and click Next to continue with the setup. You can print the agreement from this screen by clicking the Print button. Once you accept the license agreement and terms, an Installation option window displays as shown below. Select the Install for individual user option if you want to install Integrated Dispatch Console for an individual user only. This means that other users of the system will not be able to use this instance of Integrated Dispatch Console. Select the Install for use by all the users of the system (shared use) option if you want to make Integrated Dispatch Console available to all users of the system you are installing it on. Release 3.0 Document Version: 1.0 13
Image 3.5 - Installation Option Window After selecting the installation for individual user or for shared use, click one the following options: Next to proceed with Integrated Dispatch Console installation. Or Back to go to End-User License Agreement window. Or Cancel to abort the installation process. Note: If you decide to change the user role from the individual user to a system wide installation or vice versa at a later date, you must uninstall Integrated Dispatch Console and re- install it by selecting the user role you desire. Be sure to back up the database and activation files before un-installing Integrated Dispatch Console so none of the user s information is lost. Refer to the Integrated Dispatch Console User Guide for more information on backing up and restoring the database and activation files. You will need administration privileges to change the role. Release 3.0 Document Version: 1.0 14
7. Click Next to continue once you have selected your desired installation option. A Destination Folder Window is displayed as shown below. Release 3.0 Document Version: 1.0 15
Image 3.6 - Destination Folder Window After the Destination Folder is displayed, click one of the following options: Next to proceed with Integrated Dispatch Console installation. Or Back to go to Installation Option Window. Or Cancel to abort the installation process. Note: When installing Integrated Dispatch Console for an individual user, the path is C:\Users\<User Name>\AppData\Local\Integrated Dispatch Console. If you are installing Integrated Dispatch Console for system-wide use in a 64 bit OS, the C:\Program Files (x86)\integrated Dispatch Console path is selected. If you are installing Integrated Dispatch Console for system wide use in a 32 bit OS, the C:\Program Files\Integrated Dispatch Console path is selected. Release 3.0 Document Version: 1.0 16
8. Click Next. A Backup Configuration Window is displayed as shown below. Release 3.0 Document Version: 1.0 17
Image 3.7 - Backup Configuration Window When the above window is displayed, click one of the following options: Next to proceed with Integrated Dispatch Console Installation. Or Back to go to the Destination Folder selection window. Or Cancel to abort the installation process Note: If you are installing Integrated Dispatch Console for system wide use, the default backup directory is C:\ProgramData\. If you are installing Integrated Dispatch Console for an individual user, the default backup directory is C:\Users\<Username>\AppData\Local. 9. Click the Browse button to change the backup location if desired. Note: If you install the Integrated Dispatch Console for system wide use, make sure that the backup directory is accessible to all the user. Release 3.0 Document Version: 1.0 18
10. Enter the Backup space in the Backup space (MB) field. Note: 1000 MB is the minimum amount of disk space required for the Backup configuration, although the recommendation is 5000 MB. An error message will display if the value entered in the Backup space field is less than 1000 MB. 11. Click Next. A Ready to Install Integrated Dispatch Console Window is displayed as shown below. Release 3.0 Document Version: 1.0 19
Image 3.8 - Ready to Install Integrated Dispatch Console Window 12. Click one of the following options: Install to begin the installation. An Installing Integrated Dispatch Console window is displayed. Or Back to review or change the installation settings. Or Cancel to abort the installation process. Release 3.0 Document Version: 1.0 20
Image 3.9 - Installing Integrated Dispatch Console Window After successful completion of the installation procedure, A Completed Integrated Dispatch Console Setup wizard window is displayed as shown below. Release 3.0 Document Version: 1.0 21
Image 3.10 - Completed Setup Wizard Window 13. Uncheck the Launch Integrated Dispatch Console option on the Completed the Integrated Dispatch Console Setup Wizard window if you do not want to immediately launch Integrated Dispatch Console. Or Release 3.0 Document Version: 1.0 22
Leave the Launch Integrated Dispatch Console option checked to initiate the Integrated Dispatch Console after a successful installation. 14. Click Finish to close the Completed the Integrated Dispatch Console Setup Wizard window. You can also launch Integrated Dispatch Console later by clicking Start > All Programs> Integrated Dispatch Console> Integrated Dispatch Console on Windows 7. On Windows 8 or 10 you can search for Integrated Dispatch Console using the search option and click the same icon. 15. After successful completion of the installation setup, the Integrated Dispatch Console is initialized and the Integrated Dispatch Console icon is displayed on the desktop and start menu. Click the Integrated Dispatch Console icon to launch Integrated Dispatch Console. After launching Integrated Dispatch Console, a splash screen appears as shown below. Image 3.11 - Splash Screen Next, an Activation Information Window is displayed as shown below. Image 3.12 - Activation Key Window 16. Enter the activation key (provided by the administrator in the PoC activation e-mail) in the Activation Key field, and click OK to activate the Integrated Dispatch Console. Release 3.0 Document Version: 1.0 23
Upon successful activation, Integrated Dispatch Console is launched and the user interface displays as shown below. If the Cancel button is clicked, a window appears with a Closing Integrated Dispatch Console message. Upon clicking OK the Integrated Dispatch Console exists. Release 3.0 Document Version: 1.0 24
Image 3.13 - Integrated Dispatch Console Release 3.0 Document Version: 1.0 20
4. Uninstallation Process This chapter explains how to uninstall Integrated Dispatch Console. Integrated Dispatch Console can be uninstalled in two ways: From the Start Menu From the Control Panel 4.1. Uninstalling Integrated Dispatch Console from the Start Menu 1. If you are using Windows 7/8.0/8.1 Click Start >All Programs> Integrated Dispatch Console>Uninstall 2. If you are using Windows 10 Click Start>Integrated Dispatch Console>Uninstall A Windows Uninstaller confirmation window is displayed to take the manual backup of all the logs, data and reports before the uninstallation as shown below. Image 4.1 - Windows Uninstaller Window Release 3.0 Document Version: 1.0 21
Note: Make sure you take the backup of all the logs, data and reports before you uninstall the Integrated Dispatch Console. 3. Click one of the following options: Yes to uninstall. An uninstall confirmation window is displayed as shown below. OR No to abort the uninstallation process. 4. After Integrated Dispatch Console is successfully uninstalled, a message window is displayed as shown below. Click OK to complete the uninstallation process. Release 3.0 Document Version: 1.0 22
Image 4.2 - Uninstall completed successfully info window 4.2. Uninstalling Integrated Dispatch Console from the Control Panel This section explains the uninstallation procedure of Integrated Dispatch Console from the Control Panel. To uninstall Integrated Dispatch Console from the Control Panel 1. If you are using Windows 7: Click Start >Control Panel>Programs and Features If you are using Windows 8.1: Click Control Panel>Programs>Programs and Features If you are using Windows 10: Release 3.0 Document Version: 1.0 23
Click Start>Control Panel>Programs>Uninstall a program 2. Select Integrated Dispatch Console and click Uninstall. A confirmation pop-up is displayed. Image 4.3 - Uninstall Confirmation Window Note: Make sure you take the backup of all the logs, data and reports before you uninstall the Integrated Dispatch Console. Click Yes to continue the uninstallation process (This will delete all the data including recordings, alert, and call logs history. The application logs will not be deleted). Or Click No to abort the process. Release 3.0 Document Version: 1.0 24
Note: If any file is opened from the installed folder, then the application folder will not be deleted. 3. After Integrated Dispatch Console is successfully uninstalled, a message window is displayed as shown below. Click OK to complete the uninstallation process. Image 4.4 - Uninstall completed successfully info window Release 3.0 Document Version: 1.0 25
5. Upgrading Integrated Dispatch Console This chapter explains how to upgrade Integrated Dispatch Console. Prior to the 2.7.2 version, Integrated Dispatch Console is installed by an administrator. All the users of the system share the same version of Integrated Dispatch Console. After the 2.12 version system upgrade, all the users of the system will share the same 2.12 version of Integrated Dispatch Console. From 2.11 and above, the user has been provided an option to install Integrated Dispatch Console either system wide or at the user level. With this feature, a user can take backup of the all the logs, data, reports and change the role of system-wide to user level or vice versa. Note: Change of role requires uninstalling previous version and installation in the required role. For post 2.7.2 versions, Integrated Dispatch Console is installed by an individual user. Each user has their own version of Integrated Dispatch Console installed under their own Windows user account. The user has to be logged in to their account to use Integrated Dispatch Console. The other users of the system will not have access to Integrated Dispatch Console installed for a different user. If the user wants to upgrade to 2.12, then they will be provided an option to only upgrade to 2.12 without any change to the existing role. In Integrated Dispatch Console 3.0 version, client upgrade notification through Life Cycle Management Server (LCMS) has been introduced. The Life Cycle Management feature allows life cycle management for Integrated Dispatch Console and other clients. It provides the enhanced notification to the user when a newer version of the Integrated Dispatch Console is available for the upgrade. It will also notify the user that the Integrated Dispatch Console will no longer support a particular OS version. These notifications can either block the user and completely exit from the PTT service or can allow the user to continue with the PTT service for a specified period depending on the LCMS configuration. Integrated Dispatch Console will show the below types of client upgrade notification: 1. Integrated Dispatch Console Support Ending Notification 2. Integrated Dispatch Console Deny Notification Release 3.0 Document Version: 1.0 26
5.1. Integrated Dispatch Console Support Ending Notification This pop-up notification comes when the support of current Integrated Dispatch Console version is ending soon. A pop-up notification will be displayed with a text showing the end date of the current dispatch version, after which, the Integrated Dispatch Console will automatically log out. The user will not be able to use PTT service until the Integrated Dispatch Console is upgraded to the newer available version. Release 3.0 Document Version: 1.0 27
Image 5.1 - Integrated Dispatch Console Support Ending Notification Click the More Info to view the more information related to Integrated Dispatch Console support ending notification Or Upgrade to log out, exit Integrated Dispatch Console and continue with the upgrade process Or Dismiss to cancel the notification and continue with the PTT service. Note: If you click the Dismiss button without checking the checkbox, the notification will be dismissed for now. When the user dismisses the upgrade notification and continues login to the Integrated Dispatch Console, a message is displayed in the Setting tab to notify the end date to upgrade the Integrated Dispatch Console. Release 3.0 Document Version: 1.0 28
Image 5.2 - Upgrade notification important message Click the More Info to view the more information related to Integrated Dispatch Console upgrade notification Or Upgrade to log out, exit Integrated Dispatch Console and continue with the upgrade process. Release 3.0 Document Version: 1.0 29
5.2. Integrated Dispatch Console Deny Notification This notification comes when the current Integrated Dispatch Console version is no longer supported. The user needs to upgrade the existing Integrated Dispatch Console version to newer available version to continue use of the PTT service. Image 5.3 - Integrated Dispatch Console Deny Notification Click the More Info to view the more information related to Integrated Dispatch Console deny notification Or Upgrade to log out, exit Integrated Dispatch Console and continue with the upgrade process Or Exit to logout and exit the Integrated Dispatch Console. In case the user is already logged into the Integrated Dispatch Console and there is an updated version is ready for download, an Upgrade Notification pop-up window is displayed (at the task bar) as shown below. Release 3.0 Document Version: 1.0 30
Image 5.4 - Upgrade notification You can click the Settings icon to display the Notification settings screen and can set the frequency to display the icon and the notification accordingly. You can also click Close if you do not intend to upgrade Integrated Dispatch Console when the notification is displayed. You can always continue to upgrade Integrated Dispatch Console by following the steps below when you are ready to upgrade. 1. Right-click the Integrated Dispatch Console Launcher on the task bar and select Integrated Dispatch Console Upgrade Notification as shown below. Release 3.0 Document Version: 1.0 31
Image 5.5 - Upgrade Notification A WyUpdate Update information window is displayed as shown below. Image 5.6 - WyUpdate Update Information Window Click Update to start the upgrade. A WyUpdate Downloading and Installing updates window is displayed as shown below. Release 3.0 Document Version: 1.0 32
Image 5.7 - WyUpdate Update Downloading and Installation Window If some pre-defined processes related to Integrated Dispatch Console are still running when you choose to upgrade, a pop-up message displays asking you to terminate the running processes. Select the process or processes that are running, and click Close All Processes to terminate the processes and proceed with the upgrade installation. 2. Click Cancel to abort the update procedure. The Integrated Dispatch Console Setup wizard appears. Release 3.0 Document Version: 1.0 33
Image 5.8 - Integrated Dispatch Console Setup Wizard 3. Click Next to continue the upgrade process. One of the following Upgrade Option windows appears. Release 3.0 Document Version: 1.0 34
Image 5.9 - Upgrade Option Windows Image 5.10 - Upgrade Option Windows Release 3.0 Document Version: 1.0 35
Note: If you had earlier installed Integrated Dispatch Console for an individual user, then the option to Upgrade for an individual user will be allowed for you to select and the other option will be disabled. If you had earlier installed Integrated Dispatch Console system wide for shared use, then the option to Upgrade for use by all the users of the system (shared use) will be allowed to select and the other option will be disabled. 4. Select your desired upgrade option and click Next. A Ready to install Integrated Dispatch Console window appears. Release 3.0 Document Version: 1.0 36
Note: If you decide to change the user role from the individual user to a system-wide installation or vice versa, you must un-install Integrated Dispatch Console and reinstall it, selecting the user role you desire. Be sure to back up the database and activation files before un-installing Integrated Dispatch Console so none of the user s information is lost. Refer to the Integrated Dispatch Console User Guide for more information on backing up and restoring the database and activation files. You will need administration privileges to change the role. Image 5.11 - Ready to Upgrade Integrated Dispatch Console Window 5. Click one of the following options: Upgrade to begin the upgrade procedure. An Installing Integrated Dispatch Console window displays. Back to review or change the installation settings. WARNING: Do not click Cancel. Clicking Cancel at this point in the upgrade process will abort the upgrade process and will result in a loss of user data from the previous installation. In the event that Cancel is clicked at this point, contact Customer Care for further assistance. Release 3.0 Document Version: 1.0 30
Image 5.12 - Upgrading Integrated Dispatch Console Window After successful completion of the upgrade procedure, a Completed the Integrated Dispatch Console Setup Wizard window is displayed as shown below. Image 5.13 - Completed Setup Upgrade Wizard Window 6. Uncheck the Launch Integrated Dispatch Console option on the Completed the Integrated Dispatch Console Setup Wizard window if you do not want to immediately launch Integrated Release 3.0 Document Version: 1.0 31
Dispatch Console. Or Leave the Launch Integrated Dispatch Console option checked to initiate the Integrated Dispatch Console after a successful upgrade. 7. Click Finish to complete the installation process. Release 3.0 Document Version: 1.0 32
An Update Successful window is displayed as shown below. 8. Click Finish to exit from the upgrade process. Image 5.14 - Update Successful Window Release 3.0 Document Version: 1.0 33
6. Troubleshooting The following table describes the possible error messages that may be displayed during the installation of Integrated Dispatch Console. It also provides details to fix the issue. Error Code Error Message Description Possible Cause Remedy a) Exit the current upgrade process. DISP-1002 Data Backup unsuccessful. If you continue data will be lost. Do you want continue? This error is displayed during upgrade from Integrated Dispatch Console version 2.6.x and below to 2.12.x. If Postgres binaries corrupted or deleted, Then Installer will not be able to start postgres service. Hence this message will be displayed. b) Try to start postgres service manually c) If Postgres starts then retry upgrade. d) If postgres does not start, restore postgres binaries e) After restoring postgres binaries, start postgres service manually and retry the upgrade. To restore postgres binaries, Go to 2.6.x installation path and double click on PostgressDBRecovery.ex e DISP-1007 DISP-1008 Please exit Integrated Dispatch Console and retry uninstall Installation/ Upgrade of {0} version {1} is supported on Windows 7 or higher This error is displayed when the user tries to uninstall Integrated Dispatch Console without exiting the Integrated Dispatch This error is displayed when the user tries to install/upgrade Integrated Dispatch Console version 2.12.x This may occur when a user has not exited Integrated Dispatch Console and tries to uninstall it. This may occur when a user attempts to install/ upgrade Integrated Dispatch Console version 2.12 or higher on Exit Integrated Dispatch Console and try to uninstall again a) Check your windows OS version. It must be Windows 7 or higher. b) If your OS version is Windows XP, then contact your system administrator to install Windows 7 or higher. Or higher on windows XP. Windows XP. Release 3.0 Document Version: 1.0 34
Error Code Error Message Description Possible Cause Remedy DISP-1009 Invalid backup path. Configured directory does not exist. This error is displayed if the given backup path does not exist. This may occur when the given backup path does not exist or is invalid. a) Give the valid backup path. b) Try to Install Integrated Dispatch Console. DISP-1010 Invalid backup space configuration. This should be a number. This error is displayed when the mentioned backup space is not a number. This may occur when the backup space mentioned is in alphanumeric form or contains any spaces. Enter the number in the correct format in the Backup Space textbox. DISP-1011 The selected backup space requires at least 1000 MB of space. This error is displayed when the backup space is less than 1000MB. The user might have designated a backup space of less than 1000MB. Provide a minimum backup space of 1000MB. DISP-1012 DISP-1013 The minimum disk space required to install Integrated Dispatch Console is 1GB. To use Integrated Dispatch Console, the recommended disk space is 5GB. Proceeding with (user provided value) MB of disk The minimum disk space required to install Integrated Dispatch Console is 1GB. Available disk space is _ MB. Integrated Dispatch Console cannot be This message is displayed when the given disk space is in the range of 1GB- 5GB This message is displayed when the available disk space is less than 1GB. This may be displayed when the user provided a value between 1GB and 5GB. This is just a warning message. This may be displayed when the available disk space for installing Integrated Dispatch Console is less than 1GB. If possible give, more than 5GB of minimum disk space. Clean-up to get disk space more than 1GB of space. Release 3.0 Document Version: 1.0 35
Error Code Error Message Description Possible Cause Remedy DISP-1015 This application requires a minimum of.net Framework 3.5. Please install the.net Framework 3.5 or Above, then run this installer again. Can download from http:// www.microsoft.co m/en-in/download/ details.aspx?id=2 2. This error is displayed if the.net Framework 3.5 or above is not installed. This may be displayed when the.net Framework 3.5 or above is not installed. Contact your system administrator to Install.NET Framework 3.5 or above. DISP-1016 Please wait while the current installation completes. This error is displayed when the installation is going on and the user tries to run the installer again. Occurs if the Integrated Dispatch Console installation is in progress and user tries to run the installer again. Wait until the installation completes. DISP-1017 Administrator privileges required to install. This error is displayed while upgrading a System level installation. Occurs if the user is a standard user and trying to upgrade a system level installation. Upgrade using admin account DISP-1018 Per-User installation detected on the following accounts: [INSTALLED_US ER_NAMES]Plea se uninstall all instances of Integrated Dispatch Console before installing for all users (Shared users). This error is displayed while installing for All users (System level). Occurs if any user of the system already has Integrated Dispatch Console installed for his user account. Uninstall all the user level installations, then try installing it again for all users (System level) Release 3.0 Document Version: 1.0 36
AT&T Business Division Name or AT&T Product or Offering Name edit on First Page Header Error Code Error Message Description Possible Cause Remedy DISP-1019 A current/later version of Integrated Dispatch Console is already installed. Setup will now exit. This error is displayed while installing Integrated Dispatch Console. Occurs if the user has already installed the current or later version of Integrated Dispatch Console and is trying to install again using msi. Uninstall the existing installation, then try installing again. DISP-1023 An error occurred while installing the Integrated Dispatch Console. Logs for this error can be located at the below location. This error text is displayed for any issue while installing or upgrading the Integrated Dispatch Console. Occurs if there is any generic error while installing or upgrading the Integrated Dispatch Console. Uninstall the existing installation and then try installing it again. If the issue still continues, please collect the logs from mentioned path. October 11, 2016 2016 AT&T Intellectual Property. All rights reserved. AT&T and the Globe logo are registered trademarks of AT&T Intellectual Property.