Matching results

How to import systems from Inventory?

  • Go to Inventory > Systems and click on Import.
  • Enter a CSV file for bulk system import in Airvantage. Download template here . For more information on how-to fill the csv file, please check below.
  • Click on Start.

Import CSV file format

To import systems, you need first to create a system that will serve as a template. The firmware and applications set on this template system will be reused to create further systems. The template system is identified through a UID (Unique Identifier) which is available in Inventory > Systems > Details:

You can format your bulk import file depending on your needs. The portal server uses the file header to interpret the different lines. Here are the fields that can be part of the CSV header with their meaning and use.

The file format is a .csv file (comma separated text file). Both comma ‘,’ and semi-colon ‘;’ are supported as separators.

All fields are optional and may be used or not depending on your use case.

FIELD DESCRIPTION
NAME Name to be set to the system
TEMPLATE uid of the template system. Is mandatory if you create a system with a firmware or application.
LABELS One or more label(s) to be applied on the created system. For provinding several labels, use the pipe ‘|’ separator.
GATEWAY[IMEI] IMEI of the Gateway to be created.
GATEWAY[MAC ADDRESS] MAC address of the gateway to be created.
GATEWAY[SERIAL NUMBER] Serial Number of the gateway to be created. Can be retreived or scanned from the Gateway or module.
GATEWAY[TYPE] Type of the gateway to be created. Can be values such as GX400, ES440 or FXT009 for AirLink gateways/modems or SL8080T, HL8548 for AirPrime modules.
GATEWAY[LABELS] One or more label(s) to be applied on the created gateway. For provinding several labels, use the pipe ‘|’ separator.
GATEWAY_REF[UID] In case you want to reuse a pre-created gateway, the gateway to be reused is identified by its uid. Only one GATEWAY_REF header shall be used in header, with identifier of choice.
GATEWAY_REF[IMEI] In case you want to reuse a pre-created gateway, the gateway to be reused is identified by its IMEI. Only one GATEWAY_REF header shall be used in header, with identifier of choice.
GATEWAY_REF[MAC ADDRESS] In case you want to reuse a pre-created gateway, the gateway to be reused is identified by its Mac address. Only one GATEWAY_REF header shall be used in header, with identifier of choice.
GATEWAY_REF[SERIAL NUMBER] In case you want to reuse a pre-created gateway, the gateway to be reused is identified by its Serial Number. Only one GATEWAY_REF header shall be used in header, with identifier of choice.
SUBSCRIPTION[IDENTIFIER] ICCID/ESN of the subscription to be created. For creating a subscription, one item b/w IDENTIFIER, MOBILE NUMBER and NETWORK IDENTIFIER shall be provided.
SUBSCRIPTION[MOBILE NUMBER] MSISDN (telephone number) of the subscription to be created.
SUBSCRIPTION[NETWORK IDENTIFIER] IMSI of the subscription to be created.
SUBSCRIPTION[IP] IP address of the subscription to be created.
SUBSCRIPTION[OPERATOR] Subscription operator. This field is mandatory for creating a system with a subscription.
SUBSCRIPTION[OPERATOR ACCOUNT] uid of the operator account for the subscription to be created. This is required to use subscription management functionalities.
SUBSCRIPTION[LABELS] One or more label(s) to be applied on the created subscription. For provinding several labels, use the pipe ‘|’ separator.
SUBSCRIPTION_REF[IDENTIFIER] In case you want to reuse a pre-created subscription, this is the subscription ICCID/ESN to be reused for creating the system.
MSCI[host] To be used for AirLink gateways, as they use MSCI as a communication protocol. To be filled in for the server initiated option. If you are currently able to initiate communications out to the gateway either by public static IP or domain name, enter public IP address or complete domain name.
MQTT[password] If you use MQTT as a communication protocol, you will want to provide the MQTT password.
MSCI[password] To be used for AirLink gateways, as they use MSCI as a communication protocol. To be filled in for the server initiated option and to be able to remotely change the AceManager password. If you are currently able to initiate communications out to the gateway either by public static IP or domain name, enter the AceManager password used to login to this device directly.
M3DA[password] If you use M3DA as a communication protocol, you will want to provide the M3DA password. This is especially the case for ALEOS AF and AirPrime MC series.
REST[password] If you use REST as a communication protocol, you will want to provide the REST password.


Import CSV file examples

Here follow some examples of how to format headers depending on whether gateways and subscriptions are already created in the AirVantage. It describes simple as well as advanced cases. To reuse an existing gateway, you have to use the GATEWAY_REF fields.

Creating systems with existing gateways based on serial number

NAME,TEMPLATE,GATEWAY_REF[SERIAL NUMBER]

MySystem,5221e1c2b2e54782aa0fe8e928c257c8,CA123456789045324

Creating systems with existing gateways based on uid, a subscription, and system labels

NAME,TEMPLATE,GATEWAY_REF[UID],LABELS,SUBSCRIPTION_REF[IDENTIFIER]

MySystem,5221e1c2b2e54782aa0fe8e928c257c8,2e8b9db6678a4498bde1f9d85f0f7af4,NewYork|Demo,60DC26A7

Creating systems with new gateways based on serial number

NAME,TEMPLATE,GATEWAY[SERIAL NUMBER],GATEWAY[TYPE]

MySystem,5221e1c2b2e54782aa0fe8e928c257c8,CA123456789045324,GX400

Creating systems with new gateways, server initiated capabilites and labels for gateways and systems

NAME,TEMPLATE,GATEWAY[IMEI],GATEWAY[MAC ADDRESS],GATEWAY[SERIAL NUMBER],GATEWAY[TYPE],GATEWAY[LABELS],LABELS,MSCI[HOST],MSCI[PASSWORD]

MySystem,5221e1c2b2e54782aa0fe8e928c257c8,123456789074689,01:23:45:67:89:AB,SW31MBP0064162,ES440,Shipped,NewYork|Demo,343.76.2.45,12345

Creating systems with new gateways and new KPN subscriptions

NAME,TEMPLATE,GATEWAY[SERIAL NUMBER],GATEWAY[TYPE],SUBSCRIPTION[IDENTIFIER], SUBSCRIPTION[OPERATOR] MySystem,5221e1c2b2e54782aa0fe8e928c257c8,SW31MBP0064162,ES440,8912345678907543247,KPN

TOP