Oracle-Based Deployment Guide for Cisco IoT FND, Release 5.x.x and Later

PDF

Upgrade the Cisco IoT FND TPS proxy server

Updated: March 2, 2026

Want to summarize with AI?

Log in

Overview

Learn how to upgrade the Cisco IoT FND TPS Proxy server, including backing up configuration files, stopping and starting services, and verifying the upgrade process.

Note

Based on the RHEL version, choose either systemctl or service commands.

For example, to stop the tpsproxy services:

RHEL version

Command

8.x

 
systemctl stop tpsproxy.service

7.x

 
service tpsproxy stop

To upgrade the TPS Proxy server manually:

Procedure

1.

Back up the following config files in the /opt/cgms-tpsproxy/conf directory.

  • tpsproxy.properties

  • cgms_keystore
2.

Before starting the upgrade process, ensure that the following services are running.

[root@iot-tps opt]# systemctl status tpsproxy.service
                        ● tpsproxy.service - SYSV: CGMS Tunnel Provisioning proxy server
                        Loaded: loaded (/etc/rc.d/init.d/tpsproxy; generated)
                        Active: active (running) since Mon 2023-11-06 23:51:00 IST; 6 months 2 days ago
                        Docs: man:systemd-sysv-generator(8)
                        Process: 35730 ExecStart=/etc/rc.d/init.d/tpsproxy start (code=exited, status=0/SUCCESS)
                        Tasks: 45 (limit: 152533)
                        Memory: 204.1M
                        CGroup: /system.slice/tpsproxy.service
                        └─35748 java -server -Xms128m -Xmx2g -XX:MaxPermSize=256m -server -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/opt/cgms-tpsproxy/log -XX:-OmitStackTraceInFastThrow -XX:-Use>
                        Nov 06 23:50:58 iot-tps systemd[1]: Starting SYSV: CGMS Tunnel Provisioning proxy server...
                        Nov 06 23:50:59 iot-tps runuser[35746]: pam_unix(runuser:session): session opened for user root by (uid=0)
                        Nov 06 23:50:59 iot-tps runuser[35746]: pam_unix(runuser:session): session closed for user root
                        Nov 06 23:51:00 iot-tps tpsproxy[35730]: [36B blob data]
                        Nov 06 23:51:00 iot-tps systemd[1]: Started SYSV: CGMS Tunnel Provisioning proxy server.
3.

Run the following command to stop the tpsproxy services.

systemctl stop tpsproxy
4.

Copy the cgms-tpsproxy.rpm downloaded from software.cisco.com to a directory in the TPS server.

5.

Run the following command to upgrade the tpsproxy server.

rpm -Uvh cgms-tpsproxy-<fnd-version>.rpm
[root@iot-tps opt]# rpm -Uvh cgms-tpsproxy-<fnd-version>.rpm
                        Verifying...                          ################################# [100%]
                        Preparing...                          ################################# [100%]
                        Updating / installing...
                        1:cgms-tpsproxy-4.12.0-56          ################################# [ 50%]
                        PSK key already present
                        05-09-2024 15:36:02 IST: INFO: Looking for /opt/cgms-tpsproxy/conf/tpsproxy.properties
                        05-09-2024 15:36:02 IST: INFO: cgms-keystore-password-hidden already exists. Doing nothing.
                        Cleaning up / removing...
                        2:cgms-tpsproxy-4.10.0-45          ################################# [100%]
                        [root@iot-tps opt]#
6.

Run the following command to start the tpsproxy services . 

systemctl start tpsproxy.service
[root@iot-tps opt]# systemctl start tpsproxy.service
                        [root@iot-tps opt]# systemctl status tpsproxy.service
                        ● tpsproxy.service - SYSV: CGMS Tunnel Provisioning proxy server
                        Loaded: loaded (/etc/rc.d/init.d/tpsproxy; generated)
                        Active: active (running) since Thu 2024-05-09 15:36:45 IST; 4s ago
                        Docs: man:systemd-sysv-generator(8)
                        Process: 209931 ExecStart=/etc/rc.d/init.d/tpsproxy start (code=exited, status=0/SUCCESS)
                        Tasks: 39 (limit: 152533)
                        Memory: 71.1M
                        CGroup: /system.slice/tpsproxy.service
                        └─209949 java -server -Xms128m -Xmx2g -XX:MaxPermSize=256m -server -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/opt/cgms-tpsproxy/log -XX:-OmitStackTraceInFastThrow -XX:-Us>
                        May 09 15:36:44 iot-tps systemd[1]: Starting SYSV: CGMS Tunnel Provisioning proxy server...
                        May 09 15:36:44 iot-tps runuser[209947]: pam_unix(runuser:session): session opened for user root by (uid=0)
                        May 09 15:36:44 iot-tps runuser[209947]: pam_unix(runuser:session): session closed for user root
                        May 09 15:36:45 iot-tps tpsproxy[209931]: [36B blob data]
                        May 09 15:36:45 iot-tps systemd[1]: Started SYSV: CGMS Tunnel Provisioning proxy server.

  1. Run the following command to check the log.

    tail -f /opt/cgms-tpsproxy/log/tpsproxy.log

    Example output: 

    [root@iot-tps opt]# tail -f /opt/cgms-tpsproxy/log/tpsproxy.log
                                32: iot-tps: May 09 2024 06:06:45.108 -0400: %CGMS-6-UNSPECIFIED: %[ch=BootstrapProxy][sev=INFO][tid=main]: bootstrap-proxy-listen-port=9125
                                33: iot-tps: May 09 2024 06:06:45.108 -0400: %CGMS-6-UNSPECIFIED: %[ch=BootstrapProxy][sev=INFO][tid=main]: inbound-proxy-destination=http://<fnd hostname/ip address>:9125
                                34: iot-tps: May 09 2024 06:06:45.108 -0400: %CGMS-6-UNSPECIFIED: %[ch=BootstrapProxy][sev=INFO][tid=main]: inbound-proxy-timeout=300000
                                35: iot-tps: May 09 2024 06:06:45.108 -0400: %CGMS-6-UNSPECIFIED: %[ch=BootstrapProxy][sev=INFO][tid=main]: inbound-proxy-idle-timeout=300000
                                36: iot-tps: May 09 2024 06:06:45.108 -0400: %CGMS-6-UNSPECIFIED: %[ch=BootstrapProxy][sev=INFO][tid=main]: inbound-proxy-connections=30
                                37: iot-tps: May 09 2024 06:06:45.108 -0400: %CGMS-6-UNSPECIFIED: %[ch=BootstrapProxy][sev=INFO][tid=main]: inbound-proxy-max-response-timeout=305000
                                38: iot-tps: May 09 2024 06:06:45.110 -0400: %CGMS-6-UNSPECIFIED: %[ch=Server][sev=INFO][tid=main]: jetty-9.2.19.v20160908
                                39: iot-tps: May 09 2024 06:06:45.111 -0400: %CGMS-6-UNSPECIFIED: %[ch=ContextHandler][sev=INFO][tid=main]: Started o.e.j.s.ServletContextHandler@4d41cee{/,null,AVAILABLE}
                                40: iot-tps: May 09 2024 06:06:45.112 -0400: %CGMS-6-UNSPECIFIED: %[ch=ServerConnector][sev=INFO][tid=main]: Started ServerConnector@3712b94{HTTP/1.1}{0.0.0.0:9125}
                                41: iot-tps: May 09 2024 06:06:45.112 -0400: %CGMS-6-UNSPECIFIED: %[ch=Server][sev=INFO][tid=main]: Started @697ms
7.

Check the tpsproxy service status.

systemctl status tpsproxy.service

Example output: 

[root@iot-tps opt]# systemctl status tpsproxy.service
                        ● tpsproxy.service - SYSV: CGMS Tunnel Provisioning proxy server
                        Loaded: loaded (/etc/rc.d/init.d/tpsproxy; generated)
                        Active: active (running) since Thu 2024-05-09 15:36:45 IST; 1min 52s ago
                        Docs: man:systemd-sysv-generator(8)
                        Process: 209931 ExecStart=/etc/rc.d/init.d/tpsproxy start (code=exited, status=0/SUCCESS)
                        Tasks: 39 (limit: 152533)
                        Memory: 71.1M
                        CGroup: /system.slice/tpsproxy.service
                        └─209949 java -server -Xms128m -Xmx2g -XX:MaxPermSize=256m -server -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/opt/cgms-tpsproxy/log -XX:-OmitStackTraceInFastThrow -XX:-Us>
                        May 09 15:36:44 iot-tps systemd[1]: Starting SYSV: CGMS Tunnel Provisioning proxy server...
                        May 09 15:36:44 iot-tps runuser[209947]: pam_unix(runuser:session): session opened for user root by (uid=0)
                        May 09 15:36:44 iot-tps runuser[209947]: pam_unix(runuser:session): session closed for user root
                        May 09 15:36:45 iot-tps tpsproxy[209931]: [36B blob data]
                        May 09 15:36:45 iot-tps systemd[1]: Started SYSV: CGMS Tunnel Provisioning proxy server.
You have upgraded the Cisco IoT FND TPS proxy server.