Adding Switches in Bulk

RUCKUS One provides a bulk import function, allowing you to add multiple switches to RUCKUS One using a single, downloadable CSV template file. You can import up to 10,000 switches in a single operation, across up to 100 existing venues.

The following CSV file requirements and import guidelines must be met before importing switches:
  • CSV File Requirements
    • The import file must be in CSV format, contain no more than 10,000 devices with a maximum of 100 venue allocations, and must not exceed 5 MB in size.
    • When editing the file in Microsoft Excel, ensure that it is saved in CSV format and and that the cell format is set to Text to maintain proper UTF-8 encoding, which is required for a successful import.
    • Ensure that the CSV file includes the following required column headers: Switch Name, Serial Number, Venue, and Reason.
  • Import Guidelines
    • The Serial Number and Venue fields are required for every switch.
    • Venue names must exactly match existing venue names and are case-sensitive.
    • Each switch serial number must be unique and not already registered.
    • Your account must have sufficient device networking licenses for the number of switches being imported. If the license limit is reached, any remaining switches are not imported.
    • If you do not have permission to add devices to a venue, switches associated with that venue are skipped and listed in the error report.
    • If a specified venue does not exist, the corresponding switches are not imported.
    • Do not rename, delete, or modify permissions of target venues while the import is in progress, as this may cause switches to be skipped or incorrectly imported.
Complete the following steps to import switches from a file.
  1. On the navigation bar, select Wired > Switches > Switch List.
    The Switches page is displayed.
  2. In the upper-right corner, click Add and then click Import from file.
    The Import from file sidebar is displayed.
  3. Click Download CSV Template to download the CSV template to your local machine.
    Import from file - Download CSV Template
  4. Open the downloaded template file on your local device, enter the required switch details (such as Switch Name, Serial Number, and Venue), and save the file.
  5. In the Import from file sidebar, drag-and-drop the CSV file into the upload area, or click Browse to select the file.
    You can replace the file by clicking the Change File button, which allows you to browse and upload a new file.
  6. Click Start Import.
    The Import from file sidebar closes automatically and an in-progress toast notification appears. The toast notification displays the total switch count, the live completion percentage, and a Details link that launches the Activity Details sidebar.
    Note: Invalid rows are skipped and valid rows continue importing.
    Toast Notification - Switch Import Status
  7. Click the Details link to view the Activity Details sidebar.
    Note: The toast notification remains on the screen until all import activities are complete.
    Activity Details Sidebar - Imports In-Progress

    The Activity Details sidebar continuously refreshes, displaying the following information:

    • The sidebar displays the Start Time, End Time, Severity, Event Type, Source (the user who performed the import), and Description. While in-progress, the description shows the number of switches being imported and the overall completion percentage. After all import activities are completed, the description displays the final numbers of successful and failed switch imports, and includes the Download Error Report link if failures occurred.
    • Success: Displays a green panel showing how many switches were imported successfully.
    • Failed: Displays a red panel showing how many switches were not imported.
    • In Progress: Displays a gray panel showing how many switches are still processing.
    • Target Venue: Displays import results for each venue included in the CSV file. Venue names appear as clickable links if they are accessible to you.
    • # of Devices: Displays the number of switches associated with the venue.
    • Status: Indicates the outcome or progress of switch import tasks for each venue. Status includes Success, Failed, Partial Success, In Progress, and Pending.
    • Description: Displays a brief explanation for each venue’s import outcome.
    • Current Status: Indicates the system-level status of the bulk switch import operation. The status may appear as: Success, Failed, Partial Success, In Progress, and Pending.
    • Processing Timeline: Displays the sequence and status of system operations involved in completing the bulk switch import. It includes timestamps for each step, indicates statuses like In Progress, Success, Partial Success, or Failed.
      Activity Details - Import Operation Completed
  8. (Optional) You can download the success report by clicking the icon on the Success panel. Similarly, you can download the error report by clicking the Download Error Report link in the Description field or the icon on the Failed panel.
    The report file is downloaded to your local system. Review the error report, fix the failed entries in the CSV file, and re-import the file to complete the process.
    Note: The reports are also available for download in Administration > Timeline > Activities.
After importing, the switches are displayed in the Switch List tab of the Switches page.