Xylok Documentation
Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage
  2. /
  3. General
  4. /
  5. Organization
  6. /
  7. Bulk Management

Bulk Management

Adding machines individually can be tedious. So help bring new systems into Xylok, XSS also allows you to import a spreadsheet of devices. Currently, this import requires that there is not already an matching machine in the system (IE, with the same name). This requirement could be changed in the future, contact support if needed.

Spreadsheet format

This spreadsheet should by in XLSX format (the default Microsoft Excel format) with the following columns. The column names must match exactly, but order does not matter.

  • Client: Should match an existing client name or short name within XSS. If not found, the import will fail.
  • Name: Name of the new machine
  • Short name: Short(er) name of the new machine
  • Location: Should match a location name or short name. If a match isn’t found, it will be created.
  • OS: Should match an OS key, name, or short name within Xylok (ie, the list that shows when you’re creating a machine via the site)
  • Benchmarks: Newline-separated list of benchmark IDs to assign to the new device. Should match the ID as shown in the ID column of the benchmark listing reference page (https://app.xylok.io/reference/benchmark/).

Importing

Copy the spreadsheet to your XSS server, then run:

/opt/xylok/xylok import-data machines <spreadsheet-path>
gdoc_arrow_left_alt Benchmark Questions and Answers Client Details gdoc_arrow_right_alt