Skip to content

Home

Jump to bottom
andreacoppini edited this page Feb 4, 2019 · 2 revisions

Welcome to the Crossbreeder wiki!

What is it?

Crossbreeder was created as a tool to run operations on standalone Ruckus APs in bulk. It's not meant as a management tool, there are controllers for that.

Crossbreeder helps you when you need to do the following on a large number of APs:

  • convert Unleashed APs to Solo APs to have them join a controller or Ruckus Cloud
  • convert Solo APs to Unleashed APs
  • factory reset APs
  • run single CLI commands such as "set scg ip x.x.x.x" or "set provision-tag XXXX"
  • reboot APs

How to use

  1. Download the binary according to your platform - there are Windows and MacOS versions available.
  2. Import a CSV file containing a list of IPs of the access points you want to crossbreed.
  3. Type in the AP CLI Details (see more about this below)
  4. Select the actions you want to perform from the column of actions on the right.
  5. Hit GO.

More about the AP CLI Details field

Crossbreeder needs to know the login/password to log in via SSH to the AP. If the APs are not factory default, the two text boxes allow you to enter the existing credentials (for example, if the APs are joined to a controller, the controller will push new credentials for SSH login). If you do not define any credentials, Crossbreeder will try to use the Ruckus defaults (super/sp-admin). If you do define credentials, and you enable the "Also try default" checkbox, Crossbreeder will try to log in using your custom credentials, and if that fails it will try to log in to the AP using the Ruckus default (super/sp-admin). Crossbreeder will do this separately for each AP, so you can have a mix of APs having factory default and custom credentials and Crossbreeder will try both.

How it works

For each IP in the list, Crossbreeder will first ping to check if the IP is alive, and if there is a reply it will try to connect via SSH. This means, if there is any firewall blocking pings between your machine and the AP, Crossbreeder will not work!

Follow the progress in the main AP List table as well as the debug window below. Keep in mind that this process is all SSH based, and Crossbreeder connects to each AP sequentially. The process can be slow and the tool may appear to have crashed if the response time on SSH is slow, but don't worry, it's still working! You should see some activity happening in the debug window every few seconds.

Clone this wiki locally