44
PUBLIC SAP Mobile Platform 3.0 SP05 Version: 1.0 - 2014-12-09 Upgrade: SAP Mobile Platform Server for Windows

Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

Embed Size (px)

Citation preview

Page 1: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

PUBLIC

SAP Mobile Platform 3.0 SP05Version: 1.0 - 2014-12-09

Upgrade: SAP Mobile Platform Server for Windows

Page 2: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

Content1 Upgrade: SAP Mobile Platform Server for Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2 Upgrading SAP Mobile Platform 3.0 Server to SP05. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52.1 Upgrading an Existing 3.0 Server to SP05. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

2.1.1 Acquiring the Support Package Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62.1.2 Preparing to Upgrade. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72.1.3 Running the Support Package Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92.1.4 Verifying the Upgrade. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102.1.5 Upgrading Tomcat Server sslEnabledProtocols Property for Agentry Applications on iOS 7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

2.2 Adding Cluster Nodes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122.2.1 Running the Support Package Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122.2.2 Verifying the Added Node. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

3 Upgrading an SAP Mobile Platform 3.0 Cluster to SP05. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173.1 Upgrading Each SAP Mobile Platform 3.0 Server to SP05. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

3.1.1 Acquiring the Support Package Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183.1.2 Preparing to Upgrade. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193.1.3 Running the Support Package Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203.1.4 Verifying the Upgrade. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213.1.5 Upgrading Tomcat Server sslEnabledProtocols Property for Agentry Applications on iOS 7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

3.2 Adding Cluster Nodes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233.2.1 Running the Support Package Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233.2.2 Verifying the Added Node. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

4 Upgrading SAP Mobile Platform 2.3.x Server to SAP Mobile Platform 3.0 SP05. . . . . . . . . . . .284.1 Acquiring the Support Package Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294.2 Preparing to Upgrade. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304.3 Running the Support Package Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314.4 Verifying the Upgraded Node. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34

5 Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .365.1 Quick Fixes to Simple Problems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

5.1.1 Installation Fails after Canceling Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365.1.2 Server Using Derby Database Fails to Restart after Upgrade. . . . . . . . . . . . . . . . . . . . . . .375.1.3 Server Node Does Not Start. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .375.1.4 Server Node Does Not Join the Cluster. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395.1.5 Failed to Start SAPSMPTestUserLogonService Service Error. . . . . . . . . . . . . . . . . . . . . . 40

5.2 Issues Requiring Product Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405.2.1 Product Support Engagement Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41

2P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved.

Upgrade: SAP Mobile Platform Server for WindowsContent

Page 3: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

5.2.2 Creating an Incident on SAP Service Marketplace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Upgrade: SAP Mobile Platform Server for WindowsContent

P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved. 3

Page 4: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

1 Upgrade: SAP Mobile Platform Server for WindowsUpgrade your single-server SAP Mobile Platform Server 3.0 installation to SP05 and add server nodes to form a cluster. Optionally upgrade an existing SAP Mobile Platform 2.3.x instalaltion to MBO Runtime 3.0, or add MBO Runtime components as you upgrade your SAP Mobile Platform system.

You can upgrade any single-server SAP Mobile Platform Server 3.0.x installation to SP05.

If the SAP Mobile Platform Server 3.0.x installation you are upgrading was installed with an external, production database, you can use same SAP Mobile Platform Server SP05 installer on additional host systems, connecting to the same external data base, to create a cluster of SAP Mobile Platform Servers.

You can also upgrade an existing SAP Mobile Platform 2.3.x installation, or an existing MBO Runtime 3.0 installation, to MBO Runtime SP05. For cluster installations, you upgrade the MBO Runtime database (called the data tier) first, by running the MBO Runtime SP05 installer directly on the data tier node. For a single-server upgrade, and upgrade of individual servers within a cluster, the SAP Mobile Platform Server SP05 installer launches the MBO Runtime Server SP05 installer on completion of the SAP Mobile Platform SP05 upgrade.

Related Information

Upgrading SAP Mobile Platform 3.0 Server to SP05 [page 5]Upgrading SAP Mobile Platform 2.3.x Server to SAP Mobile Platform 3.0 SP05 [page 28]Troubleshooting [page 36]

4P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved.

Upgrade: SAP Mobile Platform Server for WindowsUpgrade: SAP Mobile Platform Server for Windows

Page 5: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

2 Upgrading SAP Mobile Platform 3.0 Server to SP05Run the SAP Mobile Platform SP05 installer on your single-server 3.0.x installation. Then use the same installer on additional servers to create a cluster and add nodes.

Prerequisites

If you are planning to upgrade an MBO Runtime installation to SP05 at the same time that you upgrade an SAP Mobile Platform 3.0 installation:

● Acquire the MBO Runtime installer separately from the SAP Mobile Platform Server installer. Instructions are provided where you need them.

● To upgrade an MBO Runtime cluster installation, you must upgrade the data tier(s) first, before running the SAP Mobile Platform Server installer. Refer to the upgrade topic for your MBO Runtime cluster installation scenario in the Installation and Upgrade: MBO Runtime Server document to guide you through acquiring and running the MBO Runtime installer to upgrade your data tier(s).

● To upgrade a single-server MBO Runtime installation, or any server node in an MBO Runtime cluster, you must start with this document to guide you through the upgrade of your SAP Mobile Platform Server installation, launch the MBO Runtime installer from the SAP Mobile Platform Server installer, and continue with the Installation and Upgrade: MBO Runtime Server document to guide you through the upgrade of your MBO Runtime installation. Depending on the installation scenario used in your MBO Runtime installation (single server, simple load balancing cluster, standard Microsoft Failover Cluster, or Microsoft Failover Cluster with shared hosts), you may have to cycle back and forth between the Installation and Upgrade: MBO Runtime Server document and this document to complete the combined upgrade.

1. Upgrading an Existing 3.0 Server to SP05 [page 5]Upgrade your single-server SAP Mobile Platform 3.0 installation to Support Package 05.

2. Adding Cluster Nodes [page 12]After upgrading a single-server production installation to SP05, you can use the same installer to install additional version 3.0 SP05 SAP Mobile Platform Servers on different computers. When these SAP Mobile Platform Servers share a single, external database, each server acts as a node in a cluster of servers.

2.1 Upgrading an Existing 3.0 Server to SP05

Upgrade your single-server SAP Mobile Platform 3.0 installation to Support Package 05.

This section guides you through the process of upgrading an existing SAP® Mobile Platform 3.0 installation with Support Package 05. The SP05 upgrade installation preserves all configuration changes and applications in the 3.0 installation, except for server log levels. Upgrading to SP05 resets any server log levels you have changed to the default values.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading SAP Mobile Platform 3.0 Server to SP05

P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved. 5

Page 6: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

Context

To upgrade your current single-server 3.0 production installation to a cluster, complete the tasks in this section to upgrade the original SAP Mobile Platform Server installation to SP05, then see Adding Cluster Nodes [page 12]

NoteYou cannot upgrade a single-server development installation, which uses the internal Derby database, to a cluster. A single-server installation must use an external custom database in order to be upgraded to a cluster.

1. Acquiring the Support Package Installer [page 6]Acquire the SAP Mobile Platform Server SP05 .zip file and extract its contents to create the installer image.

2. Preparing to Upgrade [page 7]Ensure that the host on which you are upgrading SAP Mobile Platform is ready for you to begin the upgrade installation.

3. Running the Support Package Installer [page 9]To upgrade an existing SAP Mobile Platform Server installation, start the SP05 installer, accept the current installation directory, and let the installer complete the upgrade process.

4. Verifying the Upgrade [page 10]Check for errors in the installation log file, then verify that you can start the server and log in to Management Cockpit.

5. Upgrading Tomcat Server sslEnabledProtocols Property for Agentry Applications on iOS 7 [page 11]If your SAP Mobile Platform installation supports Agentry applications on iOS 7 devices, upgrade the Tomcat Server sslEnabledProtocols property to avoid slow transmits.

2.1.1 Acquiring the Support Package Installer

Acquire the SAP Mobile Platform Server SP05 .zip file and extract its contents to create the installer image.

Procedure

1. Use one of these methods:

○ Insert the physical installation media.○ Download from the software distribution center on SAP Service Marketplace:

1. Go to http://service.sap.com/swdc .2. Agree to the terms displayed and log in to the Web site.3. Under "A-Z Index" click Installations and Upgrades.4. Click M.5. Click SAP MOBILE PLATFORM.

6P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading SAP Mobile Platform 3.0 Server to SP05

Page 7: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

6. Click the link for the current version.7. Click the link for SP05.8. Download the package for the SAP Mobile Platform Server SP05 installer.9. Extract the entire contents of the installer .zip file to a temporary directory on a local disk on the

target host.Use a short path, preferably a folder directly below the root directory, such as C:\temp. The path can include only ASCII alphanumeric characters, underscore ( _ ), hyphen ( - ), and period (.). Two consecutive period characters are not allowed.If you also want to install or upgrade the MBO Runtime component, the MBO Runtime SP05 installer .zip file must be available when you run the SAP Mobile Platform Server installer. Follow the steps above to download the MBO Runtime SP05 installer .zip file; after you click the for SP05, download the package for the MBO Runtime SP05 installer. Then:

○ To install or upgrade an MBO Runtime data tier, extract the contents of the MBO Runtime installer .zip file to a temporary location on the target host.

○ For a single-server MBO Runtime installation, or installation of a single MBO Runtime Server in a cluster, make the MBO Runtime installer .zip file available on the target host, where the SAP Mobile Platform Server SP05 installer will prompt you for its location, and then extract and run it.

○ Download from your network.

2.1.2 Preparing to Upgrade

Ensure that the host on which you are upgrading SAP Mobile Platform is ready for you to begin the upgrade installation.

Context

The system requirements may have changed since you installed the earlier version of SAP Mobile Platform.

Procedure

1. Before proceeding with this upgrade, verify that your existing SAP Mobile Platform installation meets these requirements:

○ The SAP Mobile Platform installation is version 3.0.○ The SAP Mobile Platform 3.0 installation is either:

○ The original version 3.0 installation.○ The original version 3.0 installation upgraded to any support package (SP) number, with any

patch level (PL) applied.2. Confirm that the installation target host meets minimum system requirements for SAP Mobile Platform

3.0 SP05.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading SAP Mobile Platform 3.0 Server to SP05

P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved. 7

Page 8: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

See the SAP Product Availability Matrix (PAM) http://service.sap.com/pam . Click the Mobile link at the top of the page. Scroll to find the appropriate product and version in the product list.

3. Verify that you have Administrator privileges on the installation target host.4. Remove the JAVA_TOOL_OPTIONS environment variable.

Check for JAVA_TOOL_OPTIONS in both User Variables and System Variables panes of the Environment Variables dialog.a. Right-click My Computer and select Properties.b. Select Advanced System Settings.c. Click the Advanced tab.d. Click Environment Variables.e. Select JAVA_TOOL_OPTIONS and click Delete.f. Click OK to exit all dialogs.

5. Verify that the SAP Mobile Platform Server is running.

Check the status of the SAP Mobile Platform Server service in the Windows Services Control Panel. Start it if it is not already started.

Check the server log at <SMP_HOME>\Server\log\<host_name>-smp-server.log. The server has not fully started until this line appears in the server log:

The SMP server has initialized and is ready.

6. Shut down all other Sybase® and SAP software and processes, and associated third-party processes, running on the installation target host.

To verify that services are stopped, open the Services pane from Windows Control Panel.7. To accommodate SAP Mobile Platform internal communications, you may need to reconfigure intrusion

detection/prevention systems (either hardware- or software-based).See Intrusion Detection and Protection Requirements in Landscape Planning and Design.

8. Verify that the target host has Runtime versions of Microsoft Visual Studio C++ 2005, 2008, and 2010 installed.You can install these from the \modules\redist folder in the installer image.

9. Verify that the target host has .NET Framework version 4.0 or higher installed.You can install this from the Microsoft Web site. Restart the computer after installing.

8P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading SAP Mobile Platform 3.0 Server to SP05

Page 9: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

2.1.3 Running the Support Package Installer

To upgrade an existing SAP Mobile Platform Server installation, start the SP05 installer, accept the current installation directory, and let the installer complete the upgrade process.

Context

NoteThe installation path you accept below was set when you installed version 3.0 and is referred to as <SMP_HOME> in the rest of these instructions.

Procedure

1. Browse to the root directory of the SAP Mobile Platform installer, right-click the setupAMD64.exe file and select Run as Administrator.

NoteThe installer displays an Initializing wizard... message while it verifies the integrity of the installation image. It may take a few minutes for the first installer panel to appear.

2. On the installer welcome page, click Next.3. Accept the path to the current installation location.

You cannot change the installation directory when you install a support package.4. If you are upgrading from SP03, enter the Windows account information.

Set the Start SAP Mobile Platform Server service automatically when Windows starts up check box as desired to control whether SAP Mobile Platform Server service starts after each Windows start-up.

You cannot change the Windows account user name, smpServiceUser. You must enter the current password.

5. On the summary information page, click Upgrade.6. (Optional) To launch the MBO Runtime installer when the SAP Mobile Platform Server installer closes:

a. Select the check box to enable launching the MBO Runtime installer.b. Enter or browse to the complete path to the location of the .zip file for the MBO Runtime installer.

7. Click Next to launch the SAP Mobile Platform Server installation process.8. Click Finish.

Next Steps

Proceed directly to the next task: Verifying the Upgrade [page 10]

Upgrade: SAP Mobile Platform Server for WindowsUpgrading SAP Mobile Platform 3.0 Server to SP05

P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved. 9

Page 10: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

If you selected the option to launch the MBO Runtime installer, do not wait for that installer to open:

● Verify the SAP Mobile Platform Server installation before proceeding.● When the MBO Runtime installer opens, do not proceed with that installation until you have verified the

SAP Mobile Platform Server installation.

2.1.4 Verifying the Upgrade

Check for errors in the installation log file, then verify that you can start the server and log in to Management Cockpit.

Procedure

1. Check the latest installation log at <SMP_HOME>\InstallLogs\SMPInstall<date-time>.log.

<SMP_HOME> is the current installation location you accepted (the default is C:\SAP\MobilePlatform<XX>).

A search for "error" should not find anything.2. Open the Services panel from Windows Control Panel. If SAP Mobile Platform Server service is not started,

verify that you can start it manually.

Check the server log at <SMP_HOME>\Server\log\<host_name>-smp-server.log. The server has not fully started until this line appears in the server log:

The SMP server has initialized and is ready.

3. From Windows, select Start (All) Programs SAP Mobile Server 3.0 Management Cockpit .Ignore any "untrusted certificate" errors displayed.

Next Steps

● If you are also upgrading an MBO Runtime installation, go to the 3.0 Installation and Upgrade: MBO Runtime Server document, and continue with the section for upgrading the installation scenario used in your MBO Runtime installation (single server, simple load balancing cluster, standard Microsoft Failover Cluster, or Microsoft Failover Cluster with shared hosts).

● If this installer run completes your upgrade scenario, go on to Postinstallation Landscape Setup in the 3.0 SP05 Administrator document.

● If you need to add SAP Mobile Platform Server nodes to form a cluster, go on to Adding Cluster Nodes [page 12].

10P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading SAP Mobile Platform 3.0 Server to SP05

Page 11: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

2.1.5 Upgrading Tomcat Server sslEnabledProtocols Property for Agentry Applications on iOS 7

If your SAP Mobile Platform installation supports Agentry applications on iOS 7 devices, upgrade the Tomcat Server sslEnabledProtocols property to avoid slow transmits.

The sslEnabledProtocols properties for Tomcat HTTP listener ports are located in <SMP_HOME>\Server\config_master\org.eclispe.gemini.web.tomcat\default-server.xml. Create a backup copy of this file before making any changes.

NoteIn a clustered server environment, you must update the file on each server node.

1. Open the default-server.xml file in a text editor.2. In each of the lines below, replace sslEnabledProtocols="TLSv1" with

sslEnabledProtocols="TLSv1,TLSv1.1,TLSv1.2":

...<Connector smpConnectorName="oneWaySSL" ......clientAuth="false" sslProtocol="TLS" sslEnabledProtocols="TLSv1" />...<Connector smpConnectorName="AdminSSL" ......clientAuth="false" sslProtocol="TLS" sslEnabledProtocols="TLSv1" smpServiceType="admin" ......<Connector smpConnectorName="mutualSSL" ......keyAlias="smp_crt" clientAuth="true" sslProtocol="TLS" sslEnabledProtocols="TLSv1"/>...

3. Save the file and restart SAP Mobile Platform Server.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading SAP Mobile Platform 3.0 Server to SP05

P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved. 11

Page 12: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

2.2 Adding Cluster Nodes

After upgrading a single-server production installation to SP05, you can use the same installer to install additional version 3.0 SP05 SAP Mobile Platform Servers on different computers. When these SAP Mobile Platform Servers share a single, external database, each server acts as a node in a cluster of servers.

Context

NoteAll nodes added to a cluster use the same communication port numbers specified for the first server that was installed in the cluster. Make sure these port numbers are available on the node where your are installing the additional SAP Mobile Platform Server for the cluster.

1. Running the Support Package Installer [page 12]Start the SAP Mobile Platform Server installer, accept the end-user license agreement, select Production Installation and provide database information needed to connect to the original same external database used by the single-server installation you upgraded to SP05.

2. Verifying the Added Node [page 15]Check for errors in the installation logs, then verify that you can start the server and log in to Management Cockpit.

2.2.1 Running the Support Package Installer

Start the SAP Mobile Platform Server installer, accept the end-user license agreement, select Production Installation and provide database information needed to connect to the original same external database used by the single-server installation you upgraded to SP05.

Context

The installation path you specify below is referred to as <SMP_HOME> in the rest of these installation instructions.

Procedure

1. Browse to the root directory of the SAP Mobile Platform installer, right-click the setupAMD64.exe file and select Run as Administrator.

12P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading SAP Mobile Platform 3.0 Server to SP05

Page 13: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

NoteThe installer displays an Initializing wizard... message while it verifies the integrity of the installation image. It may take a few minutes for the first installer panel to appear.

2. On the installer welcome page, click Next.3. On the end-user license agreement page, select your country, accept the terms of the license agreement

and click Next.4. Specify the absolute path to the installation location, which must be on a local drive on the target host.

The total length of the path must be 38 characters or less.

Directory names in the path can contain only:

○ ASCII alphanumeric characters.○ Underscore ( _ ), hyphen ( - ), and period (.) characters. Two consecutive period characters are not

allowed, and none of these characters may appear as the first character in a folder name.5. Select Production installation as the installation type.6. On the database server configuration panel, specify your database information:

First select Use another database you have already installed – this is required for SAP Mobile Platform in a cluster installation, and for a production installation in a single server or a cluster – then specify the information necessary to connect to that database:

○ Select database type – select the specific database type you have installed: SAP HANA, SAP ASE, DB2, Oracle (Service Name), or Oracle (SID).

○ Host name – the fully qualified domain name or static IP address of the database server.○ Port number – the listening port of the database server. Default values:

○ SAP HANA – 30015 (formed by concatenating "3" plus the two-digit HANA instance number plus "15")

○ SAP ASE – 5000○ DB2 – 50000○ Oracle – 1521

○ Login – enter gomobile, or the new user name if you changed it from the default.○ Password – enter secret, or the new user password if you changed it from the default.○ Database name (SAP ASE or DB2), Service name (Oracle accessed by service name), or SID (Oracle

accessed by SID) – enter smp3, or the new database name, if you changed it from the default.

○ Oracle service name is the TNS alias used for a remote connection.○ Oracle SID is a name that uniquely identifies the database instance on the database server.

○ Path to Oracle JDBC driver – (Oracle only) enter the fully qualified path, including the JAR file name, to the type 4 Oracle JDBC driver.

○ Select Use another database you have already installed – this is required for SAP Mobile Platform in a cluster installation, and for a production installation in a single server or a cluster.

If the installer displays a Cannot connect to database error:

1. Verify that the database server is running.If it is not running, start it, then click Retry in the message box, and click Next.

2. If the database server is running, check all the values entered on the database server configuration panel.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading SAP Mobile Platform 3.0 Server to SP05

P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved. 13

Page 14: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

If any are incorrect, click Retry in the message box, correct the entries, and click Next on the database server configuration panel.

3. If the database server is running and all entries on the database server configuration panel appear to be correct, check the log at <SMP_HOME>\InstallLogs\SMPInstall<date-time>.log.

a. Examine the messages in the log file, starting at the end and working backward, to find more information about the database connection failure.

b. Correct any problems logged.c. Return to the database server configuration panel and click Retry in the message box, and click

Next.7. Enter admin user credentials for your SAP Mobile Platform installation.

All these entries are case-sensitive.

○ Keystore password – the password that will be required to access the keystore, where SAP Mobile Platform Server stores certificates and private keys.

CautionThe keystore password you enter here must match exactly the keystore value you entered for the first server node in the cluster.

For the keystore password, only alphabetic and numeric characters, space, period, colon, dash, and hyphen are allowed. The following characters are not allowed: ! ? , ; " ' ` + * ^ / \ | = ~ < > @ # $ % & ( ) [ ] { }

8. Accept the port numbers to use for the SAP Mobile Platform Server HTTP and HTTPS communication ports and click Next.

NoteThese port numbers were set when you installed the first server node in the cluster – you cannot change them now.

If any of these port numbers are not free, you must free them up before you can proceed with installation on this node.

9. Enter the Windows account information.

Set the Start SAP Mobile Platform Server service automatically when Windows starts up check box as desired to control whether SAP Mobile Platform Server service starts after each Windows start-up.

You cannot change the Windows account user name, smpServiceUser. If this account already exists, you must enter the current password.

NoteIf you get an error message:

○ Beginning with,Failed to create a Windows User account smpServiceUser...Click Next to retry or you can create the account manually. See Setting Up a User Account for the SAP Mobile Platform Windows Service in Administrator. After the account is created manually, click Next to continue.

○ Beginning with,

14P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading SAP Mobile Platform 3.0 Server to SP05

Page 15: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

Failed to create Windows service SAPSMPTestUserLogonService...Check the log at <SMP_HOME>\InstallLogs\SMPInstall<date-time>.log and resolve any issues.

○ Beginning with,Failed to start SAPSMPTestUserLogonService service...Click Retry to try to set the service LOGON permission again or click Proceed to continue.If you click Proceed, the server’s Windows service cannot be started after installation until its LOGON permission has been properly set. See troubleshooting topic, Failed to Start SAPSMPTestUserLogonService Service Error [page 40].

10. On the summary information page, click Install.11. (Optional) To launch the MBO Runtime installer when the SAP Mobile Platform Server installer closes:

a. Select the check box to enable launching the MBO Runtime installer.b. Enter or browse to the complete path to the location of the .zip file for the MBO Runtime installer.

12. Click Next to launch the SAP Mobile Platform Server installation process.13. Click Finish.

Next Steps

Proceed directly to the next task: Verifying the Added Node [page 15]

If you selected the option to launch the MBO Runtime installer, do not wait for that installer to open:

● Verify the SAP Mobile Platform Server installation before proceeding.● When the MBO Runtime installer opens, do not proceed with that installation until you have verified the

SAP Mobile Platform Server installation.

2.2.2 Verifying the Added Node

Check for errors in the installation logs, then verify that you can start the server and log in to Management Cockpit.

Procedure

1. Check the installation log at <SMP_HOME>\InstallLogs\SMPInstall<date-time>.log.

<SMP_HOME> is the installation location you specified (the default is C:\SAP\MobilePlatform<XX>).

A search for "error" should not find anything.2. Open the Services panel from Windows Control Panel. If SAP Mobile Platform Server service is not started,

verify that you can start it manually.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading SAP Mobile Platform 3.0 Server to SP05

P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved. 15

Page 16: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

Check the server log at <SMP_HOME>\Server\log\<host_name>-smp-server.log. The server has not fully started until this line appears in the server log:

The SMP server has initialized and is ready.

3. From Windows, select Start (All) Programs SAP Mobile Server 3.0 Management Cockpit .Ignore any "untrusted certificate" errors displayed.

4. Verify that this server has been added to the cluster.a. Navigate to the Cluster tab.b. Verify that the node you just installed appears.

Nodes are identified by host name.c. Click the node to see additional information.

Next Steps

If you are also performing an MBO Runtime Server installation, go on to the appropriate section of the chapter for your installation scenario in Installation: MBO Runtime Server:

● Installing MBO Runtime on a Single Server● Installing MBO Runtime in a Simple Load Balancing Cluster● Installing MBO Runtime with a Standard Microsoft Failover Cluster● Installing MBO Runtime with a Standard Microsoft Failover Cluster with Shared Hosts

If you are not performing an MBO Runtime Server installation:

● If this installer run completes your SAP Mobile Platform landscape, go on to Postinstallation Landscape Setup in the 3.0 SP05 Administrator document.

● If you need to install additional SAP Mobile Platform Server nodes, go on to Adding Cluster Nodes.

16P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading SAP Mobile Platform 3.0 Server to SP05

Page 17: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

3 Upgrading an SAP Mobile Platform 3.0 Cluster to SP05Upgrade your SAP Mobile Platform 3.0 cluster installation to support package 04.

Context

This section guides you through the process of upgrading an existing SAP Mobile Platform 3.0 cluster installation with Support Package 05. The SP05 upgrade installation preserves all configuration changes and applications in the 3.0 installation, except for server log levels. Upgrading to SP05 resets any server log levels you have changed to the default values.

NoteIf you are also upgrading an MBO Runtime cluster installation, you must upgrade the data tier(s) for the MBO Runtime cluster before you start upgrading the server nodes in your SAP Mobile Platform cluster. In the Installation and Upgrade: MBO Runtime Server document, locate the Upgrading MBO Runtime to SP04 chapter, begin at the start of the section for the type of MBO Runtime cluster you are upgrading:

● Upgrading a Simple Load-Balancing Cluster● Upgrading a Standard Microsoft Failover Cluster● Upgrading a Microsoft Failover Cluster with Shared Hosts

1. Upgrading Each SAP Mobile Platform 3.0 Server to SP05 [page 17]Upgrade each server in your SAP Mobile Platform 3.0 cluster installation to support package 04.

2. Adding Cluster Nodes [page 23]After upgrading an existing cluster installation to SP05, you can use the same installer to install additional nodes in the cluster.

3.1 Upgrading Each SAP Mobile Platform 3.0 Server to SP05

Upgrade each server in your SAP Mobile Platform 3.0 cluster installation to support package 04.

1. Acquiring the Support Package Installer [page 18]Acquire the SAP Mobile Platform Server SP05 .zip file and extract its contents to create the installer image.

2. Preparing to Upgrade [page 19]Ensure that the host on which you are upgrading SAP Mobile Platform is ready for you to begin the upgrade installation.

3. Running the Support Package Installer [page 20]To upgrade an existing SAP Mobile Platform Server installation, start the SP05 installer, accept the current installation directory, and let the installer complete the upgrade process.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading an SAP Mobile Platform 3.0 Cluster to SP05

P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved. 17

Page 18: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

4. Verifying the Upgrade [page 21]Check for errors in the installation log file, then verify that you can start the server and log in to Management Cockpit.

5. Upgrading Tomcat Server sslEnabledProtocols Property for Agentry Applications on iOS 7 [page 22]If your SAP Mobile Platform installation supports Agentry applications on iOS 7 devices, upgrade the Tomcat Server sslEnabledProtocols property to avoid slow transmits.

3.1.1 Acquiring the Support Package Installer

Acquire the SAP Mobile Platform Server SP05 .zip file and extract its contents to create the installer image.

Procedure

1. Use one of these methods:

○ Insert the physical installation media.○ Download from the software distribution center on SAP Service Marketplace:

1. Go to http://service.sap.com/swdc .2. Agree to the terms displayed and log in to the Web site.3. Under "A-Z Index" click Installations and Upgrades.4. Click M.5. Click SAP MOBILE PLATFORM.6. Click the link for the current version.7. Click the link for SP05.8. Download the package for the SAP Mobile Platform Server SP05 installer.9. Extract the entire contents of the installer .zip file to a temporary directory on a local disk on the

target host.Use a short path, preferably a folder directly below the root directory, such as C:\temp. The path can include only ASCII alphanumeric characters, underscore ( _ ), hyphen ( - ), and period (.). Two consecutive period characters are not allowed.If you also want to install or upgrade the MBO Runtime component, the MBO Runtime SP05 installer .zip file must be available when you run the SAP Mobile Platform Server installer. Follow the steps above to download the MBO Runtime SP05 installer .zip file; after you click the for SP05, download the package for the MBO Runtime SP05 installer. Then:

○ To install or upgrade an MBO Runtime data tier, extract the contents of the MBO Runtime installer .zip file to a temporary location on the target host.

○ For a single-server MBO Runtime installation, or installation of a single MBO Runtime Server in a cluster, make the MBO Runtime installer .zip file available on the target host, where the SAP Mobile Platform Server SP05 installer will prompt you for its location, and then extract and run it.

○ Download from your network.

18P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading an SAP Mobile Platform 3.0 Cluster to SP05

Page 19: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

3.1.2 Preparing to Upgrade

Ensure that the host on which you are upgrading SAP Mobile Platform is ready for you to begin the upgrade installation.

Context

The system requirements may have changed since you installed the earlier version of SAP Mobile Platform.

Procedure

1. Before proceeding with this upgrade, verify that your existing SAP Mobile Platform installation meets these requirements:

○ The SAP Mobile Platform installation is version 3.0.○ The SAP Mobile Platform 3.0 installation is either:

○ The original version 3.0 installation.○ The original version 3.0 installation upgraded to any support package (SP) number, with any

patch level (PL) applied.2. Confirm that the installation target host meets minimum system requirements for SAP Mobile Platform

3.0 SP05.

See the SAP Product Availability Matrix (PAM) http://service.sap.com/pam . Click the Mobile link at the top of the page. Scroll to find the appropriate product and version in the product list.

3. Verify that you have Administrator privileges on the installation target host.4. Remove the JAVA_TOOL_OPTIONS environment variable.

Check for JAVA_TOOL_OPTIONS in both User Variables and System Variables panes of the Environment Variables dialog.a. Right-click My Computer and select Properties.b. Select Advanced System Settings.c. Click the Advanced tab.d. Click Environment Variables.e. Select JAVA_TOOL_OPTIONS and click Delete.f. Click OK to exit all dialogs.

5. Verify that the SAP Mobile Platform Server is running.

Check the status of the SAP Mobile Platform Server service in the Windows Services Control Panel. Start it if it is not already started.

Check the server log at <SMP_HOME>\Server\log\<host_name>-smp-server.log. The server has not fully started until this line appears in the server log:

The SMP server has initialized and is ready.

6. Shut down all other Sybase® and SAP software and processes, and associated third-party processes, running on the installation target host.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading an SAP Mobile Platform 3.0 Cluster to SP05

P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved. 19

Page 20: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

To verify that services are stopped, open the Services pane from Windows Control Panel.7. To accommodate SAP Mobile Platform internal communications, you may need to reconfigure intrusion

detection/prevention systems (either hardware- or software-based).See Intrusion Detection and Protection Requirements in Landscape Planning and Design.

8. Verify that the target host has Runtime versions of Microsoft Visual Studio C++ 2005, 2008, and 2010 installed.You can install these from the \modules\redist folder in the installer image.

9. Verify that the target host has .NET Framework version 4.0 or higher installed.You can install this from the Microsoft Web site. Restart the computer after installing.

3.1.3 Running the Support Package Installer

To upgrade an existing SAP Mobile Platform Server installation, start the SP05 installer, accept the current installation directory, and let the installer complete the upgrade process.

Context

NoteThe installation path you accept below was set when you installed version 3.0 and is referred to as <SMP_HOME> in the rest of these instructions.

Procedure

1. Browse to the root directory of the SAP Mobile Platform installer, right-click the setupAMD64.exe file and select Run as Administrator.

NoteThe installer displays an Initializing wizard... message while it verifies the integrity of the installation image. It may take a few minutes for the first installer panel to appear.

2. On the installer welcome page, click Next.3. Accept the path to the current installation location.

You cannot change the installation directory when you install a support package.4. If you are upgrading from SP03, enter the Windows account information.

Set the Start SAP Mobile Platform Server service automatically when Windows starts up check box as desired to control whether SAP Mobile Platform Server service starts after each Windows start-up.

You cannot change the Windows account user name, smpServiceUser. You must enter the current password.

20P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading an SAP Mobile Platform 3.0 Cluster to SP05

Page 21: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

5. On the summary information page, click Upgrade.6. (Optional) To launch the MBO Runtime installer when the SAP Mobile Platform Server installer closes:

a. Select the check box to enable launching the MBO Runtime installer.b. Enter or browse to the complete path to the location of the .zip file for the MBO Runtime installer.

7. Click Next to launch the SAP Mobile Platform Server installation process.8. Click Finish.

Next Steps

Proceed directly to the next task: Verifying the Upgrade [page 10]

If you selected the option to launch the MBO Runtime installer, do not wait for that installer to open:

● Verify the SAP Mobile Platform Server installation before proceeding.● When the MBO Runtime installer opens, do not proceed with that installation until you have verified the

SAP Mobile Platform Server installation.

3.1.4 Verifying the Upgrade

Check for errors in the installation log file, then verify that you can start the server and log in to Management Cockpit.

Procedure

1. Check the latest installation log at <SMP_HOME>\InstallLogs\SMPInstall<date-time>.log.

<SMP_HOME> is the current installation location you accepted (the default is C:\SAP\MobilePlatform<XX>).

A search for "error" should not find anything.2. Open the Services panel from Windows Control Panel. If SAP Mobile Platform Server service is not started,

verify that you can start it manually.

Check the server log at <SMP_HOME>\Server\log\<host_name>-smp-server.log. The server has not fully started until this line appears in the server log:

The SMP server has initialized and is ready.

3. From Windows, select Start (All) Programs SAP Mobile Server 3.0 Management Cockpit .Ignore any "untrusted certificate" errors displayed.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading an SAP Mobile Platform 3.0 Cluster to SP05

P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved. 21

Page 22: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

Next Steps

● If you are also upgrading an MBO Runtime installation, go to the 3.0 Installation and Upgrade: MBO Runtime Server document, and continue with the section for upgrading the installation scenario used in your MBO Runtime installation (single server, simple load balancing cluster, standard Microsoft Failover Cluster, or Microsoft Failover Cluster with shared hosts).

● If this installer run completes your upgrade scenario, go on to Postinstallation Landscape Setup in the 3.0 SP05 Administrator document.

● If you need to add SAP Mobile Platform Server nodes to form a cluster, go on to Adding Cluster Nodes [page 12].

3.1.5 Upgrading Tomcat Server sslEnabledProtocols Property for Agentry Applications on iOS 7

If your SAP Mobile Platform installation supports Agentry applications on iOS 7 devices, upgrade the Tomcat Server sslEnabledProtocols property to avoid slow transmits.

The sslEnabledProtocols properties for Tomcat HTTP listener ports are located in <SMP_HOME>\Server\config_master\org.eclispe.gemini.web.tomcat\default-server.xml. Create a backup copy of this file before making any changes.

NoteIn a clustered server environment, you must update the file on each server node.

1. Open the default-server.xml file in a text editor.2. In each of the lines below, replace sslEnabledProtocols="TLSv1" with

sslEnabledProtocols="TLSv1,TLSv1.1,TLSv1.2":

...<Connector smpConnectorName="oneWaySSL" ......clientAuth="false" sslProtocol="TLS" sslEnabledProtocols="TLSv1" />...<Connector smpConnectorName="AdminSSL" ......clientAuth="false" sslProtocol="TLS" sslEnabledProtocols="TLSv1" smpServiceType="admin" ......<Connector smpConnectorName="mutualSSL" ......keyAlias="smp_crt" clientAuth="true" sslProtocol="TLS" sslEnabledProtocols="TLSv1"/>...

3. Save the file and restart SAP Mobile Platform Server.

22P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading an SAP Mobile Platform 3.0 Cluster to SP05

Page 23: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

3.2 Adding Cluster Nodes

After upgrading an existing cluster installation to SP05, you can use the same installer to install additional nodes in the cluster.

1. Running the Support Package Installer [page 23]Start the SAP Mobile Platform Server installer, accept the end-user license agreement, select Production Installation and provide database information needed to connect to the original same external database used by the single-server installation you upgraded to SP05.

2. Verifying the Added Node [page 26]Check for errors in the installation logs, then verify that you can start the server and log in to Management Cockpit.

3.2.1 Running the Support Package Installer

Start the SAP Mobile Platform Server installer, accept the end-user license agreement, select Production Installation and provide database information needed to connect to the original same external database used by the single-server installation you upgraded to SP05.

Context

The installation path you specify below is referred to as <SMP_HOME> in the rest of these installation instructions.

Procedure

1. Browse to the root directory of the SAP Mobile Platform installer, right-click the setupAMD64.exe file and select Run as Administrator.

NoteThe installer displays an Initializing wizard... message while it verifies the integrity of the installation image. It may take a few minutes for the first installer panel to appear.

2. On the installer welcome page, click Next.3. On the end-user license agreement page, select your country, accept the terms of the license agreement

and click Next.4. Specify the absolute path to the installation location, which must be on a local drive on the target host.

The total length of the path must be 38 characters or less.

Directory names in the path can contain only:

Upgrade: SAP Mobile Platform Server for WindowsUpgrading an SAP Mobile Platform 3.0 Cluster to SP05

P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved. 23

Page 24: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

○ ASCII alphanumeric characters.○ Underscore ( _ ), hyphen ( - ), and period (.) characters. Two consecutive period characters are not

allowed, and none of these characters may appear as the first character in a folder name.5. Select Production installation as the installation type.6. On the database server configuration panel, specify your database information:

First select Use another database you have already installed – this is required for SAP Mobile Platform in a cluster installation, and for a production installation in a single server or a cluster – then specify the information necessary to connect to that database:

○ Select database type – select the specific database type you have installed: SAP HANA, SAP ASE, DB2, Oracle (Service Name), or Oracle (SID).

○ Host name – the fully qualified domain name or static IP address of the database server.○ Port number – the listening port of the database server. Default values:

○ SAP HANA – 30015 (formed by concatenating "3" plus the two-digit HANA instance number plus "15")

○ SAP ASE – 5000○ DB2 – 50000○ Oracle – 1521

○ Login – enter gomobile, or the new user name if you changed it from the default.○ Password – enter secret, or the new user password if you changed it from the default.○ Database name (SAP ASE or DB2), Service name (Oracle accessed by service name), or SID (Oracle

accessed by SID) – enter smp3, or the new database name, if you changed it from the default.

○ Oracle service name is the TNS alias used for a remote connection.○ Oracle SID is a name that uniquely identifies the database instance on the database server.

○ Path to Oracle JDBC driver – (Oracle only) enter the fully qualified path, including the JAR file name, to the type 4 Oracle JDBC driver.

○ Select Use another database you have already installed – this is required for SAP Mobile Platform in a cluster installation, and for a production installation in a single server or a cluster.

If the installer displays a Cannot connect to database error:

1. Verify that the database server is running.If it is not running, start it, then click Retry in the message box, and click Next.

2. If the database server is running, check all the values entered on the database server configuration panel.If any are incorrect, click Retry in the message box, correct the entries, and click Next on the database server configuration panel.

3. If the database server is running and all entries on the database server configuration panel appear to be correct, check the log at <SMP_HOME>\InstallLogs\SMPInstall<date-time>.log.

a. Examine the messages in the log file, starting at the end and working backward, to find more information about the database connection failure.

b. Correct any problems logged.c. Return to the database server configuration panel and click Retry in the message box, and click

Next.7. Enter admin user credentials for your SAP Mobile Platform installation.

All these entries are case-sensitive.

24P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading an SAP Mobile Platform 3.0 Cluster to SP05

Page 25: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

○ Keystore password – the password that will be required to access the keystore, where SAP Mobile Platform Server stores certificates and private keys.

CautionThe keystore password you enter here must match exactly the keystore value you entered for the first server node in the cluster.

For the keystore password, only alphabetic and numeric characters, space, period, colon, dash, and hyphen are allowed. The following characters are not allowed: ! ? , ; " ' ` + * ^ / \ | = ~ < > @ # $ % & ( ) [ ] { }

8. Accept the port numbers to use for the SAP Mobile Platform Server HTTP and HTTPS communication ports and click Next.

NoteThese port numbers were set when you installed the first server node in the cluster – you cannot change them now.

If any of these port numbers are not free, you must free them up before you can proceed with installation on this node.

9. Enter the Windows account information.

Set the Start SAP Mobile Platform Server service automatically when Windows starts up check box as desired to control whether SAP Mobile Platform Server service starts after each Windows start-up.

You cannot change the Windows account user name, smpServiceUser. If this account already exists, you must enter the current password.

NoteIf you get an error message:

○ Beginning with,Failed to create a Windows User account smpServiceUser...Click Next to retry or you can create the account manually. See Setting Up a User Account for the SAP Mobile Platform Windows Service in Administrator. After the account is created manually, click Next to continue.

○ Beginning with,Failed to create Windows service SAPSMPTestUserLogonService...Check the log at <SMP_HOME>\InstallLogs\SMPInstall<date-time>.log and resolve any issues.

○ Beginning with,Failed to start SAPSMPTestUserLogonService service...Click Retry to try to set the service LOGON permission again or click Proceed to continue.If you click Proceed, the server’s Windows service cannot be started after installation until its LOGON permission has been properly set. See troubleshooting topic, Failed to Start SAPSMPTestUserLogonService Service Error [page 40].

10. On the summary information page, click Install.11. (Optional) To launch the MBO Runtime installer when the SAP Mobile Platform Server installer closes:

Upgrade: SAP Mobile Platform Server for WindowsUpgrading an SAP Mobile Platform 3.0 Cluster to SP05

P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved. 25

Page 26: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

a. Select the check box to enable launching the MBO Runtime installer.b. Enter or browse to the complete path to the location of the .zip file for the MBO Runtime installer.

12. Click Next to launch the SAP Mobile Platform Server installation process.13. Click Finish.

Next Steps

Proceed directly to the next task: Verifying the Added Node [page 15]

If you selected the option to launch the MBO Runtime installer, do not wait for that installer to open:

● Verify the SAP Mobile Platform Server installation before proceeding.● When the MBO Runtime installer opens, do not proceed with that installation until you have verified the

SAP Mobile Platform Server installation.

3.2.2 Verifying the Added Node

Check for errors in the installation logs, then verify that you can start the server and log in to Management Cockpit.

Procedure

1. Check the installation log at <SMP_HOME>\InstallLogs\SMPInstall<date-time>.log.

<SMP_HOME> is the installation location you specified (the default is C:\SAP\MobilePlatform<XX>).

A search for "error" should not find anything.2. Open the Services panel from Windows Control Panel. If SAP Mobile Platform Server service is not started,

verify that you can start it manually.

Check the server log at <SMP_HOME>\Server\log\<host_name>-smp-server.log. The server has not fully started until this line appears in the server log:

The SMP server has initialized and is ready.

3. From Windows, select Start (All) Programs SAP Mobile Server 3.0 Management Cockpit .Ignore any "untrusted certificate" errors displayed.

4. Verify that this server has been added to the cluster.a. Navigate to the Cluster tab.b. Verify that the node you just installed appears.

Nodes are identified by host name.c. Click the node to see additional information.

26P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading an SAP Mobile Platform 3.0 Cluster to SP05

Page 27: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

Next Steps

If you are also performing an MBO Runtime Server installation, go on to the appropriate section of the chapter for your installation scenario in Installation: MBO Runtime Server:

● Installing MBO Runtime on a Single Server● Installing MBO Runtime in a Simple Load Balancing Cluster● Installing MBO Runtime with a Standard Microsoft Failover Cluster● Installing MBO Runtime with a Standard Microsoft Failover Cluster with Shared Hosts

If you are not performing an MBO Runtime Server installation:

● If this installer run completes your SAP Mobile Platform landscape, go on to Postinstallation Landscape Setup in the 3.0 SP05 Administrator document.

● If you need to install additional SAP Mobile Platform Server nodes, go on to Adding Cluster Nodes.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading an SAP Mobile Platform 3.0 Cluster to SP05

P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved. 27

Page 28: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

4 Upgrading SAP Mobile Platform 2.3.x Server to SAP Mobile Platform 3.0 SP05Run the SAP Mobile Platform SP05 installer on each server node in your SAP Mobile Platform 2.3.x installation.

Prerequisites

MBO Runtime 3.0 has the same system requirements as SAP Mobile Platform 3.0 SP05. To upgrade an SAP Mobile Platform 2.3.x system that has been installed on a version of Windows that SAP MBO Runtime 3.0 does not support, you must first upgrade the operating system to a currently supported version.

See the SAP Product Availability Matrix (PAM) http://service.sap.com/pam . Click the Mobile link at the top of the page. Scroll to find the appropriate product and version in the product list.

NoteAccess to PAM requires an SAP Service Marketplace login: http://service.sap.com/request-user

For this upgrade scenario, the instructions that follow will direct you to:

● Fill in two sets of worksheets, one for SAP Mobile Platform 3.0 SP05 and another for MBO Runtime 3.0.● Download a .zip file that contains the SAP Mobile Platform 3.0 SP05 installer, and separately download the

MBO Runtime SP05 installer.● For cluster upgrades, extract and run the MBO Runtime SP05 installer directly to upgrade the single SAP

Mobile Platform 2.3.x data tier in a simple load-balancing cluster, or to upgrade both data tiers in a standard Microsoft Failover Cluster.

● For all upgrades, run the SAP Mobile Platform 3.0 SP05 installer – once on a single-server SAP Mobile Platform 2.3.x installation, or once on each server node in an SAP Mobile Platform 2.3.x cluster installation – and when it completes, select the option to launch the MBO Runtime 3.0 installer to upgrade the 2.3.x server.

● Switch between using this document, while you are running the SAP Mobile Platform 3.0 SP05 installer, and using the SAP Mobile Runtime Installation and Upgrade: MBO Runtime Server document, while you are running the MBO Runtime SP05 installer.

1. Acquiring the Support Package Installer [page 29]Acquire the SAP Mobile Platform Server SP05 .zip file and extract its contents to create the installer image.

2. Preparing to Upgrade [page 30]Ensure that the host on which you are installing SAP Mobile Platform is ready for you to begin the installation.

3. Running the Support Package Installer [page 31]Start the SAP Mobile Platform Server installer, accept the end-user license agreement, select Production Installation and provide database information needed to connect to the original same external database used by the single-server installation you upgraded to SP05.

4. Verifying the Upgraded Node [page 34]Check for errors in the installation logs, then verify that you can start the server and log in to Management Cockpit.

28P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading SAP Mobile Platform 2.3.x Server to SAP Mobile Platform 3.0 SP05

Page 29: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

4.1 Acquiring the Support Package Installer

Acquire the SAP Mobile Platform Server SP05 .zip file and extract its contents to create the installer image.

Procedure

1. Use one of these methods:

○ Insert the physical installation media.○ Download from the software distribution center on SAP Service Marketplace:

1. Go to http://service.sap.com/swdc .2. Agree to the terms displayed and log in to the Web site.3. Under "A-Z Index" click Installations and Upgrades.4. Click M.5. Click SAP MOBILE PLATFORM.6. Click the link for the current version.7. Click the link for SP05.8. Download the package for the SAP Mobile Platform Server SP05 installer.9. Extract the entire contents of the installer .zip file to a temporary directory on a local disk on the

target host.Use a short path, preferably a folder directly below the root directory, such as C:\temp. The path can include only ASCII alphanumeric characters, underscore ( _ ), hyphen ( - ), and period (.). Two consecutive period characters are not allowed.If you also want to install or upgrade the MBO Runtime component, the MBO Runtime SP05 installer .zip file must be available when you run the SAP Mobile Platform Server installer. Follow the steps above to download the MBO Runtime SP05 installer .zip file; after you click the for SP05, download the package for the MBO Runtime SP05 installer. Then:

○ To install or upgrade an MBO Runtime data tier, extract the contents of the MBO Runtime installer .zip file to a temporary location on the target host.

○ For a single-server MBO Runtime installation, or installation of a single MBO Runtime Server in a cluster, make the MBO Runtime installer .zip file available on the target host, where the SAP Mobile Platform Server SP05 installer will prompt you for its location, and then extract and run it.

○ Download from your network.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading SAP Mobile Platform 2.3.x Server to SAP Mobile Platform 3.0 SP05

P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved. 29

Page 30: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

4.2 Preparing to Upgrade

Ensure that the host on which you are installing SAP Mobile Platform is ready for you to begin the installation.

Procedure

1. Before proceeding with this upgrade, verify that your existing SAP Mobile Platform installation meets these requirements:

○ The SAP Mobile Platform installation is version 2.3.○ The SAP Mobile Platform 2.3 installation is either:

○ The original version 2.3 installation.○ The original version 2.3 installation upgraded to any support package (SP) number, with any

patch level (PL) applied.2. Verify that the installation target host meets minimum system requirements for SAP Mobile Platform

Server 3.0 SP05.

This includes the requirement for a 64-bit Windows operating system. To upgrade an SAP Mobile Platform 2.3.x system that is installed in a 32-bit Windows environment, you must first upgrade the operating system.

See the SAP Product Availability Matrix (PAM) http://service.sap.com/pam . Click the Mobile link at the top of the page. Scroll to find the appropriate product and version in the product list.

NoteAccess to PAM requires an SAP Service Marketplace login: http://service.sap.com/request-user

3. If you are using an external production database (required for a cluster of version 3.0 SP05 SAP Mobile Platform Servers), verify that the database is installed and is running.

See Using a Custom Database in Installation: SAP Mobile Platform Server for your platform.4. If this is not the first server on which you are upgrading first SAP Mobile Platform Server 2.3.x to MBO

Runtime, verify that the SAP Mobile Platform Server (SAP Mobile Platform Server service) is started on the previous server that you upgraded.

5. Verify that you have Administrator privileges on the installation target host.6. Remove the JAVA_TOOL_OPTIONS environment variable.

Check for JAVA_TOOL_OPTIONS in both User Variables and System Variables panes of the Environment Variables dialog.a. Right-click My Computer and select Properties.b. Select Advanced System Settings.c. Click the Advanced tab.d. Click Environment Variables.e. Select JAVA_TOOL_OPTIONS and click Delete.f. Click OK to exit all dialogs.

7. Shut down all Sybase® and SAP software and processes, and associated third-party processes, running on the installation target host.

30P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading SAP Mobile Platform 2.3.x Server to SAP Mobile Platform 3.0 SP05

Page 31: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

To verify that services are stopped, open the Services pane from Windows Control Panel.8. To accommodate SAP Mobile Platform internal communications, you may need to reconfigure intrusion

detection/prevention systems (either hardware- or software-based).See Intrusion Detection and Protection Requirements in Landscape Planning and Design.

9. Verify that the target host has Runtime versions of Microsoft Visual Studio C++ 2005, 2008, and 2010 installed.You can install these from the \modules\redist folder in the installer image.

10. Verify that the target host has .NET Framework version 4.0 or higher installed.You can install this from the Microsoft Web site. Restart the computer after installing.

4.3 Running the Support Package Installer

Start the SAP Mobile Platform Server installer, accept the end-user license agreement, select Production Installation and provide database information needed to connect to the original same external database used by the single-server installation you upgraded to SP05.

Context

The installation path you specify below is referred to as <SMP_HOME> in the rest of these installation instructions.

Procedure

1. Browse to the root directory of the SAP Mobile Platform installer, right-click the setupAMD64.exe file and select Run as Administrator.

NoteThe installer displays an Initializing wizard... message while it verifies the integrity of the installation image. It may take a few minutes for the first installer panel to appear.

2. On the installer welcome page, click Next.3. On the end-user license agreement page, select your country, accept the terms of the license agreement

and click Next.4. Specify the absolute path to the installation location, which must be on a local drive on the target host.

The total length of the path must be 38 characters or less.

Directory names in the path can contain only:

○ ASCII alphanumeric characters.○ Underscore ( _ ), hyphen ( - ), and period (.) characters. Two consecutive period characters are not

allowed, and none of these characters may appear as the first character in a folder name.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading SAP Mobile Platform 2.3.x Server to SAP Mobile Platform 3.0 SP05

P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved. 31

Page 32: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

5. Select Production installation as the installation type.6. On the database server configuration panel, specify your database information:

First select Use another database you have already installed – this is required for SAP Mobile Platform in a cluster installation, and for a production installation in a single server or a cluster – then specify the information necessary to connect to that database:

○ Select database type – select the specific database type you have installed: SAP HANA, SAP ASE, DB2, Oracle (Service Name), or Oracle (SID).

○ Host name – the fully qualified domain name or static IP address of the database server.○ Port number – the listening port of the database server. Default values:

○ SAP HANA – 30015 (formed by concatenating "3" plus the two-digit HANA instance number plus "15")

○ SAP ASE – 5000○ DB2 – 50000○ Oracle – 1521

○ Login – enter gomobile, or the new user name if you changed it from the default.○ Password – enter secret, or the new user password if you changed it from the default.○ Database name (SAP ASE or DB2), Service name (Oracle accessed by service name), or SID (Oracle

accessed by SID) – enter smp3, or the new database name, if you changed it from the default.

○ Oracle service name is the TNS alias used for a remote connection.○ Oracle SID is a name that uniquely identifies the database instance on the database server.

○ Path to Oracle JDBC driver – (Oracle only) enter the fully qualified path, including the JAR file name, to the type 4 Oracle JDBC driver.

○ Select Use another database you have already installed – this is required for SAP Mobile Platform in a cluster installation, and for a production installation in a single server or a cluster.

If the installer displays a Cannot connect to database error:

1. Verify that the database server is running.If it is not running, start it, then click Retry in the message box, and click Next.

2. If the database server is running, check all the values entered on the database server configuration panel.If any are incorrect, click Retry in the message box, correct the entries, and click Next on the database server configuration panel.

3. If the database server is running and all entries on the database server configuration panel appear to be correct, check the log at <SMP_HOME>\InstallLogs\SMPInstall<date-time>.log.

a. Examine the messages in the log file, starting at the end and working backward, to find more information about the database connection failure.

b. Correct any problems logged.c. Return to the database server configuration panel and click Retry in the message box, and click

Next.7. Enter admin user credentials for your SAP Mobile Platform installation.

All these entries are case-sensitive.

○ Keystore password – the password that will be required to access the keystore, where SAP Mobile Platform Server stores certificates and private keys.

32P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading SAP Mobile Platform 2.3.x Server to SAP Mobile Platform 3.0 SP05

Page 33: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

CautionThe keystore password you enter here must match exactly the keystore value you entered for the first server node in the cluster.

For the keystore password, only alphabetic and numeric characters, space, period, colon, dash, and hyphen are allowed. The following characters are not allowed: ! ? , ; " ' ` + * ^ / \ | = ~ < > @ # $ % & ( ) [ ] { }

8. Accept the port numbers to use for the SAP Mobile Platform Server HTTP and HTTPS communication ports and click Next.

NoteThese port numbers were set when you installed the first server node in the cluster – you cannot change them now.

If any of these port numbers are not free, you must free them up before you can proceed with installation on this node.

9. Enter the Windows account information.

Set the Start SAP Mobile Platform Server service automatically when Windows starts up check box as desired to control whether SAP Mobile Platform Server service starts after each Windows start-up.

You cannot change the Windows account user name, smpServiceUser. If this account already exists, you must enter the current password.

NoteIf you get an error message:

○ Beginning with,Failed to create a Windows User account smpServiceUser...Click Next to retry or you can create the account manually. See Setting Up a User Account for the SAP Mobile Platform Windows Service in Administrator. After the account is created manually, click Next to continue.

○ Beginning with,Failed to create Windows service SAPSMPTestUserLogonService...Check the log at <SMP_HOME>\InstallLogs\SMPInstall<date-time>.log and resolve any issues.

○ Beginning with,Failed to start SAPSMPTestUserLogonService service...Click Retry to try to set the service LOGON permission again or click Proceed to continue.If you click Proceed, the server’s Windows service cannot be started after installation until its LOGON permission has been properly set. See troubleshooting topic, Failed to Start SAPSMPTestUserLogonService Service Error [page 40].

10. On the summary information page, click Install.11. (Optional) To launch the MBO Runtime installer when the SAP Mobile Platform Server installer closes:

a. Select the check box to enable launching the MBO Runtime installer.b. Enter or browse to the complete path to the location of the .zip file for the MBO Runtime installer.

12. Click Next to launch the SAP Mobile Platform Server installation process.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading SAP Mobile Platform 2.3.x Server to SAP Mobile Platform 3.0 SP05

P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved. 33

Page 34: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

13. Click Finish.

Next Steps

Proceed directly to the next task: Verifying the Added Node [page 15]

If you selected the option to launch the MBO Runtime installer, do not wait for that installer to open:

● Verify the SAP Mobile Platform Server installation before proceeding.● When the MBO Runtime installer opens, do not proceed with that installation until you have verified the

SAP Mobile Platform Server installation.

4.4 Verifying the Upgraded Node

Check for errors in the installation logs, then verify that you can start the server and log in to Management Cockpit.

Procedure

1. Check the installation log at <SMP_HOME>\InstallLogs\SMPInstall<date-time>.log.

<SMP_HOME> is the installation location you specified (the default is C:\SAP\MobilePlatform<XX>).

A search for "error" should not find anything.2. Open the Services panel from Windows Control Panel. If SAP Mobile Platform Server service is not started,

verify that you can start it manually.

Check the server log at <SMP_HOME>\Server\log\<host_name>-smp-server.log. The server has not fully started until this line appears in the server log:

The SMP server has initialized and is ready.

3. From Windows, select Start (All) Programs SAP Mobile Server 3.0 Management Cockpit .Ignore any "untrusted certificate" errors displayed.

4. For a cluster upgrade, for all but first node upgraded, verify that this server has been added to the cluster.Skip this step on single-server upgrades and on the first SAP Mobile Platform Server 2.3.x node in a cluster that you upgrade to MBO Runtime 3.0.a. Use a text editor to open <SMP_HOME>\Server\log\<hostname>-smp-server.log> file.b. Search for "current addresses" to locate this text:

Current Addresses in cluster: <nodes>. Addresses previously in cluster: <#>

34P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading SAP Mobile Platform 2.3.x Server to SAP Mobile Platform 3.0 SP05

Page 35: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

The value for <nodes> in this line is the number of SAP Mobile Platform Server installations that are now running in this cluster. The value for <#> is the number of nodes to which this server was previously attached. At SAP Mobile Platform Server start-up, this value is always zero.

○ The first server you add to the cluster is node number 2.○ The second server you add to the cluster is node number 3, and so on.○ If you looked in the log for the first server you install, you would see the node number is 1.

If the numbers in this line do not increment as expected after you install an SAP Mobile Platform Server instance, that server has not joined the cluster. See Server Node Does Not Join the Cluster [page 39].

Next Steps

Go on to the appropriate section for your upgrade scenario in the Upgrading From SAP Mobile Platform 2.3.x to MBO Runtime 3.0 chapter in Installation: MBO Runtime Server:

● Upgrading a Single-Server Installation● Upgrading a Simple Load Balancing Cluster● Upgrading a Standard Microsoft Failover Cluster● Upgrading a Standard Microsoft Failover Cluster with Shared Hosts

On completion of the MBO Runtime upgrade task, if your upgrade scenario is not completed, you will be returned to this document to continue the upgrade procedure. If the MBO Runtime upgrade task completes your upgrade scenario, you will be directed to other documents to complete postinstallation tasks.

Upgrade: SAP Mobile Platform Server for WindowsUpgrading SAP Mobile Platform 2.3.x Server to SAP Mobile Platform 3.0 SP05

P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved. 35

Page 36: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

5 TroubleshootingReview information about common problems that arise in the SAP Mobile Platform Server upgrade process.

For information about contacting SAP Technical Support, see Issues Requiring Product Support [page 40].

5.1 Quick Fixes to Simple Problems

Quick fixes are usually common, single-cause problems that you can solve with minimal overhead or additional support.

Fix List

5.1.1 Installation Fails after Canceling Installation

Problem

When you run the installer again after canceling the installation process, the installation fails with a message about files or folders, such as sapjvm_7, that already exist.

Workaround

1. Cancel the installation.2. Manually delete all files and folders under <SMP_HOME>, the installation directory you selected.3. Restart the installer.

36P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved.

Upgrade: SAP Mobile Platform Server for WindowsTroubleshooting

Page 37: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

5.1.2 Server Using Derby Database Fails to Restart after Upgrade

Problem

You have an SAP Mobile Platform Server that uses both of the following:

● internal Derby database● gateway runtime service

After upgrading to Support Package 04, the server fails to restart when it cannot be stopped. The following message displays:Service SAPSMP3Service is not in state 'STOPPED'. Service SAPSMP3Service is in state 'RUNNING' Stopping service SAPSMP3Service.. Stopping SAPSMP3Service Attempt to stop service SAPSMP3Service failed. You must have permission to stop it. Press any key to continue . . .

Workaround

1. Kill the java.exe process associated with SAPSMP3Service.2. Open the <SMP_HOME>\Server\config_master\com.sap.mobile.platform.server.version

\version.properties file in a text editor.3. Locate this text: 04 server_version=3.0.4.0.4. Change 3.0.4.0 to a value that matches the previous SAP Mobile Platform Server version 3.0 support

package from which you upgraded:

○ 3.0.0 for original version 3.0 installation○ 3.0.1 for SP01○ 3.0.2 for SP02○ 3.0.3 for SP03

5. Save the version.properties file.6. Rerun the support package installer.7. Change the 04 server_version value in the version.properties back to 3.0.4.0.

5.1.3 Server Node Does Not Start

Problem

After installing or upgrading a node in the cluster, one or more of the server nodes does not start.

Upgrade: SAP Mobile Platform Server for WindowsTroubleshooting

P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved. 37

Page 38: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

Assess and Correct

Assess the root cause and take the appropriate corrective action.

Root Cause Assessment Correction

The version of the server node is incompatible with the rest of the cluster.

On a server node that is not starting, review the <SMP_HOME>\Server\log\osgi.log for the following message:

The version of this server node (<version number>) is not compatible with the cluster you are attempting to connect to. It must be one of [<compatible version numbers>].

Upgrade the server node to a compatible version, then start the server.

The server node did not connect to the database.

On a server node that is not starting, review the <SMP_HOME>\Server\log\osgi.log for the following message:

Failed to connect to the database on startup. The following error was returned: <specific error message>.

Ensure the database is running and can be connected to from the server node. The specific error message may provide more specific information about the source of the problem, such as the server host cannot be connected to because of a network outage. The database logs may be used to determine database specific errors.

The server node key does not match the key used for the rest of the cluster.

NoteThis problem may occur when you are installing a second node before the first node has been started..

On a server node that is not starting, review the <SMP_HOME>\Server\log\osgi.log for the following message:

The key of this server node does not match the cluster you are attempting to connect to it.

Uninstall SAP Mobile Platform Server on the node and then re-install it.

38P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved.

Upgrade: SAP Mobile Platform Server for WindowsTroubleshooting

Page 39: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

5.1.4 Server Node Does Not Join the Cluster

Problem

While viewing the server log on a working node in the cluster, you see that the number of current addresses in the cluster is incorrect. For example, after adding a second node, the number of current addresses in the log still shows as 1:

Cluster node channel name: 'SERVERNAME-27525(bind_addr=192.168.1.100:55450)'SMP Cluster: Current Addresses in cluster: 1. Addresses previously in cluster: 0

NoteYou can view the log through Management Cockpit connected to a working node or in <SMP_HOME>\Server\log on the file system of a working node.

Assess and Correct

Assess the root cause and take the appropriate corrective action.

Root Cause Assessment Correction

The node cannot be reached using the IPv4 network interface, which is the default for SAP Mobile Platform Server.

The node can be reached using IPv6 instead of IPv4.

In <SMP_HOME>\Server\configuration\com.sap.mobile.platform.server.launcher\fixed-sys.properties, remove the following line:

-Djava.net.preferIPv4Stack=true

NoteYou must delete this line to comment it out.

SAP Mobile Platform Server is bound to an IP address that is not routed to a node in the cluster.

The address that SAP Mobile Platform Server is bound to is shown in the log (bind_addr).

In some situations, such as when the node is connected to two or more networks that do not allow routing, you must specify the IP address that the cluster should bind to.

In <SMP_HOME>\Server\configuration\com.sap.mobile.platform.server.launcher\fixed-

Upgrade: SAP Mobile Platform Server for WindowsTroubleshooting

P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved. 39

Page 40: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

Root Cause Assessment Correction

sys.properties, remove the following line:

java.net.preferIPv4Stack=true

NoteUpdate props.ini on each node in the cluster. Restart each SAP Mobile Platform Server for the changes to take effect.

5.1.5 Failed to Start SAPSMPTestUserLogonService Service Error

Problem

When you enter information for the smpServiceUser Windows user account, the installer displays the error message, Failed to start SAPSMPTestUserLogonService service.... As a result, you cannot start the SAP Mobile Platform Server.

Workaround

If the smpServiceUser Windows user account already existed, or the installer successfully created it, update the property of the SAP Mobile Platform Server service in the Windows Control Manager. On the second tab, labeled Log On, configure the service to log on and run with the smpServiceUser user account.

5.2 Issues Requiring Product Support

Your SAP support ID gives you access to enterprise-level incident support as part of your support plan on SAP Service Marketplace.

Product Support can help you resolve new undocumented incidents with software installation, start-up, and overall use, as well as providing diagnostic and troubleshooting assistance for known problems with a new or undocumented cause.

40P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved.

Upgrade: SAP Mobile Platform Server for WindowsTroubleshooting

Page 41: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

5.2.1 Product Support Engagement Requirements

If you use SAP Service Marketplace to engage with Product Support, you must meet certain requirements.

Service Marketplace Case Creation Requirements

Be prepared to provide:

● A valid installation number for SAP Mobile Platform● A valid service contract with SAP● A valid system ID (S-User ID)● An enabled NetViewer connection.

SAP Mobile Platform Incident Requirements

● Configure your logs to an appropriate level for your issue. Product Support requires details from one or more of the system logs.

● Capture these basic incident details to help Product Support analyze the problem, and determine any next steps:

○ Environment summary: product version, back end, client type (device and OS), proxy connections. These details help isolate component that is causing the failure. If you have an architecture diagram, share it with SAP.

○ Problem description: what were the actions preceded the incident. Capture all details that allow Product Support to reproduce the issue.

● Locate the server version in the SMP_HOME\Server\version.properties file.

5.2.2 Creating an Incident on SAP Service Marketplace

If you cannot resolve problems with the troubleshooting documentation for SAP Mobile Platform, go to SAP Service Marketplace for additional help.

Use SAP Service Marketplace to create an incident message for Product Support. Keywords from this message return related articles from the Knowledge Base. Before you submit a message, review these articles to see if they resolve your problem.

1. Go to http://service.sap.com/message .2. Create a message using the wizard.

NoteYou must know the component ID for SAP Mobile Platform to return the correct scope of Knowledge Base Articles and to correctly route the message to Product Support. On-premise installations of SAP

Upgrade: SAP Mobile Platform Server for WindowsTroubleshooting

P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved. 41

Page 42: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

Mobile Platform use a different ID than cloud instances. See Knowledge Base Article 1915061- How to Choose a Component for SAP Mobile Platform 3.x in Service Marketplace .

3. Once the message is processed, you receive an e-mail notification of the solution.

42P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved.

Upgrade: SAP Mobile Platform Server for WindowsTroubleshooting

Page 43: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

Important Disclaimers and Legal Information

Coding SamplesAny software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, unless damages were caused by SAP intentionally or by SAP's gross negligence.

AccessibilityThe information contained in the SAP documentation represents SAP's current view of accessibility criteria as of the date of publication; it is in no way intended to be a binding guideline on how to ensure accessibility of software products. SAP in particular disclaims any liability in relation to this document. This disclaimer, however, does not apply in cases of wilful misconduct or gross negligence of SAP. Furthermore, this document does not result in any direct or indirect contractual obligations of SAP.

Gender-Neutral LanguageAs far as possible, SAP documentation is gender neutral. Depending on the context, the reader is addressed directly with "you", or a gender-neutral noun (such as "sales person" or "working days") is used. If when referring to members of both sexes, however, the third-person singular cannot be avoided or a gender-neutral noun does not exist, SAP reserves the right to use the masculine form of the noun and pronoun. This is to ensure that the documentation remains comprehensible.

Internet HyperlinksThe SAP documentation may contain hyperlinks to the Internet. These hyperlinks are intended to serve as a hint about where to find related information. SAP does not warrant the availability and correctness of this related information or the ability of this information to serve a particular purpose. SAP shall not be liable for any damages caused by the use of related information unless damages have been caused by SAP's gross negligence or willful misconduct. All links are categorized for transparency (see: http://help.sap.com/disclaimer).

Upgrade: SAP Mobile Platform Server for WindowsImportant Disclaimers and Legal Information

P U B L I C© 2014 SAP SE or an SAP affiliate company. All rights reserved. 43

Page 44: Upgrade: SAP Mobile Platform Server for Windows · 1 Upgrade: SAP Mobile Platform Server for ... the steps above to download the MBO Runtime SP05 installer .zip ... SAP Mobile Platform

www.sap.com/contactsap

© 2014 SAP SE or an SAP affiliate company. All rights reserved.No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP SE or an SAP affiliate company. The information contained herein may be changed without prior notice.Some software products marketed by SAP SE and its distributors contain proprietary software components of other software vendors. National product specifications may vary.These materials are provided by SAP SE or an SAP affiliate company for informational purposes only, without representation or warranty of any kind, and SAP or its affiliated companies shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP or SAP affiliate company products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty.SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE (or an SAP affiliate company) in Germany and other countries. All other product and service names mentioned are the trademarks of their respective companies.Please see http://www.sap.com/corporate-en/legal/copyright/index.epx for additional trademark information and notices.