Upgrading the SAP Cloud Connector for Linux OS
With the recent update of the SAP Cloud Connector application I thought it would be good to carry out the upgrade process from an old version to the new version. New functionality has been delivered in the latest version 2.10 (check this blog here for details) so definitely want to take advantage of the new updates. I also wanted to see how difficult this task was and whether there would be any problems along the way. The below steps were carried out on an iMac with VirtualBox installed running a Linux box.
Before carrying out the steps, make sure you have downloaded the software from the https://tools.hana.ondemand.com website selecting the [Cloud] menu item followed by the Linux install files.
Make sure to download the first Linux.zip file as highlighted above. When you download you will need to Agree to the End User License agreement. Click button I Have Read And Agree to start the download.
The first thing to know is that there are different procedures required based on the OS installed on the boxes that the SAP Cloud Connector applications live on. For windows, a complete de-installation is required however with linux a simple command will do the job.
Let’s first set the scene by looking at the current version that is in play with respect to the relevant OS versions.
Upgrading the SAP Cloud Connector in Linux
The current version can be found by navigating to the top right corner and clicking on the expand option at the side of the Userid. There is a menu option called [About]. This of course assumes you have already logged in as Administrator!
If you select the [About] option as highlighted above another pop-up window will be displayed showing the Version information.
As you can see the current version is 188.8.131.52.
With the new version of 2.10 out I will now attempt an upgrade, but first let’s check a few settings prior to the upgrade to see if they will stay the same after the upgrade.
Let’s first check connectivity to the SAP Cloud Platform account. This is the first step, even before connecting to back-end SAP systems, that is required.
You can see that we have successful connection to the SAP Cloud Platform trial account and the relevant secure tunnel is in place.
Next, let’s check connection to back-end systems. As we can see below the systems are Reachable.
I’ve also got a connection to a HANA DB in the cloud however as you can see it is not Active at the moment but the settings exist. We simply want to check whether this configuration stays after the upgrade.
OK, now we have checked all of that let us now attempt to carry out an upgrade.
NOTE: If you have a Master AND Shadow instance as part of a HIGH AVAILABILITY environment then you need to upgrade the shadow instance first. Once the upgrade on the shadow instance is complete you then use the [Switch Roles] function that will swap the previous Master (the SAP Cloud Connector instance that has NOT been upgraded) to the Slave. The Slave instance (which has been upgraded) will then become the master while the NEW slave is being upgraded.
If you have a single instance there will be downtime in the environment during the upgrade process, so please build this into your project timeline.
For more information on setting up High Availability check Simen Huuse blog here.
In readiness for the upgrade the following pre-installation tasks are required:
- Install the ZIP file on your local drive.
- Using Virtual Box to map a Transient Folder to the directory location where the install files are located. You can see in the below screenshot the original SCC version downloaded also.
When naming the folder (for ease of installation) be sure to name it something like scc_upgrade to differentiate it from the original install directory.
- Click OK to save the Transient Folder mapping.
- Enter the following commands in the Konsole.
- Enter command mkdir scc_upgrade to create a new folder for the SAP Cloud Connector install for the new version.
- Enter command sudo mount -t vboxsf scc_upgrade scc_upgrade and press Return. Enter your Linux OS admin password. This will essentially map the folders and mount them – preparing for the install.
- Enter cd scc_upgrade and then ls to view the sapcc-XXX-linux-x64.zip installation ZIP file that is shared from the host OS download folder.
You can see below that it has connected up to the local install files. You can also see the previous version’s ZIP file that existed.
- Enter command sudo unzip sapcc-XXX-linux-x64.zip (replace placeholder XXX with the given release version, e.g. 184.108.40.206).
- This will unzip the install files.
- Notice what has been extracted in the above screenshot – sap.scc-ui-2.10.0-8.x86_64.rpm which is different to the original ZIP file name. This needs to be used below for the upgrade so take note of the exact extract name.
- Enter command sudo rpm -u com.sap.scc-ui-XXX.x86_64.rpm (replace XXX with the given version number as detailed in the previous point e.g. 2.10.0-8).
- Press the Return key to start the installation process:
The –u parameter defines that this is in fact an upgrade. On the original install this parameter would have been an –i.
You can see above that the “Upgrade finished” message is received meaning that the upgrade was successful. Once finished with the upgrade you can then check the status.
- Enter sudo service scc_daemon status and press [Return].
Hooray!!! Our upgrade was successful. You can see that the Cloud Connector is ACTIVE and the version is stated as 220.127.116.11 in the additional execution notes.
Let’s now see if all of our previous set up is still in place – is it still there???
Login to the SAP Cloud Connector using your Administrator password. This will be the same as it was before!
We can already see that the name has changed. With the recent changing of the SAP HANA Cloud Platform to SAP Cloud Platform this has also meant a change to the Cloud Connector naming convention to SAP Cloud Platform Cloud Connector.
We first see that the version is in fact the upgraded one.
Connectivity to the SAP Cloud Platform accounts looks good as well. We can see some additional display elements and options as well (e.g. Subaccount Certificate button). Nice!
The connection to backend systems looks intact as well.
Setup of the HANA DB also looks intact even though like I showed before the database is not Active.
OK, so you can see that this task was not too painful and now I can utilize some of the new features in the 18.104.22.168 version. Awesome!!!
Please look out for my next blog where I will attempt to upgrade the SAP Cloud Connector for the Windows OS.
The upgrade for the Windows OS is now available – here.
Thanks for the walk-through, Phil!
Thank you!! Great documentation!
we are planning to upgrade cloud connectors 2.12.5 from version 2.11.2 . as per prerequisite we need to upgrade OS also to SUSE Linux Enterprise server 15 as we are in 12.
is there any the dependency with tomcat in cloud connector? we are in Apache tomcat 7. We are not clear on this point.
Do we need to upgrade SAP Cloud platform Neo Environment SDK ? how we need to do? is is it required or dependency for cloud connector upgrade.
Thanks Vijaya Kumar for your note. All of the pre-requisites are detailed in the SAP Development Tools website and even though Apache Tomcat 7 is deprecated I don't believe you need to change anything for the cloud connector. In my experience there is no dependency on this.
The reliance is more on the SAP JVM so as long as the version you have is still supported then you are ok.
Hope it goes well!