Skip to main content
Older versions of Internet Explorer will not support certain site features. Chrome, Safari, Firefox, and Edge will provide the best experience.
Resources
Spok

Upgrading from Spok Mobile 4.0 to 4.5

This document describes how to upgrade from Spok Mobile 4.0.5 to 4.5.

Before You Begin

On the Database Server

  • Install Windows Server 2016 Standard GUI
  • Set server name
  • Configure the server's time and time zone. All Care Connect Suite server dates and times must be synchronized with the network's time. Each server must also be synchronized with the rest of of the Care Connect Suite servers. If the Spok Mobile server has a different time than the network to which the Spok Mobile devices are connected, time discrepancies can occur. In this situation, the times that are recorded on the server and those that display on the Spok Mobile clients would be different. To ensure that times are accurately represented on both the server and devices, synchronize the times on both.
  • Configure your network interface (Internal Network, Outbound Internet Access)
  • Add the following entries to the server's hosts file:
    • 10.50.150.38    QA-Database1.archmessage.net
    • 10.50.150.40    QA-Platform1.archmessage.net
    • 10.50.150.42    QA-Mobile1.archmessage.net smobile.archmessage.net
  • Install Microsoft SQL Server 2016 Enterprise
  • Configure Windows Firewall by running the following command:
netsh advfirewall firewall add rule name="Spok - SQL Server Port" dir=in action=allow protocol=TCP localport=1433 remoteip=10.0.0.0/8
  • Run Windows Update
  • Disable automatic Windows Updates
  • Join the server to the Domain Controller (optional)
  • Copy the DatabaseTransfer folder from the Care Connect Installation Media to C:\Install\DatabaseTransfer

On the Platform Server

  • Install Windows Server 2016 Standard GUI
  • Set server name
  • Configure the server's time and time zone. All Care Connect Suite server dates and times must be synchronized with the network's time. Each server must also be synchronized with the rest of of the Care Connect Suite servers. If the Spok Mobile server has a different time than the network to which the Spok Mobile devices are connected, time discrepancies can occur. In this situation, the times that are recorded on the server and those that display on the Spok Mobile clients would be different. To ensure that times are accurately represented on both the server and devices, synchronize the times on both.
  • Configure your network interface (Internal Network, Outbound Internet Access)
  • Add the following entries to the server's hosts file:
    • 10.50.150.38    QA-Database1.archmessage.net
    • 10.50.150.40    QA-Platform1.archmessage.net
    • 10.50.150.42    QA-Mobile1.archmessage.net smobile.archmessage.net
  • Add the Platform and Mobile servers to Internet Explorer's trusted sites. The URLs are:
  • Configure Windows Firewall by running the following command:
netsh advfirewall firewall add rule name="Spok - CCS Ports" dir=in action=allow protocol=TCP localport=80,443 remoteip=10.50.150.42
  • Run the following command to install Windows components from the Windows media:
C:\Windows\System32\dism.exe /NoRestart /Online /Enable-Feature /FeatureName:WCF-HTTP-Activation45 /all /FeatureName:WCF-HTTP-Activation /all /FeatureName:Windows-Identity-Foundation /all /FeatureName:IIS-WebServer /all /FeatureName:IIS-CommonHttpFeatures /all /FeatureName:IIS-DefaultDocument /all /FeatureName:IIS-StaticContent /all /FeatureName:IIS-HttpErrors /all /FeatureName:IIS-DirectoryBrowsing /all /FeatureName:IIS-HttpLogging /all /FeatureName:IIS-ASPNET /all /FeatureName:IIS-ASPNET45 /all /FeatureName:IIS-ApplicationDevelopment /all /FeatureName:IIS-NetFxExtensibility /all /FeatureName:IIS-NetFxExtensibility45 /all /FeatureName:IIS-ISAPIExtensions /all /FeatureName:IIS-ISAPIFilter /all /FeatureName:IIS-ManagementConsole /all /FeatureName:TelnetClient /all /Source:D:\sources\sxs
  • Run Windows Update
  • Disable automatic Windows Updates
  • Join the server to the Domain Controller (optional)
  • Copy the Care Connect installation media to C:\Install
  • Copy the Spok Mobile license file to C:\Install

On the Mobile Server

  • Install Windows Server 2016 Standard GUI
  • Set server name
  • Configure the server's time and time zone. All Care Connect Suite server dates and times must be synchronized with the network's time. Each server must also be synchronized with the rest of of the Care Connect Suite servers. If the Spok Mobile server has a different time than the network to which the Spok Mobile devices are connected, time discrepancies can occur. In this situation, the times that are recorded on the server and those that display on the Spok Mobile clients would be different. To ensure that times are accurately represented on both the server and devices, synchronize the times on both.
  • Configure your network interface (DMZ Network, Inbound/Outbound Internet Access)
  • Add the following entries to the server's hosts file:
    • 10.50.150.38    QA-Database1.archmessage.net
    • 10.50.150.40    QA-Platform1.archmessage.net
    • 10.50.150.42    QA-Mobile1.archmessage.net smobile.archmessage.net
  • Add the Platform and Mobile servers to Internet Explorer's trusted sites. The URLs are:
  • Configure Windows Firewall by running the following command:
netsh advfirewall firewall add rule name="Spok - Mobile Ports" dir=in action=allow protocol=TCP localport=80,8090,443,8091
  • Run the following command to install Windows components from the Windows media:
C:\Windows\System32\dism.exe /NoRestart /Online /Enable-Feature /FeatureName:WCF-HTTP-Activation45 /all /FeatureName:WCF-HTTP-Activation /all /FeatureName:Windows-Identity-Foundation /all /FeatureName:IIS-WebServer /all /FeatureName:IIS-CommonHttpFeatures /all /FeatureName:IIS-DefaultDocument /all /FeatureName:IIS-StaticContent /all /FeatureName:IIS-HttpErrors /all /FeatureName:IIS-DirectoryBrowsing /all /FeatureName:IIS-HttpLogging /all /FeatureName:IIS-ASPNET /all /FeatureName:IIS-ASPNET45 /all /FeatureName:IIS-ApplicationDevelopment /all /FeatureName:IIS-NetFxExtensibility /all /FeatureName:IIS-NetFxExtensibility45 /all /FeatureName:IIS-ISAPIExtensions /all /FeatureName:IIS-ISAPIFilter /all /FeatureName:IIS-ManagementConsole /all /FeatureName:TelnetClient /all /Source:D:\sources\sxs
  • Run Windows Update
  • Disable automatic Windows Updates
  • Join the server to the Domain Controller (optional)
  • Install IIS Certificates. For more information, see Configuring SSL Certificates, as well as the section Importing a Certificate in the article Configuring HTTPS Support.
  • Copy the Care Connect installation media to C:\Install
  • Copy the AppSettingsSection.txt file to C:\Install

Migrating the Database

Removing Existing Customer Registrations

Before upgrading the system, remove the existing customer registrations from the  AmcomAmcPremiseCore database (SQL Server|AmcomAmcPremiseCore|Tables).

  1. Copy the DatabaseTransfer folder from the CCS installation media to the Spok Mobile 4.0.5 Database Server, at C:\Install\DatabaseTransfer.
  2. Log into SQL Server 2008 on the Spok Mobile 4.0.5 Database Server.
  3. Launch Microsoft SQL Server Management Studio using the sa account.
  4. Run the following to remove existing customer registrations:
DELETE FROM [AmcomAmcPremiseCore].[dbo].[Registrations]
DELETE FROM [AmcomAmcPremiseCore].[dbo].[License]
DELETE FROM [AmcomAmcPremiseCore].[dbo].[REGISTRATION_FEATURE]
DELETE FROM [AmcomAmcPremiseCore].[dbo].[Devices]

Performing the Migration

Databases on SQL Server 2008 or 2012 must be migrated to SQL Server 2014 or 2016, which are compatible with Spok Mobile 4.5. The following procedure aims to minimize downtime during upgrades that require a database migration. In the first part of the procedure, backups are created while the services are operational.

  1. Log into the Spok Mobile 4.0.5 server.

  2. Log into SQL Server Management Studio with the sa account.

  3. Execute C:\Install\DatabaseTransfer\GetSQLServerDefaultBackupDir.sql. This will identify the default SQL directory in which the backups will be stored.

  4. On the Spok Mobile 4.0.5 server, execute C:\Install\DatabaseTransfer\2_BackupDatabases.sql in SQL Server 2008. This will create the Database _Upgrade.bak files.

  5. Log into SQL Server 2016 (on the Spok Mobile 4.5 Database Server).

  6. Log into Microsoft SQL Server Management Studio with the sa account.

  7. Copy the three backup files from steps 3 and 4 to the default SQL directory. If you do not know the directory, execute GetSQLServerDefaultBackupDir.sql to identify it.
    The following list of files will be transferred:

  • AmcomAmcPremiseCore.bak
  • AmcomCore.bak
  • AmcomMeta.bak
  1. Execute 4_1_1_RestoreDatabases.sqlDatabases will now appear in Restoring status.

At this point in the procedure, a partial restore of the database has been completed. Most of data has been restored on the new server. However, the database in not fully operational yet. The database is in the "Restoring" state. Perform the following steps to complete the database restoration/migration.

Installing the Care Connect Server

The Care Connect Server installation process for Spok Mobile With a Pager differs in important ways from the standard installation process.

Ensure that you have your XML license file ready before beginning the installation process. You must provide the license file at the end of installation.

The Care Connect Suite installer does not default to the previous Spok Mobile installation locations. If you are installing to an alternate location, such as the D: drive, select the desired install location the first time that you run the Care Connect Suite installer. After the initial upgrade using the Care Connect Suite installer, future upgrades should preserve the chosen install location(s).

The standard Care Connect Suite installation locations are:

  • C:\Program Files\Spok
  • C:\inetpub\wwwroot\Spok
  • C:\inetpub\wwwroot\AMC 

Initiating the Maintenance Window

  1. Log into the Spok Mobile 4.0.5 server.

    WARNING: Steps and b below will take the Spok Mobile 4.0.5 server offline and initiate downtime.
    1. Stop the following Windows services:
      • Spok Mobile Adapter (if running)
      • Spok Mobile Services
    2. Stop IIS services.
  2. On the 4.0.5 server, execute 4_1_2_BackupDatabasesDifferential.sql. This backup captures any changes which happened between the backup created in Performing the Migration Step 4 and the time the services were stopped above.
  3. Log into the Spok Mobile 4.5 Database Server
  4. Log into SQL Server Management Studio using the sa account.
  5. Copy the Database_UpgradeDiff backup files from SQL Server 2008 (on the 4.0.5 server) to the default directory of SQL Server 2016 (on the 4.5 server).
  6. On the 4.5 server, execute 4_1_3_RestoreDatabasesDifferential.sql.

Running the Care Connect Suite Installer

Perform the following steps to install Care Connect by running the Care Connect Suite Installer.

  1. Navigate to the Spok Care Connect installation media, then right-click on Spok Care Connect Server.exe and select Run as Administrator.
  2. Select Install.
  3. If you are missing any prerequisites, the installer will notify you or install them now. If you are prompted to restart the computer, do so.
  4. When the Welcome to the Spok Care Connect Setup Wizard message appears, click Next to continue to the Custom Setup window.
  5. In the Custom Setup window, select only the Platform component and sub-components for installation. Set all other components and sub-components to "Entire component will be unavailable."
  6. Click Next after you have made your selections.
  7. In the Database Configuration dialog, configure the available fields with the following information:

    Server: QA-Database1.archmessage.net
    Database: master
    Username: sa
    Password ******
    Integrated Security

    Unchecked

     

  8. Click Test Connection to attempt to connect to the server database with the user credentials you provided. If the connection was successful, the Ready to install Care Connect dialog will appear.

  9. In the Ready to install Care Connect dialog, click Install. The installer makes all of the necessary configurations to IIS and deploys the application directly to IIS.

  10. Click Finish when the installation is complete. The Setup Successful dialog will appear, but you will still need to import the license file.

Importing the License File

  1. After the installation is complete, the Import License and Configuration Manager pages will automatically open in a browser. The URLs of these pages should be:
    1. http://localhost/Web/Public/Home/ImportLicense
    2. ​​​​​​http://localhost/ConfigManager​
  2. On the Import License page, click Browse.
  3. Navigate to the license file in C:\Install.
  4. Click Upload and wait for the message "SUCCESS! License update succeeded."
  5. Click Finish.

Configuring the Care Connect Server

  1. On the Configuration Manager page, set the Platform Server Name to QA-Platform1.archmessage.net and click Save.
  2. Restart IIS by executing iisreset from a command line.
  3. The Platform Admin Login page will automatically launch in a browser.
    1. Log in with your username ("support") and password.
  4. Navigate to Administration > System Configuration > Settings.
  5. Configure your system settings as follows:
IIS Configuration > Server Name QA-Platform1.archmessage.net
SMTP Settings > Host 127.0.0.1
SMTP Settings > From support@spok.com
Assets > Asset Directory Location C:\Assets\Upload
Create directory location

Select

  1. Log out of Platform Web, then log back in.
  2. Add the Web URL to Internet Explorer's list of trusted web sites.
  3. Import your certificate by doing the following:
    1. Open the Internet Information Services Manager, then double-click on Server Certificates.
    2. Right-click on the Server Certificates panel and select Import.
    3. In the Import Certificate dialog, click the ellipses button next to Certificate file (.pfx) to navigate to and open your certificate.
    4. Enter the certificate's password in the Password field.
    5. Leave the Select Certificate Store field set to Personal
    6. Select the Allow this certificate to be exported checkbox.
    7. Click OK.
  4. Set up HTTPS support by doing the following:
  5. Log out of the Care Connect server.

  6. Reset IIS by opening a new command prompt or PowerShell instance and running iisreset.

Installing the Spok Mobile Server

The Spok Mobile Server installation process for Spok Mobile With a Pager differs in important ways from the typical installation process. Follow the instructions below carefully and note the differences where they appear.

The Care Connect Suite installer does not default to the previously-installed Spok Mobile installation locations. If installing to an alternate installation location, such as the D: drive, select the desired install location the first time the Care Connect Suite installer is run. After the initial upgrade using the Care Connect Suite installer, future upgrades should preserve the chosen install location(s). The standard Care Connect Suite installation locations are: C:\Program Files\Spok, C:\inetpub\wwwroot\Spok, and C:\inetpub\wwwroot\AMC

If you install Spok Mobile 4.5 on a new/different server from the one used previously, you will need to upload the license used for the previous Spok Mobile version environment again following the 4.5 installation.

To install the Spok Mobile Server, do the following:

  1. Navigate to the Spok Care Connect installation media, then right-click on Spok Care Connect Server.exe and select Run as Administrator.
  2. Select Install.
  3. If you are missing any prerequisites, the installer will notify you or install them now. If you are prompted to restart the computer, do so.
  4. When the Welcome to the Spok Care Connect Setup Wizard message appears, click Next to continue to the Custom Setup window.
  5. In the Custom Setup window, select only the Mobile component and sub-components for installation, except for the "Configure Spok Notification Framework" sub-component. Set all other components and sub-components to "Entire component will be unavailable."
  6. Click Next after you have made your selections.
  7. In the Database Configuration dialog, configure the available fields with the following information:

    Server: QA-Database1.archmessage.net
    Database: master
    Username: sa
    Password ******
    Integrated Security

    Unchecked

  8. Click Test Connection to attempt to connect to the server database with the user credentials you provided. If the connection was successful, the Ready to install Care Connect dialog will appear.

  9. In the Ready to install Care Connect dialog, click Install. The installer makes all of the necessary configurations to IIS and deploys the application directly to IIS.

  10. Click Finish when the installation is complete. The Setup Successful dialog will appear, but you will still need to import the license file.

Configuring the Spok Mobile Server

  1. After the installation is complete, the AMC Admin Page and Configuration Manager pages will automatically open in a browser. The URL of this page should be ​​​​​​http://localhost/ConfigManager​.
  2. On the Configuration Manager page, change the server name from localhost to QA-Platform1.archmessage.net
  3. Click Save.
  4. On the AMC Admin page, change the server name from localhost to QA-Platform1.archmessage.net
  5. Click Save.
  6. Navigate to the file C:\Install\AppSettings_Section.txt.
    1. Copy the <AppSettings> section.
    2. Paste it into the file C:\inetpub\wwwroot\AMC\Wctp\Web.config
  7. In your browser, navigate to http://localhost/AMC/Admin. The browser will redirect to the Platform Admin Login page.
    1. Log in with your support username and password.
    2. Navigate to Administration > System Configuration > Mobile and configure the following settings.
Server Settings > Hosted Server Name amccore1.amconamc.com
Server Settings > Mobile Server Name smobile.archmessage.net
Port

8091

  1. Navigate to Edit Mobile Configuration.

  2. Update the Mobile Server Name field from localhost to the DNS name of the Spok Mobile Server.

  3. Select the HTTPS box.

  4. Verify the information in the other fields on the Edit Mobile Configuration page.

  5. If you are using mirroring, enter the failover partner in the Secondary Server Name field. For more information, see Setting up a High Availability Spok Mobile Environment.

  6. Click Save.
  7. Click Apply.
  8. The page will prompt you to restart Spok Mobile Services. Click Yes.
  9. Confirm that Windows Services are running and that the Windows Service log shows a HANDSHAKE ACCEPTED message. This means that the Spok Hosted server accepted the connection request initiated by the Spok Mobile Service. If this message is not in the log, you will need to start the connection manually by right-clicking on the service and selecting Start. The Windows Service log can be found on the Mobile server in <install drive>\Program Files (x86)\Spok\Care Connect\Mobile Connect Services\logs\SM_CoreService.txt.