--- title: "Device Lifecycle" slug: "device-lifecycle" description: "Learn how to manage Graphiant devices throughout their lifecycle, from onboarding and operation to replacement and retirement." updated: 2026-06-10T20:42:04Z published: 2026-06-10T20:42:04Z canonical: "docs.graphiant.com/device-lifecycle" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.graphiant.com/llms.txt > Use this file to discover all available pages before exploring further. # Device Lifecycle With Graphiant, it’s easy to navigate all of your device service and maintenance needs in one place. From viewing the states of your Edges, to creating bootstrap tokens for onboarding, it’s easy to manage all of your devices in the Device Lifecycle center. ## Locating the Device Lifecycle in the Graphiant Portal From the Graphiant Portal home screen, **click ‘Maintain’** in the left sidebar; **select ‘Device Lifecycle’**. ![Dashboard overview showing device lifecycle and usage statistics for user management.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Portal Landing Pg 9-25 'Maintain'; 'Device Lifecycle'.jpeg) This will take you to the Device Lifecycle area of the Graphiant Portal. ![Overview of device lifecycle status, including activated, staging, and maintenance devices.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle landing pg.png) ## Devices Information The Landing page for the Device Lifecycle area is the “Devices” tab. Here you can: - Visualize: - The states of your Graphiant devices - What devices are scheduled to be upgraded - Any devices whose software is End-Of-Life - Any failed upgrades - Change the state of your devices - Schedule an upgrade ![Overview of device lifecycle status including activated, staging, and maintenance devices.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Dev Lifecycle 'Devices' Tab highlighted.png) The filters at the top are clickable and will show you which devices currently fall into the following categories: - **Activated:** Up and running and connected to the Graphiant Core - **Staging:** Provisioned but not currently connected to the Graphiant Core - **Maintenance:** Online but not receiving traffic; possibly due to undergoing configuration changes (click [here](/v1/docs/maintenance-mode) for further information on Maintenance Mode) - **Scheduled Upgrades:** Marked to receive a software release upgrade - **EOL Software:** Configured with a software release that is at End-Of-Life for support - **Upgrade Failures:** Experiencing a failure at upgrade - **Connected Devices:** Connected to the Graphiant Core - **Disconnected Devices:** Not connected to the Graphiant Core To deselect a filter, simply click that filter box again. > [!NOTE] > Note: > > Only one filter at a time may be activated; filters are not stackable. ![Overview of device lifecycle with activated, staging, and disconnected device counts displayed.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Dev Lifecycle filters highlighted 3-26.png) The Devices table shows the following: - **Upgrade Status:** Whether the device is up to date, or an upgrade is available - Upon hover, you will see: - The Release Train you are on (Latest or Recommended) - The Version currently installed - For “Up to Date” devices, the date that version was installed ![Software details showing version, release train, and installation date information.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle info upon hover on 'Up to Date'.jpg) - For “Upgrade Available” devices, the version that is available ![Software details showing upgrade status, current version, and latest version information.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle info upon hover on 'Upgrade Available'.jpg) - **Host Name:** The name of your device - **Lifecycle State:** Whether the device is: - ***Activated******:*** Up and running and connected to the Graphiant Core - ***Staging******:*** Provisioned but not currently connected to the Graphiant Core - ***Maintenance******:*** Having configurations performed on them; online but not receiving traffic (click [here](/v1/docs/maintenance-mode) for further information on Maintenance Mode) - **Software Version:** Which software is currently running on the device - **Rollout Name:** [***coming soon*] - **Site:** Where the device is located and configured - **Connected Regions:** Regions through which the device is connected to the Graphiant Core - **Location:** Estimated location based on IP address ![Overview of device lifecycle status, highlighting upgrade availability and connected devices.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Dev Lifecycle Table highlighted 3-26.png) ### Changing the Lifecycle State of Your Graphiant Device Should you need to change the lifecycle of your device, **click on the ellipses** to its right; **select ‘Change Lifecycle State’**. ![Device lifecycle management interface showing active and staging devices with upgrade options.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Devices tab 3 dots 'Change Lifecycle State'.jpg) Alternatively, if multiple devices are selected, the actions are listed at the top of the table. **Select ‘Change Lifecycle State’.** ![Device lifecycle management interface showing upgrade options and device statuses.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle mult Edges 'Change Lifecycle State' at top.jpg) A modal will appear to set the state change, along with the number of devices selected that will receive the change. **Click the carat** to see the state options. ![Popup window for changing device lifecycle state with selection options.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycyle Change State modal caret highlighted.jpg) **Select the desired state from the dropdown.** **![Popup window for changing device lifecycle state with options to select mode.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle change state modal choice dd open.jpg)** **Confirm the selection; click ‘Change Mode’** to proceed. ![Dialog box for changing device lifecycle state to maintenance mode.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle change state modal 'Change Mode'.jpg) You will receive a notification that the state change was successful, and the table will be updated to reflect the new lifecycle state. ![Device lifecycle management interface showing status updates and upgrade options for devices.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle State in table now 'Maintenance'.jpg) ### Upgrade Rollouts Upgrade Rollouts provide flexible control over edge software updates, allowing you to either schedule recurring batches of upgrades or initiate immediate upgrades on demand. From the Device Lifecycle page, **click the ‘Upgrade Rollouts’ tab.** ![Device lifecycle management interface showing upgrade rollouts and device statuses.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Dev Lifecycle 'Upgrade Rollouts'.png) This will open the Upgrade Rollout table. Here you will see the following: - **Status:** - **Upgrade Scheduled:** Upgrade will be performed at a later date/time - **Failed:** At least one Edge in the rollout failed to upgrade > [!NOTE] > Note: > > More status options will be coming soon. - **Name:** Assigned name of the rollout - **# of Devices:** How many devices are included in the rollout. - Clicking this link will open up the list of all edges included. - **Release Train:** Which software the upgrade will select from: Latest, Recommended, or Stable - **Upgrade Type:** Whether the upgrade is download only, download & install, or install only - **Trigger:** Whether the upgrade was a single user-triggered event, or on a schedule to repeat - **Next Run:** - If scheduled, when the next upgrade will occur - If User-triggered, when the upgraded did occur - **Description:** Optional user-defined information for ease of reference ![Overview of device upgrade rollouts with action required and scheduled upgrades displayed.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Dev Lifecycle Rollout Table(2).png) #### Creating an Upgrade Rollout To create a new rollout of Graphiant Edges, **click ‘Create New Rollout’.** ![Device lifecycle management interface showing upgrade rollout options and a prompt to create a new rollout.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Dev Lifecycle 'Create New Rollout'.png) Fill out the following fields: - **Name:** User-defined name of rollout - **Description (optional):** User-defined for future reference if desired - **Rollout Type:** click the button that best suits your needs - Download Only - Download and Install - Install Only - **Release:** - **Install Timing:** - **User Triggered Disabled** - **If toggled “On”:** - This will be a scheduled rollout, and a calendar will appear. Select your date & time, the frequency of the rollout schedule, and whether the rollout will repeat on a specific date / day of the week. - **If toggled “Off”:** - This will be a one-time rollout, and it will occur immediately upon rollout creation; there will be no calendar option. - **Select Devices:** - Select all devices to be included in this rollout > [!WARNING] > A device can only be included in ONE upgrade rollout: > > If the same device is added to a new upgrade rollout, that device will be removed from its prior upgrade rollout. Confirm that all information is correct. **Click ‘Create Rollout’.** ![Details for creating a documentation rollout including target software and install timing.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Dev Lifecycle Create Rollout fields.png) A green banner will appear stating that the rollout creation was successful, and the new rollout will appear in the table. ![Overview of upgrade rollouts showing action required and scheduled upgrades status.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Dev Lifecycle green banner rollout successful.png) > [!WARNING] > Note: > > You will need to [approve the rollout](/v1/docs/device-lifecycle#activating-a-rollout) before it can begin. #### Approving an Upgrade Rollout To approve an upgrade rollout, **click the ellipses and select ‘Approve Rollout’.** ![Overview of device upgrade rollouts with action required and scheduled upgrades displayed.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Dev Lifecycle 'Approve Rollout'.png) A green banner will appear stating that the rollout was scheduled successfully. The rollout will now occur as configured. ![Overview of upgrade rollouts with scheduled actions and device statuses displayed.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Dev Lifecycle green banner rollout scheduled successfully after approval.png) #### What To Do If Your Upgrade Rollout Results in a “Failed” Status If any Edge in the upgrade rollout group failed to upgrade, the rollout will result in a “**Failed**” status. You can either attempt the rollout again, or delete that rollout group (see instructions [here](/v1/docs/device-lifecycle#deleting-an-upgrade-rollout)). ##### Retrying Your Rollout To attempt the rollout again, **click the ellipses to the right of the rollout; select ‘Retry rollout’**. ![Table displaying upgrade statuses, including failed and scheduled upgrades for devices.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Dev Lifecycle Rollout Failed 'Retry rollout'.png) **Choose whether to retry the upgrade “Now” or “Later;** if “Later” is chosen, a calendar will be available to select date and time. **Click ‘Retry rollout’.** > [!NOTE] > Only the devices that were unsuccessful in the rollout will be retried; > > Devices that were upgraded successfully will not be affected. ![Retry rollout options for software upgrade, including timing and affected devices listed.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Dev Lifecycle Retry Rollout Modal.png) #### Editing an Upgrade Rollout Group To edit an upgrade rollout, **click the ellipses and select ‘Edit Rollout’.** ![Overview of device upgrade rollouts with action required and scheduled upgrades displayed.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Dev Lifecycle 3 dots; 'Edit Rollout'.png) Make any desired edits; **click ‘Save Changes’**. ![Edit rollout settings including name, description, and installation timing for devices.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Dev Lifecycle Eiditing Rollout 'Save Changes'.png) A green banner will appear stating that the rollout was updated successfully. ![Overview of device upgrade rollouts with action required and scheduled upgrades displayed.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Dev Lifecycle Edited green banner updated successfully.png) #### Deleting an Upgrade Rollout To delete an upgrade rollout, **click the ellipses and select ‘Delete Rollout Group’.** ![Overview of device upgrade rollouts with action required and scheduled upgrades displayed.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Dev Lifecycle 3 dots; 'Delete Rollout Group'.png) A modal will appear asking if you are sure you want to delete the Rollout Group; **click ‘Confirm’**. ![Confirmation dialog asking to delete Documentation 2 with Cancel and Confirm options.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Dev Lifecycle Confirm Delete Rollout Group.png) A green banner will appear stating that the Rollout was deleted successfully. The Upgrade Rollout will no longer appear in the table. ![Overview of upgrade rollouts showing action required and scheduled upgrades status.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Dev Lifecycle Rollout Deletion successful.png) ### Scheduling a Manual Upgrade of Your Graphiant Device Should you want to manually upgrade your device at a given future point in time, from the ‘Devices’ tab, **click on the ellipses** to the right of that device; **select ‘Schedule Manual Upgrade’**. ![Device lifecycle management interface showing upgrade statuses and options for devices.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Devices tab 3 dots 'Schedule Manual Upgrade'.jpg) Alternatively, if multiple devices are selected, the actions are listed at the top of the table. **Select ‘Schedule Manual Upgrade’.** ![Device lifecycle management interface showing upgrade options and device statuses.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle mult Edges 'Schedule Manual Upgrade' at top(1).jpg) This will open a modal to customize your upgrade. Fill out the following fields: - **Upgrade Type:** - ***Download and Install:*** Install the software to your device as well as have a copy downloaded - ***Download Only:*** Download the software, install at a later date - **Upgrade Timing:** - ***Now:*** The upgrade will happen immediately - ***Later:*** The upgrade will be scheduled for a future time and date in a calendar that will appear here - **Select Version:** - ***Recommended:*** The software that is released every 3 months, after having been utilized and tested for three months prior. See more information on [Recommended Releases](https://docs.graphiant.com/docs/software-release-information-for-service-upgrades#recommended-release). - ***Latest:*** The software version that is released every month with the most recent features. See more information on [Latest Releases](https://docs.graphiant.com/docs/software-release-information-for-service-upgrades#latest-release). ![Options for software upgrade type, timing, and version selection displayed on the screen.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Scheduling Manual SW Upgrade modal including Stable.jpg) Once you have filled in the desired information, **click ‘Schedule Upgrade’**. ![Schedule a manual software upgrade by selecting options for timing and version.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle upgrade modal 'Schedule Upgrade'.jpg) #### Software Upgrade Scheduled for “Now” If you selected “Now” for your upgrade, the device will immediately start the process. While the software is upgrading, the device will be put in Maintenance Mode, and the status will read “Upgrade in Progress”. Click [here](/v1/docs/maintenance-mode) for further information on Maintenance Mode. ![Device lifecycle management showing upgrade status and maintenance for various devices.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Update in Progress.jpg) When complete, the device will have a status of “Up to Date” in the Device table. ![Device lifecycle management table showing upgrade status and active devices.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Up to Date in table after Upgrade.jpg) #### Software Upgrade Scheduled for “Later” If you selected “Later” for your upgrade, the device will show an Upgrade Status of “Upgrade Scheduled”. ![Device lifecycle management showing upgrade status and software versions for various devices.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle 'Upgrade Scheduled'(1).jpg) Upon hover, you will see: - The Release Train of the software to be installed upon upgrade - The software Version that will be installed - The date & time that the upgrade will occur ![Software upgrade status showing scheduled and available updates with version details.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Scheduled Upgrade info on hover.jpg) ### Performing Rollback to the Previous Software Version If your device has the Status of “Up to Date” you can roll back to the prior version of software. > [!NOTE] > Note: > > You can only roll back to the software version that was immediately prior to the current software. > > Devices that have a Status of “Upgrade Available” will not have this option. **Click the ellipses; select ‘Rollback to Previous Version’.** ![Device lifecycle management table showing upgrade statuses and actions for various devices.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle 3 dots 'Rollback to Previous Version'(1).jpg) A modal will appear confirming the rollback intention, and that a brief service interruption may be experienced during the process. **Click ‘Rollback Devices’.** ![Confirmation prompt for rolling back a device to a previous software version.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/'Device Lifecycle Rollback modal warning 'Rollback Devices;.jpg) While the rollback is in progress, the device will automatically be put into Maintenance Mode. Click [here](/v1/docs/maintenance-mode) for further information on Maintenance Mode. ![Device lifecycle management showing upgrade status and maintenance for various devices.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Rollback 'Upgrade in Progress' and in Maint Mode.jpg) The device will now be back on the prior software version, and out of Maintenance Mode. > [!NOTE] > Note: > > You can upgrade again at any time. ![Device lifecycle management showing upgrade status and active devices in a table format.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle after rollback for Doc360 to recognize.jpg) ## Provisioning Information for Your New Graphiant Device If you have a new device, the “Provisioning” tab of Device Lifecycle is the place for you to set up your new device. Here you can: - Download current software versions to load onto a new device - Generate custom, device-specific tokens for use upon initial boot-up ![Device lifecycle management interface showing system images and bootstrap tokens section.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Dev Lifecycle Prov Tab.png) ### Downloading Up to Date Software to Load onto Your New Graphiant Device The downloads of current software versions are found under “System Images:”. The dates within each Release train indicate when it was last updated. ![Overview of system images for device provisioning with latest, recommended, and stable options.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Provisioning Tab System Images highlighted(1).jpg) **Click the carat** to see the format options for the software version of your choice. ![Device lifecycle management interface showing system images and bootstrap tokens for provisioning.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Provisioning Tab Carat to open download dd(1).jpg) **Select the download file** that works best for your device. ![Device lifecycle management interface showing software download options and release information.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle select download format(1).jpg) You will receive a green banner stating that the image download has begun. ![Device lifecycle management interface showing successful image download notification and bootstrap tokens.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle green banner 'image download started successfully'(1).jpg) ### Bootstrap Tokens Graphiant offers Bootstrap Tokens, making it quick and easy to have a basic configuration immediately installed upon boot-up, allowing a new device to connect to the Graphiant network. Whether you have procured your hardware on your own, or have a new virtual machine, you can onboard it to the Graphiant network using Bootstrap Tokens. Bootstrap Tokens are located at the bottom of the Provisioning Tab within the Device Lifecycle. > [!NOTE] > Note: > > Each Bootstrap Token can be used only once. They are unique and for one-time usage. The table gives the following information: - **Status:** Whether the token has been used or not - **Used By:** If the token has been used, the Name and Serial Number of the device by which it was utilized - **Token Name:** Assigned name of the token - **Token:** The unique token ID - **Mode:** - **Simple:** The token contains “Name” and “Device Role” assigned only; no advanced configuration - **Custom:** The token contains advanced configuration options - **Device Type (Custom Mode only):** What type of device by which the token will be used ![Device lifecycle management interface showing Bootstrap Tokens and system images options.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Provisioning Tab Bootstrap Tokens highlighted(1).jpg) #### Generating a New Bootstrap Token To create a new Bootstrap Token, **click ‘Generate Token’** at the top right of the Bootstrap Tokens table. ![Device lifecycle management interface showing system images and token generation options.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Provisioning Tab 'Generate Token'(1).jpg) ##### Generating a Single Bootstrap Token For one Bootstrap Token, in filling out the Basic Configuration, complete the following required fields: - **Number of Tokens:** Leave as “1” - **Token Name:** Type the name with which you want to refer to this token - **Device Role:** Choose from: - CPE: Edge Connectivity to the Graphiant Core - Gateway: Direct cloud connectivity to the Graphiant Core ![Configuration screen for generating a token with device role options and input fields.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Single Bootstrap Token Basic Config Fields.jpg) From here you can either: 1. **Click ‘Generate Token’:** > [!NOTE] > When you click ‘Generate Token’: > > It will also download the Cloud Init files to your computer. ![Configuration settings for generating a token in a cloud environment interface.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Single Bootstrap Token Only Basic Config 'Generate Token'.jpg) ***OR*** 2. **Add Advanced Configuration information (optional):** Advanced Configuration contains the following: > [!NOTE] > Note: > > Each one of these fields is optional. - **Device and Interface Configuration —** customizes the network settings to your device - ***Device Type:*** The name / model that matches your device - ***Hostname:*** Name assigned to your device - **Management Interface —** For local device access and configuration; If not specified, this will pre-populate. - **Management Interface:** Ethernet interface to reach the device - **WAN Interface —** Defines the interface and network settings used for WAN connectivity; If not specified, this will pre-populate. - **WAN Interface:** Interface that will connect to the Graphiant Core - **Custom Configuration —** Advanced device-specific configuration for the Cloud Init file - **LWS Toggle:** Option to enable the Local Web Server to access locally - If toggled on, a password is required. - **DNS Servers:** IP address to the DNS server your device will use ![Configuration options for generating tokens, including device settings and management interface.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Single Bootstrap Token Only Advanced Config Fields.jpg) Once you have completed the desired fields, **click ‘Generate Token’**. > [!NOTE] > When you click ‘Generate Token’: > > It will also download the Cloud Init files to your computer. ![Configuration settings for generating a token, including device and network options.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Single Bootstrap Token Advanced Config complete 'Generate Token'.jpg) Once you have generated the token (using Advanced Configuration or not), you will receive a green banner stating that the token has been successfully generated, and the new Bootstrap Token will appear in the table. ![Device lifecycle management interface showing system images and bootstrap tokens section.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle table after adding single bootstrap token(2).jpg) ##### Generating Multiple Bootstrap Tokens If you need to create multiple Bootstrap Tokens: - **Number of Tokens:** Enter as many as needed - **Device Role:** Use the dropdown to choose: - CPE: Edge Connectivity to the Graphiant Core - Gateway: Direct cloud connectivity to the Graphiant Core > [!NOTE] > Note: > > The name field is not present here, as this information will be gathered later. **Then click the carat to access Advanced Configuration** ![Configuration settings for generating three tokens with device role CPE.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Mult Bootstrap Tokens Basic Config and Carat for Adv Config.jpg) **Click the carat to open the dropdown for ‘Device Type’.** ![Configuration settings for generating tokens, including device type and role options.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Mult Bootstrap Tokens Carat for Adv Config.jpg) **Select the name / model that matches your device.** > [!NOTE] > Note: > > When configuring multiple bootstrap tokens at once, they must all be the same Device Type. ![Configuration settings for generating tokens in a cloud environment interface.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Mult Bootstrap Tokens Device Type dd open.jpg) You will see a box that contains a link to a worksheet where you will input the configurations for your tokens. **Click ‘Bulk Import Worksheet’.** ![Configuration interface for importing hardware settings using a CSV file worksheet.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Mult Bootstrap Tokens Get Excel Form 'Bulk Import Worksheet'.jpg) The worksheet will have headers asking for your configuration information. **Fill out the rows beneath the headers with your corresponding configuration data as shown below.** > [!NOTE] > For Local Web Password: > > If you fill out this column for any token, the Graphiant Portal will know to enable Local Web Server in your configuration. ![Table displaying device information including hostnames, IP addresses, and management types.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Mult Edges Excel Spreadsheet Form from Portal.jpg) **Select ‘Browse Files’ to select the completed worksheet.** ![Advanced configuration options for importing hardware configuration from CSV files.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Mult Bootstrap Tokens 'Browse Files' to choose Excel spreadsheet.jpg) **Click ‘Upload file’** to provide the information to the Graphiant Portal. ![Configuration settings for generating tokens and uploading a configuration file.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Mult Bootstrap Tokens 'Upload File'.jpg) You will now see a green banner stating that your file was uploaded successfully. You can preview your configuration by scrolling left and right through the information at the bottom of the modal. **Click ‘Generate Token’** once you have confirmed your data. > [!NOTE] > When you click ‘Generate Token’: > > It will also download the Cloud Init files to your computer. ![Configuration preview for generating tokens with device types and hostnames listed.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Mult Bootstrap Tokens Config Preview after upload 'Generate Tokens'.jpg) The new Bootstrap Tokens are now complete and in the table. ![Overview of device provisioning with highlighted bootstrap tokens and their details.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Mult Bootstrap Tokens complete and in table(2).jpg) #### Copying a Bootstrap Token To copy a Token value, **click the ellipses** to the right of that token**; select ‘Copy Token’**. ![Device lifecycle management interface showing system images and bootstrap tokens for provisioning.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle 3 dots 'Copy Token'(2).jpg) You will see a green banner stating that the token is in your clipboard. ![Device lifecycle management interface showing system images and bootstrap tokens for devices.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle landing page for copied banner after all added(1).jpg) #### Downloading a Bootstrap Token File Should you need to downloaded another copy of the file, **click the ellipses** to the right of the desired token; **select ‘Download File’**. ![Device lifecycle management interface showing system images and bootstrap tokens options.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle 3 dots 'Download File'(1).jpg) The configuration will be downloaded on your computer as a .zip file. #### Duplicating a Bootstrap Token Configuration Sometimes you may wish to make token configurations that are either the same as, or so similar to, another token that it’s easier to use a prior configuration and make minor adjustments. In this case, you can just duplicate the original token configuration and tweak from there. To duplicate a configuration, **click the ellipses** to the right of the token whose configuration is to be duplicated; **select ‘Duplicate Configuration’**. ![Device lifecycle management interface showing system images and bootstrap tokens options.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle 3 dots 'Duplicate Configuration'(1).jpg) This will open a modal for a Duplicate Bootstrap. The configuration will be identical, except for the Token Name, which will be “[Original Token Name] - Copy”. Make any alterations needed, including the name. ![Configuration screen for duplicating a token with highlighted token name and options.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Duplicate Bootstrap modal.jpg) You will see a green banner stating that the token was successfully generated and the duplicated token will appear in the table. ![Bootstrap tokens section showing unused tokens and their details for device provisioning.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Config Duplicated in table(2).jpg) #### Deleting a Bootstrap Token Should you no longer need a previously-created token, it can be deleted easily. **Click the ellipses** to the right of the token to be deleted; **select ‘Delete Token’**. ![Device lifecycle management interface showing system images and bootstrap tokens for provisioning.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle 3 dots 'Delete Token'(1).jpg) A warning modal will appear: > [!CAUTION] > Warning: > > You will no longer be able to download a Cloud Init file for the deleted token. **Click ‘Delete Token’.** ![Warning message about deleting a token with confirmation options displayed.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Token Delete Warning.jpg) You will receive a green banner stating that the token was successfully deleted, and it will no longer appear in the table. ![Device lifecycle management interface showing system images and bootstrap tokens for configuration.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Device Lifecycle Token Deleted from table(2).jpg) ## Returning Your Graphiant Edge Whether you have been provided your Graphiant Edge by Graphiant or a Managed Service Provider, when the time has come to send the device back, you will receive a notification in your Graphiant Portal. **Click the ‘Returns' tab.** ![Overview of device lifecycle management with highlighted returns section and device statuses.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Returns Tenant Dev Lifecycle 'Returns' Tab.png) This will take you to the Device Returns table, where you will see the Edge(s) that has been requested to be returned. ![Device returns overview showing hostname, status, mode, serial number, model, and software version.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Returns Tenant Device Returns Table.png) Clicking the ellipses to the right of the device will give two options: 1. **Accept Return:** To confirm the return process to your supplier and allow that device to be sent back. 2. **Deny Request:** To notify the supplier if you need changes made to the return request. The device will remain in its current state. ![Device returns section showing hostname, status, and options to accept or deny requests.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Returns Tenant Dev Lifecycle 3 dots from Returns Table.png) ### Accepting Your Return Request To the right of the device that was requested to be returned, **click the ellipses; select ‘Accept Return"‘**. ![Device returns section showing hostname, status, and option to accept return request.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Returns Tenant Dev Lifecycle 'Accept Return'.png) > [!CAUTION] > Warning: > > Accepting the return of your device is final and cannot be undone. **Check the box to acknowledge the action cannot be undone; select ‘Mark as Returned’.** ![Confirmation dialog for marking a device as returned with acknowledgment checkbox.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Returns Tenant Dev Lifecycle Accept Return Modal(1).png) A green banner will appear stating that the return request was approved successfully, and the returned device will no longer be in your inventory. ![Device returns section showing no data available with an astronaut illustration.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Returns Tenant green banner Return Request Approved Successfully.png) ### Denying Your Return Request Should you need changes made to the return request you received, you can deny the request and ask for the request to be edited and resent. To the right of the device that was requested to be returned, **click the ellipses; select ‘Deny Request"‘**. ![Device returns interface showing hostname, status, and deny request option.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Returns Tenant Dev Lifecycyle 'Deny Request'.png) **Check the box to require a resubmit of the return request; click ‘Deny Request’.** ![Confirmation dialog to deny a return request with resubmission option highlighted.](https://cdn.document360.io/d86ecd1c-49f6-4fac-83cc-5e344f28f84f/Images/Documentation/Returns Tenant Dev Lifecycle 'Deny Request'(1).png) Your supplier will receive the message that they need to edit and resend the return request. The device will remain in its current lifecycle state.