DCImanager 6
Документация
/
DCImanager 6
/
Оборудование
/
Импорт оборудования из CSV-файла
Добавить в избранное
Документация
/
DCImanager 6
/
Оборудование
/
Импорт оборудования из CSV-файла

Импорт оборудования из CSV-файла

Вы можете добавить оборудование в платформу через импорт CSV-файла. Эта функция может быть полезна при:

  • добавлении большого количества оборудования за раз;
  • миграции с аналогичной платформы на DCImanager 6.

Подготовка CSV-файла

CSV-файл должен иметь объём не более 16 МБ. Иначе операция завершится с ошибкой, и оборудование не будет импортировано.

CSV-файл должен иметь структуру:

#тип_1
поле_1,поле_2,поле_3,поле_4
поле_1,поле_2,поле_3,поле_4

#тип_2
поле_1,поле_2,поле_3,поле_4
поле_1,поле_2,поле_3,поле_4
...

тип_1 и тип_2 — тип оборудования или записи, которую нужно добавить. DCImanager 6 поддерживает следующие типы оборудования и записей:

  • стойка — rack;
  • платформа сервера — platform;
  • шасси для блейд-сервера — chassis;
  • сервер — server;
  • BMC — ipmi или bmc;
  • Intel AMT — intel_amt;
  • коммутатор — switch;
  • PDU — pdu;
  • источник бесперебойного питания — ups;
  • пользователь — user;
  • IP-адрес сервера — server_ip.

Пропуск параметров

Вы можете не указывать часть параметров. Для этого оставьте соответствующее поле пустым:

Пример с пропущенным полем "поле_2"
#тип
поле_1,,поле_3,поле_4

Если пустые параметры находятся в конце строки, запятые после последнего параметра добавлять не нужно:

Пример с пропущенными полями "поле_3" и "поле_4"
#тип
поле_1,поле_2

Добавление оборудования

Стойки

Синтаксис строки стойки
name,size,note

Обязательные поля:

Поле

Описание поля

name

имя стойки
size
количество юнитов

Необязательные поля:

Поле

Описание поля

note

примечание

Платформы серверов

Синтаксис строки платформы сервера
name,type,server_size,is_short_depth,cpu_socket_count,ram_slot_count,max_ram,hdd_slot_count,pci_slot_count,cpu_socket_name

Обязательные поля:

Поле

Описание поля Примечания

name

имя платформы

type

тип платформы

может принимать только два значения:

  • server — стоечный сервер
  • blade — блейд-сервер

server_size

размер платформы сервера в юнитахдля блейд-сервера оставьте пустым

is_short_depth

занимает ли платформа только часть стойки в глубину
  • может принимать только два значения:
    • true — платформа занимает половину стойки в глубину
    • false — платформа полностью занимает стойку в глубину
  • для блейд-сервера оставьте пустым

Необязательные поля:

Поле

Описание поля

cpu_socket_count

количество сокетов CPU

ram_slot_count

количетсво слотов RAM

max_ram

максимальный объём RAM

hdd_slot_count

количество слотов HDD

pci_slot_count

количество слотов PCI

cpu_socket_name

имя сокета CPU

Шасси blade-серверов

Синтаксис строки шасси blade-серверов
name,size,server_slot_count,rack,unit,is_short_depth,side,note

Обязательные поля:

Поле

Описание поля Примечания

name

имя шасси

size

размер шасси в стойке

server_slot_count

количество слотов под блейд-серверы в шасси

rack

имя стойки, в которой установлено шасси

unit

идентификатор юнита стойки, в который установлено устройство

is_short_depth

занимает ли шасси только часть стойки в глубину

  • может принимать только два значения:
    • true — платформа занимает половину стойки в глубину
    • false — платформа полностью занимает стойку в глубину
  • для блейд-сервера оставьте пустым

side

сторона юнита в стойке

  • может принимать только два значения:
    • front — платформа установлена в передней части стойки
    • rear — платформа установлена в задней части стойки
  • обязательно только если is_short_depth имеет значение true

Необязательные поля:

Поле

Описание поля

note

примечание

Серверы

Синтаксис строки сервера
name,platform,rack,unit,side,chassis,slot,configuration,mac,owner,installed_os,note

Обязательные поля:

Поле

Описание поля Примечания

name

имя сервера

platform

имя платформы сервера

rack

имя стойкидля блейд-сервера оставьте пустым

unit

идентификатор юнита стойкидля блейд-сервера оставьте пустым

side

сторона юнита в стойке

  • может принимать только два значения:
    • front — платформа установлена в передней части стойки
    • rear — платформа установлена в задней части стойки
  • для блейд-сервера оставьте пустым

chassis

имя шассиесли это не блейд-сервер, оставьте пустым

slot

номер слота шассиесли это не блейд-сервер, оставьте пустым

Необязательные поля:

Поле

Описание поля

configuration

конфигурация сервера

mac

MAC-адрес сервера

owner

имя владельца сервера

installed_os

название ОС, установленной на сервере

note

примечание

BMC

Синтаксис строки BMC
address,user,password,type,server,web_url

Обязательные поля:

Поле

Описание поля Примечания
addressIP-адрес BMC


userИмя администратора BMC
passwordПароль администратора
typeПротокол и версия протокола BMC

возможные значения:

  • lan — IPMI v1.5
  • lanplus — IPMI v2.0
  • redfish — Redfish v1
serverИмя сервера, c которым связан BMC

Необязательные поля:

Поле

Описание поля

web_url

URL-адрес BMC, который используется при открытии через модуль проксирования

Коммутаторы

Синтаксис и необходимые поля для коммутаторов зависят от используемого протокола:

Синтаксис строки коммутатора с протоколом SNMP
proto,name,device,ip,rack,unit,size,is_short_depth,side,note,snmp_version,snmp_community,snmp_auth_username,snmp_auth_password,snmp_auth_level,snmp_auth_proto,snmp_privacy_protocol,snmp_privacy_password
Синтаксис строки коммутатора с протоколом NetConf
proto,name,device,ip,rack,unit,size,is_short_depth,side,note,netconf_username,netconf_password,netconf_port
Синтаксис строки коммутатора с протоколом NX-API
proto,name,device,ip,rack,unit,size,is_short_depth,side,note,nxapi_username,nxapi_password,nxapi_port,nxapi_protocol
Синтаксис строки коммутатора с протоколом eAPI
proto,name,device,ip,rack,unit,size,is_short_depth,side,note,eapi_username,eapi_password
Синтаксис строки коммутатора с протоколом RouterOS API
proto,name,device,ip,rack,unit,size,is_short_depth,side,note,mikrotik_username,mikrotik_password,mikrotik_port,mikrotik_ssl

Поля, обязательные для всех видов коммутаторов:

Поле

Описание поля Примечания
protoпротокол подключения коммутатора 

возможные значения:

  • snmp
  • netconf
  • nxapi
  • eapi
  • mikrotik
nameимя коммутатора
deviceвнутреннее имя обработчика коммутатора
  • параметр должен содержать только одно имя

  • примеры названий обработчиков:

    • zyxel_xgs_old
    • cisco_snmp
    • snmp_common
    • juniper_with_els
    • cisco_nexus_nxapi
    • arista_eapi
    • mikrotik_api
ipIP-адрес коммутатора
serverимя сервера, c которым связан BMC

rack

имя стойки, в которой установлен коммутатор

unit

идентификатор юнита стойки, в который установлено устройство

size

размер коммутатора в юнитах

is_short_depth

занимает ли коммутатор только часть стойки в глубину

может принимать только два значения:

  • true — устройство занимает половину стойки в глубину
  • false — устройство полностью занимает стойку в глубину

side

сторона юнита в стойке

  • может принимать только два значения:
    • front — устройство установлено в передней части стойки
    • rear — устройство установлено в задней части стойки
  • обязательно только если is_short_depth имеет значение true

Поля, обязательные только для коммутаторов с прокотоколом связи SNMP v1/v2/v3:

Поле

Описание поля Примечания
snmp_communityимя сommunity


snmp_versionверсия протокола SNMP

возможные значения:

  • 1 — v1
  • 2 — v2
  • 3 — v3

Поля, обязательные только для коммутаторов с прокотоколом связи SNMP v3:

Поле

Описание поля Примечания
snmp_auth_usernameимя пользователя для доступа к SNMP


snmp_auth_passwordпарольная фраза протокола аутентификации
snmp_auth_levelуровень аутентификации

возможные значения:

  • 1 — no_auth_or_privacy
  • 2 — auth_without_privacy
  • 3 — auth_with_privacy
snmp_auth_protoпротокол аутентификации

возможные значения:

  • md5
  • sha
snmp_privacy_protocolпротокол безопасности

возможные значения:

  • aes
  • des

snmp_privacy_password

парольная фраза протокола безопасности

Поля, обязательные только для коммутаторов с протоколом связи NetConf:

Поле

Описание поля

netconf_username

имя пользователя для протокола NetConf


netconf_password


пароль для протокола NetConf
netconf_portпорт для протокола NetConf

Поля, обязательные только для коммутаторов с протоколом связи NX-API:

Поле

Описание поля Примечания

nxapi_username

имя пользователя для протокола NX-API


nxapi_password


пароль для протокола NX-API
nxapi_portпорт для протокола NX-API
nxapi_protocolтип протокола

возможные значения:

  • http
  • https

Поля, обязательные только для коммутаторов с прокотоколом связи eAPI:

Поле

Описание поля Примечания
eapi_usernameимя пользователя для протокола eAPI


eapi_passwordпароль для протокола eAPI

Поля, обязательные только для коммутаторов с протоколом связи RouterOS API:

Поле

Описание поля Примечания
mikrotik_usernameИмя пользователя для протокола RouterOS API


mikrotik_passwordПароль для протокола RouterOS API
mikrotik_portПорт для протокола RouterOS API
mikrotik_sslЗначение SSL для протокола RouterOS API

может иметь только два значения:

  • true — использовать SSL
  • false — не использовать SSL

Необязательные поля:

Поле

Описание поля

note

Примечание

PDU

Синтаксис строки PDU
name,device,ip,rack,unit,size,is_short_depth,side,note,snmp_version,snmp_community,snmp_auth_username,snmp_auth_password,snmp_auth_level,snmp_auth_proto,snmp_privacy_protocol,snmp_privacy_password

Обязательные поля:

Поле

Описание поля Примечания
nameимя PDU

     

deviceимя обработчика PDU 

варианты обработчиков:

  • apc
  • aten
  • ats
  • c3_solutions
  • rpcm
ipIP-адрес PDU

rack

имя стойки, в которой установлено устройство

unit

идентификатор юнита стойки, в который установлено устройство

size

размер устройства в юнитах

is_short_depth

занимает ли устройство только часть стойки в глубину

может принимать только два значения:

  • true — устройство занимает половину стойки в глубину
  • false — устройство полностью занимает стойку в глубину

side

сторона юнита в стойке

  • может принимать только два значения:
    • front — устройство установлено в передней части стойки
    • rear — устройство установлено в задней части стойки
  • обязательно только если is_short_depth имеет значение true

snmp_community

Имя сommunity


Поля, обязательные только для устройств с прокотоколом связи SNMP v3:

Поле

Описание поля Примечания
snmp_auth_usernameимя пользователя для доступа к SNMP


snmp_auth_passwordпарольная фраза протокола аутентификации
snmp_auth_levelуровень аутентификации

возможные значения:

  • 1 — no_auth_or_privacy
  • 2 — auth_without_privacy
  • 3 — auth_with_privacy
snmp_auth_protoпротокол аутентификации

возможные значения:

  • md5
  • sha
snmp_privacy_protocolпротокол безопасности

возможные значения:

  • aes
  • des

Необязательные поля:

Поле

Описание поля Примечания

note

примечание

      

snmp_version

версия протокола SNMP

по умолчанию равна 2

ИБП

Синтаксис строки ИБП
name,device,ip,rack,unit,size,is_short_depth,side,note,snmp_version,snmp_community,snmp_auth_username,snmp_auth_password,snmp_auth_level,snmp_auth_proto,snmp_privacy_protocol,snmp_privacy_password

Обязательные поля:

Поле

Описание поля Примечания
nameимя ИБП

     

deviceимя обработчика ИБП

варианты обработчиков:

  • emerson_liebert
  • keor_mod_250
  • apc
ipIP-адрес ИБП

rack

имя стойки, в которой установлено устройство

unit

идентификатор юнита стойки, в который установлено устройство

size

размер устройства в юнитах

is_short_depth

занимает ли устройство только часть стойки в глубину

может принимать только два значения:

  • true — устройство занимает половину стойки в глубину
  • false — устройство полностью занимает стойку в глубину

side

сторона юнита в стойке

  • может принимать только два значения:
    • front — устройство установлено в передней части стойки
    • rear — устройство установлено в задней части стойки
  • обязательно только если is_short_depth имеет значение true

Поля, обязательные только для устройств с прокотоколом связи SNMP v1/v2/v3:

Поле

Описание поля
snmp_communityимя сommunity
snmp_versionверсия протокола SNMP

Поля, обязательные только для устройств с прокотоколом связи SNMP v3:

Поле

Описание поля Примечания
snmp_auth_usernameимя пользователя для доступа к SNMP


snmp_auth_passwordпарольная фраза протокола аутентификации
snmp_auth_levelуровень аутентификации

возможные значения:

  • 1 — no_auth_or_privacy
  • 2 — auth_without_privacy
  • 3 — auth_with_privacy
snmp_auth_protoпротокол аутентификации

возможные значения:

  • md5
  • sha
snmp_privacy_protocolпротокол безопасности

возможные значения:

  • aes
  • des

Необязательные поля:

Поле

Описание поля

note

примечание

IP-адреса сервера

Синтаксис строки IP-адреса сервера
ip,domain,server,is_main

Обязательные поля:

Поле

Описание поля

ip

IP-адрес сервера
domainдомен IP-адреса
serverимя сервера, к которому IP адрес будет добавлен

Необязательные поля:

Поле

Описание поля Примечания
is_main
является ли IP адрес основным для сервера

может принимать только два значения:

  • true — IP-адрес является основным
  • false (по умолчанию) — IP-адрес не является основным

Пользователи

Синтаксис строки стойки
name,password,level

Обязательные поля:

Поле

Описание поля Примечания

name

имя пользователя
passwordпароль пользователя
levelуровень доступа

возможные варианты:

  • admin — администратор
  • user — пользователь

Пример SCV-файла

#rack
csv_rack,90
csv_rack_2,40,small rack
#platform
csv_platform,server,0.5,true
csv_platform2,server,1,false,2,2,4096,2,2,LGA1700
csv_blade_platform,blade,1.5
#chassis
csv_chassis,0.5,10,csv_rack,39.5,true,front
csv_chassis_2,1.5,2,csv_rack,38,false,,my new chassis\
#user
csvuser@example.com,password,admin
csvuser2@example.com,RuRuRuRu,user
#server
csv_server_1,csv_platform,csv_rack,30,front,,
csv_server_2,csv_blade_platform,,,,csv_chassis,1
csv_server_3,csv_blade_platform,,,,csv_chassis_2,2,,,csvuser@example.com
csv_server_4,csv_platform,csv_rack,15,front,,,configuration,AA:AA:AA:AA:AA:BC
csv_сервер_5,csv_platform,csv_rack,16,front,,
#bmc
1.2.3.4,ADMIN,password,redfish,csv_server_1
4.3.2.1,NoADMIN,no password,lanplus,csv_server_2,https://www.google.com
#server_ip
10.99.0.77,csv.domain,csv_server_1,true
10.99.0.78,csv.domain,csv_server_1
10.99.0.79,csv.domain,csv_server_1
2001:db8:abcd:1234::2,csv.domain,csv_server_1
#ups
csv_ups_1,emerson_liebert_nx,2.2.2.2,csv_rack,27,1,false,,some note,2,community
csv_ups_2,keor_mod_250,2.2.2.3,csv_rack,28,1,false,,some note,2,community
csv_ups_3,apc,2.2.2.4,csv_rack,25,1,false,,,1,community
csv_ups_4,apc,2.2.2.5,csv_rack,26,1,false,,,3,community,username,password,3,sha,aes,private_key
#pdu
csv_pdu_1,apc,2.2.1.4,csv_rack,29,0.5,false,,,2,community
csv_pdu_2,raritan,2.2.1.5,csv_rack,29.5,0.5,false,,,2,community
csv_pdu_3,rpcm,2.2.1.6,csv_rack,22,0.5,false,,pdu note,1,community
csv_pdu_4,c3_solutions,2.2.1.7,csv_rack,22.5,0.5,false,,pdu note,3,community,username,password,3,sha,aes,private_key
#switch
snmp,csv_switch_1,zyxel_xgs_old,1.2.2.4,csv_rack,23,0.5,true,front,,2,community
snmp,csv_switch_2,cisco_snmp,1.2.2.5,csv_rack,23.5,0.5,true,rear,switch note,1,community
snmp,csv_switch_3,snmp_common,1.2.2.6,csv_rack,21,1,false,,,3,community,username,password,3,sha,aes,private_key
netconf,csv_switch_4,juniper_with_els,1.2.2.7,csv_rack,20,1,false,,,netconf_user,netconf_password,555
nxapi,csv_switch_5,cisco_nexus_nxapi,1.2.2.8,csv_rack,19,1,false,,,nxapi_username,nxapi_password,777,https
eapi,csv_switch_6,arista_eapi,1.2.2.9,csv_rack,18,1,false,,,eapi_username,eapi_password
mikrotik,csv_switch_7,mikrotik_api,1.2.2.10,csv_rack,17,1,false,,,mikrotik_username,mikrotik_password,777,true

Импорт оборудования

Операция импорта оборудования необратима. Перед импортом обязательно сделайте резервную копию платформы. Подробнее о резервном копировании см. в статье Резервное копирование платформы.

Чтобы импортировать оборудование из CSV-файла:

  1. Перейдите в Настройки → Импорт оборудования.
  2. Укажите Локацию, в которую будет добавлено оборудование.
  3. Выберите файл для загрузки.
  4. Нажмите Импортировать.
Интерфейс окна Импорт оборудования
Интерфейс окна Импорт оборудования

После завершения операции вы получите уведомление в интерфейсе платформы.

Диагностика

После выполнения хотя бы одной операции вы сможете посмотреть логи о её выполении в окне Импорт оборудования.

Интерфейс окна Импорт оборудования с раскрытыми логами по операции
Интерфейс окна Импорт оборудования с раскрытыми логами по операции
Может быть полезно
Дата последнего обновления статьи: 17.12.2025. Статья подготовлена техническими писателями ISPsystem