Follow

Upgrade Cisco CMX Cloud Proxy

Pre-requisite to CMX Cloud Proxy upgrade

  • CMX Cloud Proxy OVA is downloaded from cisco.com Download Software page & both Cisco WLC and CMX Cloud account token are configured.
  • Traffic from Cisco WLC to CMX Cloud is flowing through CMX Cloud Proxy successfully.

Note: Cisco CMX Cloud Proxy is not required for Cisco Virtual Beacon.

CMX Cloud Proxy Upgrade Procedure

It is very simple to upgrade your existing proxy, for example from 1.0 to 1.1:

  • cmxos upgrade CISCO_CMX_CLOUD_PROXY-1.1.rpm
  • proxyctl status

The traffic flow should continue after the proxy upgrade.

Note:

  • show member status per service. For instance, if member has PRESENCE and CONNCET two services, the status and stats will have two lines.
  • Issue when there are spaces in hostname which causing issue to communicate to the member is fixed.
  • Proxy issue that controller can not be added when there is no member added yet is fixed.
  • Use proxyctl command for all your operations and you don't need cmxctl anymore.
  • CLI changed from "member" to "account".
  • When adding an account (previously member), requires ONLY token.
  • When token is invalid, a user-friendly error message has been added.
  • PRESENCE-ONLY option is removed from proxyctl accounts add.
  • New CLI available to push configuration to CMX cloud manually: proxctl controllers sync.
  • Controller with configuration issues won’t be allowed to add.
  • CLI command support to retrieve configuration data from controllers manually.
  • A new CLI “proxyctl tech” allows user to change logghing level to DEBUG/INFO, which dumps necessary information to a tarball for user to upload to Cisco Tech.

CMX Cloud Proxy CLI support after Upgrade

Following additional CLI is supported on proxy after upgrade.

[cmxadmin@cmx-old-proxy-ova125 ~]$ proxyctl --help

Usage: proxyctl [OPTIONS] COMMAND [ARGS]...

 

Options:

  --help  Show this message and exit.

 

Commands:

  accounts     Add/Delete/Show accounts

  controllers  Add/Delete/Show controllers

  install      Install CMX nmspproxy for the first time

  start        Starts all CMX nmspproxy services

  status       Get CMX nmspproxy status and statistics

  stop         Stops all CMX nmspproxy services

  tech         Troubleshooting

  uninstall    Uninstall CMX nmspproxy software

  upgrade      Upgrade CMX nmspproxy with RPM or CMX file

  verify       Verify CMX nmspproxy configuration

 

Sample Upgrade Procedure

[cmxadmin@cmx-old-proxy-ova125 ~]$ cmxos upgrade cisco_cmx_proxy-1.1.rpm

 

** Upgrading new rpm /home/cmxadmin/cisco_cmx_proxy-1.1.rpm

 

Stopping services...

** Stopping CMX services.

 

Stopping monit:                                            [  OK  ]

Stopping agent Process...

Done

Successfully shutdown agent Process.

Host: cmx-old-proxy-ova125 Port: 9001

Consuming service: nmspproxy, pid: None, action: stop, callback: None

Stopping nmspproxy Process...

__init___ with PidFile:/opt/cmx/var/run/nmspproxy

checking for pid:None

the proc being attached to is:psutil.Process(pid=3230, name='java')

the old pid is:3230, the new pid is:3230

checking for pid:3230

p.is_running result:True

nmspproxy:stop received with state1

nmspproxy:shutting down

before calling sigterm on pid 3230

checking for pid:3230

p.is_running result:True

Checking URI: http://localhost:6000/api/services/nmspproxy/status

Bad status line

Done

Successfully shutdown nmspproxy Process.

Consuming service: metrics, pid: None, action: stop, callback: None

Stopping collectd Process...

__init___ with PidFile:/opt/cmx/var/run/collectd

checking for pid:None

the proc being attached to is:psutil.Process(pid=3195, name='collectd')

the old pid is:3195, the new pid is:3195

checking for pid:3195

p.is_running result:True

collectd:stop received with state1

collectd:shutting down

before calling sigterm on pid 3195

checking for pid:3195

p.is_running result:True

Retrying..

Done

Successfully shutdown collectd Process.

Consuming service: agent, pid: None, action: stop, callback: None

Shutting down

** Finished stopping CMX services.

 

** Upgrading rpm

** RPM upgraded, starting services...

** Starting CMX services.

 

The agent service is not running.

Agent is not running, starting it now.

Starting agent Process...

Retrying..

Done

Started agent service with PID: 15555

The collectd service is already running with pid: 15646

Starting nmspproxy Process...

Retrying..

Retrying...

Retrying....

Done

Started nmspproxy service with PID: 15681

Running in production mode

Starting monit: Starting Monit 5.14 daemon with http interface at [*]:2812

Monit start delay set -- pause for 240s

                                                           [  OK  ]

** Finished starting CMX services.

 

Only 'cmxadmin' user is allowed cmxctl commands

 

** Upgrade completed successfully

 

[cmxadmin@cmx-old-proxy-ova125 ~]$ cmxctl status

Done

The agent service is currently running with PID: 15555

+----------------------+-----------+---------+----------------+

| Host                 | Service   | Status  | Uptime (HH:mm) |

+----------------------+-----------+---------+----------------+

| cmx-old-proxy-ova125 | Metrics   | Running | 0 days, 00:00  |

+----------------------+-----------+---------+----------------+

| cmx-old-proxy-ova125 | Nmspproxy | Running | 0 days, 00:00  |

+----------------------+-----------+---------+----------------+

[cmxadmin@cmx-old-proxy-ova125 ~]$ proxyctl status

-------------

System Status

-------------

Done

The agent service is currently running with PID: 15555

+----------------------+-----------+---------+----------------+

| Host                 | Service   | Status  | Uptime (HH:mm) |

+----------------------+-----------+---------+----------------+

| cmx-old-proxy-ova125 | Metrics   | Running | 0 days, 00:00  |

+----------------------+-----------+---------+----------------+

| cmx-old-proxy-ova125 | Nmspproxy | Running | 0 days, 00:00  |

+----------------------+-----------+---------+----------------+

-------------

Account Service Status

-------------

+---------------------+----------+---------------------------------------------------------------------------------------------------------------+-----------+----+----+-----+----------------+------------------+

| Account             | Service  | Access Token                                                                                                  | Status    | 1m | 5m | 15m | Last NMSP Sent | Last Config Sync |

+---------------------+----------+---------------------------------------------------------------------------------------------------------------+-----------+----+----+-----+----------------+------------------+

| 1nwzdq.cmxcisco.com | PRESENCE | eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0ZW5hbnRJZCI6IjFud3pkcSJ9.GhOLaL9DIftbA4YT2nq_wdD32l6uYOsIg8YWNtcbwZ8 | REACHABLE | 0  | 0  | 0   |                |                  |

+---------------------+----------+---------------------------------------------------------------------------------------------------------------+-----------+----+----+-----+----------------+------------------+

|                     | CONNECT  | eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0ZW5hbnRJZCI6IjFud3pkcSJ9.GhOLaL9DIftbA4YT2nq_wdD32l6uYOsIg8YWNtcbwZ8 | REACHABLE | 0  | 0  | 0   |                |                  |

+---------------------+----------+---------------------------------------------------------------------------------------------------------------+-----------+----+----+-----+----------------+------------------+

------------------

Controllers Status

------------------

+--------------+---------------+------+------+-----------+------+------+-----+---------------------+

| Controller   | Status        | Type | SHA2 | Version   | 1m   | 5m   | 15m | Last Activity       |

+--------------+---------------+------+------+-----------+------+------+-----+---------------------+

| 10.22.243.20 | CLIENT ACTIVE | WLC  | True | 8.2.90.58 | 0.16 | 0.19 | 0.2 | 03/18/2016 10:53:33 |

+--------------+---------------+------+------+-----------+------+------+-----+---------------------+

 [cmxadmin@cmx-old-proxy-ova125 ~]$

 

0 Comments

Please sign in to leave a comment.