Ruckus Unleashed Networks Binding

Add-on Marketplace Bundles
, ,
1

Ruckus Unleashed Networks Binding

ruckus

(https://support.ruckuswireless.com/product_families/19-ruckus-unleashed) enabling an OpenHAB instance to leverage presence detection, view basic network information as well as blocking / unblocking clients from the network. The binding will connect to the CLI
via ssh and use an expect script style to fetch information.

Documentation / Installation / Download

Bugs

Any bug you find is good to report. Preferred way of reporting bugs is to create an issue on github: Issues · seaside1/unleashed · GitHub
I will look at failures in this thread as well.

Contribute

Create a Pull Request on github: Pull requests · seaside1/unleashed · GitHub

Resources

https://github.com/seaside1/unleashed/releases/latest/download/org.openhab.binding.unleashed-3.x.x-LASTEST.jar

2 Likes
2

Made some bugfixes to the binding, please download or build a new snapshot.

3

Created a new BETA3 version. Fixed some synchronization issues with block / unblock client.

1 Like
4

any updates for the OH 2.5.9?

5

I’ve built a version for 2.5.9. I have not tested it myself since I’m still on 2.5.7 in my production system, and development is on 2.5.10.

Also updated the docker image.

/S

6

I am getting these errors with the binding:

==> /logs/openhab.log <==

2020-09-25 13:52:26.751 [ERROR] [nternal.parser.UnleashedClientParser] - Error parsing clients: String index out of range: -1

==> /logs/events.log <==

2020-09-25 13:52:26.759 [hingStatusInfoChangedEvent] - ‘unleashed:controller:paragon’ changed from ONLINE to OFFLINE (COMMUNICATION_ERROR): Error communicating with the Unleashed controller

==> /logs/openhab.log <==

2020-09-25 13:52:26.768 [WARN ] [.core.thing.binding.BaseThingHandler] - Handler UnleashedControllerThingHandler tried updating the thing status although the handler was already disposed.

7

@epicurean I’ve updated my system to 2.5.9 as well. Both the old 2.5.7 binding and the new 2.5.9 seem to work fine under 2.5.9.

Maybe you are missing ssh or expect. Write ssh and expect at the prompt to see that those are present.
(inside the docker container if you are running it in docker).
If so the next step is to enable debug to see what is happening.

8

I’ve updated the original post with instructions on how to test docker and how to enable debug.

9

I’ve added a new beta-jar which contains a bit more debugging, when debug is set to on.

10

My openhab is a docker container. And I did install expect and openssh-client inside the docker.

these are the debug logs
2020-09-25 17:28:21.144 [DEBUG] [dler.UnleashedControllerThingHandler] - Refreshing the Unleased Controller unleashed:controller:paragon

2020-09-25 17:28:21.151 [DEBUG] [ternal.api.model.UnleashedController] - Updating clients cache

2020-09-25 17:28:21.160 [DEBUG] [ernal.context.UnleashedScriptContext] - Loading script as resource: scripts/unleashed-refresh.sh

2020-09-25 17:28:21.167 [DEBUG] [unleashed.internal.api.UnleashedUtil] - Script Resources: bundleresource://269.fwk1741786839/scripts/unleashed-refresh.sh

2020-09-25 17:28:21.183 [DEBUG] [ternal.api.model.UnleashedController] - Creating new UnleashedCliContext using: UnleashedCliInfoContext [username=admin, password= ******, host=192.168.1.16, port=22, acl=openhab]

2020-09-25 17:28:21.187 [DEBUG] [ernal.script.UnleashedScriptExecutor] - Executing: UnleashedCliInfoContext [username=admin, password= ******, host=192.168.1.16, port=22, acl=openhab]

2020-09-25 17:28:21.196 [DEBUG] [ernal.script.UnleashedScriptExecutor] - Executing command: [expect, /openhab/userdata/tmp/unleashed2158681901253518710.sh, admin, *********, 192.168.1.16, 22, openhab]

2020-09-25 17:28:58.860 [WARN ] [.core.thing.binding.BaseThingHandler] - Handler UnleashedControllerThingHandler tried updating the thing status although the handler was already disposed.

2020-09-25 17:29:22.524 [ERROR] [nternal.parser.UnleashedClientParser] - Error parsing clients: String index out of range: -1

11

If you use the beta5 jar you will get more debug as to what it fails parsing.
You can also execute on the command line:

expect /openhab/userdata/tmp/unleashed2158681901253518710.sh admin [yourpassword] 192.168.1.16 22 openhab

and see what it returns.

12

2020-09-26 10:47:17.939 [DEBUG] [ternal.api.model.UnleashedController] - Request Cli Info result size: 457

2020-09-26 10:47:17.940 [DEBUG] [nternal.parser.UnleashedClientParser] - Parsing clients from string size: 457

2020-09-26 10:47:17.940 [ERROR] [nternal.parser.UnleashedClientParser] - Error parsing clients: String index out of range: -1

2020-09-26 10:47:17.941 [DEBUG] [nternal.parser.UnleashedClientParser] - Failed to parse clients. Original clientString: spawn ssh admin@192.168.1.16

The authenticity of host ‘192.168.1.16 (192.168.1.16)’ can’t be established.

RSA key fingerprint is SHA256:EUowwz7zQrO8sT3PxWQbB4sH8/Dy8V83sQUm1Jmq/3U.

Are you sure you want to continue connecting (yes/no)? admin

Please type ‘yes’ or ‘no’: ******

Please type ‘yes’ or ‘no’: enable

Please type ‘yes’ or ‘no’: show l2acl name openhab

Please type ‘yes’ or ‘no’: show current-active-clients all

Please type ‘yes’ or 'n

13

Thanks, this should be fixable with a small modification to the script. I’ll post a update once I get some time.

/S

14

Hi! I’ve updated the scripts now in a beta6 version.
It’s connecting with StricKeyVerficiation set to no, this should resolve the issue.

1 Like
15

Latest beta6 did the trick!
However, I am only able to get the wireless things registered inside OH via the paperui or habamin. Could not do so with the manual example.
Can you consider also making the binding work with wired clients? like the unifi binding?

16

Hi!
How are the wired clients connected? Are they connected to the Ruckus Accesspoint in the secondary port (for instance on R710 / R510) or in some other manner?
Are you using 802.1x authentication for the clients?
As per official info from Ruckus, only wired clients using 802.1x authentication will be visible.

What do you want to do with the wired clients? Block them or view if they are online?

17

My wired clients are connected to a ICX6450 switch, and of which the Ruckus master controller takes up one of the ports.
Yes, I only wish to view the wired clients

18

Yeah the unleashed controller can’t see those clients, so it’s not possible.
The options for you is to use:

  • snmp (there is a binding)
  • or write a script that arp-pings those clients and reports status using mqtt
  • Possibly use the network binding

I have a couple of Juniper switches myself, and I’m writing a binding for handling those clients, it could be possible to just exchange the scripts in there to suit the Brocade CLI, but it is far from done, and I’m already working on a UniFi Protect binding and a Pfsense binding in parallell.

Regards S

1 Like
19

I’ve updated the binding for OpenHAB 3.0. It is still untested in OpenHAB3, but if you like you can give it a shot. I’ll work a bit on this binding adding auto discovery and trying to get rid of the external dependency. Once that is done I will submit a PR.

Regards, S

20

I’ve updated the docker-image for Openhab3.0 as well.

1 Like