Device42 integration¶
The OctoSAM to Device42 integration module provides inventory information to Device42. No devices are created, since it is assumed that Device42 gets information about new devices early in their lifecycle from other sources, such as financials.
Architecture¶
The integration connects through the Device42 REST API and updates devices with matching machine names. Integration logic and the Device42 API client are integrated in the OctoSAM base software and can be configured in the appsettings.json file.
OctoUtil¶
Synchronization can be triggered with the octoutil sync device42 command. We recommend configuring it through Housekeeping Scripts after daily housekeeping.
Device fields¶
| Fieldname | Type | Description |
|---|---|---|
| manufacturer | String | Normalized manufacturer name from OctoSAM catalog (only for physical machines) |
| hardware | String | Scanned hardware model name (only for physical machines) |
| ram_size | Number | RAM Size in GB |
| cpu_speed | Number | Processor speed in GHz |
| hz_id | Number | always value 2 (GHz) |
| total_cpus | Number | Number of sockets |
| core_per_cpu | Number | |
| threads_per_core | Number | |
| hard_disk_count | Number | Number of disk devices (USB disk and mounted filesystems are not counted) |
| hard_disk_size | Number | Total size of disk in GB |
| bios_version | Number |
Operating system fields¶
OperatingSystem is its own entity in Device42; for a new OS, OctoSAM creates the OS entity and then the relations to the device.
| Fieldname | Type | Description |
|---|---|---|
| manufacturer | String | Normalized manufacturer name from OctoSAM catalog |
| name | String | Name of the operating system |
Device custom fields¶
| Fieldname | Type | Description |
|---|---|---|
| FirstScan | Date | OctoSAM first scan date |
| LastScan | Date | OctoSAM last scan date |
| LastFoundInDirectory | Date | Date OctoSAM last found this object in Active Directory |
| DeletedInDirectory | Boolean | Optional flag that OctoSAM detected deletion of the object in ActiveDirectory |
Device URL¶
Optionally, OctoSAM creates a device URL that points to the device's page in OctoSAM.
Synchronization status fields in OctoSAM¶
Optionally, synchronization writes its state to the SynchLastSynch and SynchTokenId fields in the OctoSAM database. These fields can be shared with other integrations (except ServiceNow integration, which has its own exclusive fields), Only one integration can write its state back to the database.