Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update docs add info #25

Merged
merged 3 commits into from Oct 25, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
6 changes: 5 additions & 1 deletion README.md
@@ -1,6 +1,6 @@
# Nautobot Plugin - Device Lifecycle Management

A plugin for [Nautobot](https://github.com/nautobot/nautobot) to manage device lifecycles.
A plugin for [Nautobot](https://github.com/nautobot/nautobot) to manage device lifecycles. This plugin works by making related associations to Devices, Device Types, and Inventory Items to help provide data about the hardware end of life notices, appropriate software versions to be running on the devices, and the maintenance contracts associated with devices. This will help with the various aspects of planning life cycle events, and provides quick access to ancillary data about the devices in Nautobot.

## Installation

Expand Down Expand Up @@ -59,6 +59,10 @@ sudo systemctl restart nautobot-rq-worker
```

## Usage

### Adding Information into the Plugin

The system currently has manual/API entry of data only. There are currently no connections to any particular vendor APIs that provide this data today. See [adding data docs](docs/add_information.md) for more info.
### Hardware LifeCycle Management
#### API
![](docs/images/lcm_hardware_api_view.png)
Expand Down
23 changes: 23 additions & 0 deletions docs/add_information.md
@@ -0,0 +1,23 @@
# Adding Data to Device Life Cycle Plugin

To add data into the Device Life Cycle Plugin, you need to either add it manually throught the UI, or through the REST API endpoint. In this current version there is no synchronization of data from a vendor API endpoint, but this may be a feature request in the future.

## Plugin API Definition

To add information via the REST API, please look at the Swagger API docs for the plugin once installed. This will provide you the same documentation for working with other devices.

## UI - Additions

### Hardware LifeCycle

When running Nautobot 1.1.0 or later, there is a separate menu added named `Device LifeCycle`. This will be seen on the top menu bar. From here you will find the typical navigation for the addition of items. For example, to add a Hardware Notice for end of life, select `Device LifeCycle` -> Plus sign next to `Hardware Notices`. This will bring up the new Hardware notice page. In this page, fill out the appropriate information from the drop down menus to create the hardware notice.

> In order for a hardware notice to be created, there must be either an existing Device Type or Inventory Item that can be found in the database. Without these data points, the data cannot be added, as a relationship is built to the particular items.

### Software

Software follows the same methodology. First you add Software that is applicable for a particular platform. Then fill in the required fields of Version and add the corresponding relationships.

### Maintenance Contracts

The maintenance contracts has a similar feel as the Circuit Providers as part of the core of Nautobot. There is a `Contract Provider` that provides the particular maintenance contract. Then individual `Contracts` are associated with the provider. As an optional add on a Point of Contact can be made to associate with the contract and named escalation tree if required.