ZeroTouch Bulk De-register

**Process use files found on shared drive at Technical Services\Customer Files\ZeroTouch Resources**

What to Expect

This guide will show how to remove a large number of devices from the Zero-Touch portal simultaneously. You can expect to learn how to prepare a CSV file with the specific device identifiers, upload it to the portal to initiate the de-registration, and finally, verify that the devices have been successfully removed from the system.

Prerequisites

Before proceeding, ensure you have the following:

1. Portal Access: You must have valid credentials with the necessary permissions to access and manage devices in the Zero-Touch reseller and customer config portals.

   • • Poral Link

       • • Zero Touch Reseller Portal

     • Credentials

       • • Email: zt.admin@sstid.com

         • Password: Mdm4Life@@

2. Device Identifiers: Be sure to identify if the device being deregistered consists of IMEIs or Serial Numbers 

   • • Cellular = IMEI 

     • Non Cellular = Serial

3. CSV Editor: Create a spreadsheet application capable of editing and saving files in CSV (Comma-Separated Values) format (e.g., Microsoft Excel, Google Sheets, LibreOffice Calc). It is recommended to use the premade google sheet that is located here as well as on the top of the page. 

Proceed to the "Preparing the CSV File" section.

Preparing the CSV File

If not using the premade template, follow step 1, otherwise skip to step 2.

1. Open your preferred spreadsheet application and create a new file.

   • • Create the CSV file using the following template:

       • • Create Column Headers: 

         • Column A: modemtype

         • Column B: modemid

         • Column C: serial

         • Column D: model

         • Column E: manufacturer

         • Column F: profiletype

         • Column G: owner

         • Column H: ordernumber

         • Column I: preprovisioningtoken

         • Column J: attesteddeviceid

2. In the columns, list the IMEI, Serial Number, or MEID of each device you wish to de-register. Each identifier should be in its own row.

   • • Set the Owner Value: In the owner column, enter the number 0 for each device listed. This value instructs the portal to de-register the device.
       Reference the CSV file setup pictures below

3. Save the file in CSV format. 

   • • In Google Sheets: 

       • • Select File > Download > Comma Separated Values (CSV)

Proceed to the "Uploading the CSV File to the Zero-Touch Portal" section.

Uploading the CSV File to the Zero-Touch Portal

1. Open a web browser (incognito) and navigate to the Zero-Touch reseller portal.

2. In the left-hand navigation panel, click on Devices.

3. In the top right of the "Registered Devices" table, click the "+ Add device" button and select the "CSV upload" option.

4. Select "browse your computer"

5. Upload the your CSV file:

   • • The portal will begin to process the file.

Proceed to the "Verifying De-registration" section.

Verifying De-registration

1. After the upload is complete, the portal will display a notification. Review this information to see if there were any errors during processing.

2. To confirm that the devices have been de-registered, use the search bar on the Devices page. Search for a few of the device identifiers from your CSV file.

3. If the de-registration was successful, the devices will no longer appear in the search results.

The De-registration process is complete

Notes and Troubleshooting

• Ensure your CSV file is not excessively large. The portal has a size limit, which is typically around 50 MB.

• Double-check that your CSV file is formatted correctly. The most common errors are incorrect column headers or invalid data.