Management Task Templates
Management task templates control how AMRs respond when they receive system-level triggers. Creating a new management task template follows the same process as creating a basic task template.
Management task templates support all skills available in basic task templates (Redis, Register, Remote IO, HTTP, and Compare skills) plus the following additional skills:
| Skill | Description |
|---|---|
| Add Task | Add a new task to the system (maximum 500 active tasks) |
| Add Task to AGV | Assign a task directly to a specific AGV |
| Abort Task | Abort a single running task |
| Abort All Tasks | Abort all currently running tasks |
| Cancel All Tasks | Cancel all tasks in the queue |
| Hard Reboot DFleet | Perform a hard reboot of the DFleet server |
| Power Off DFleet | Power off the DFleet server |
| Log Message | Write a message to the system log |
| Send Email | Send an email notification |
| Resume AGV | Resume a specific paused AGV |
| Pause AGV | Pause a specific AGV |
| Start AGV | Start a specific AGV |
| Stop AGV | Stop a specific AGV |
| Resume All AGVs | Resume all paused AGVs |
| Pause All AGVs | Pause all AGVs |
| Start All AGVs | Start all AGVs |
| Stop All AGVs | Stop all AGVs |
| Reboot AGV | Reboot a specific AGV (soft mode=0, hard mode=1) |
| Power Off AGV | Power off a specific AGV |
| Check AGV Position | Check the current position of an AGV |
| Check AGV Position Prefix | Check the prefix of the AGV position name |
| Check AGV Position Suffix | Check the suffix of the AGV position name |
| Compare Station Distances | Compare distances between stations |
| Power Off Remote Host | Power off a remote host machine |
| Power Off UPS | Power off an uninterruptible power supply |
Management Task Triggers
Management task templates are activated by triggers rather than manual dispatch. There are 9 trigger types available:
| Trigger Type | Description |
|---|---|
| Executor Start | Fires when the DFleet executor starts |
| AGV Idle | Fires when an AGV enters an idle state |
| AGV Fleet Safety | Fires on fleet-wide safety events |
| AGV Safety | Fires on individual AGV safety events |
| Remote I/O Pin | Fires when a specific Remote I/O pin changes state |
| Remote I/O | Fires on general Remote I/O events |
| UPS Status | Fires on UPS status changes |
| UPS Battery Charge Capacity | Fires when UPS battery charge reaches a threshold |
| Custom Log | Fires when a matching custom log message is written |
Each trigger type has configurable modes that determine when the trigger fires. For example, AGV Safety supports three modes:
| Mode Value | Behavior |
|---|---|
| -1 | Fire once when the safety condition is triggered |
| 0 | Fire on both states (triggered and recovered) |
| 1 | Fire once when the safety condition is recovered |
Triggers export parameters to the task template for use in skill logic. For example, the AGV Safety trigger exports the following parameters:
| Parameter | Description |
|---|---|
| Safety AGV | The AGV that raised the safety event |
| Safety Status | Current safety status value |
| Navigation Failed | Whether navigation has failed |
| Out of Line | Whether the AGV is out of line |
| Bumper Block | Whether the bumper is blocked |
| External Safety Trigger | Whether an external safety trigger is active |
| Emergency Button | Whether the emergency button is pressed |
| Charger Connected | Whether the charger is connected |
| Laser Malfunction | Whether a laser malfunction is detected |
| Line Sensor Com Error | Whether a line sensor communication error occurred |
| Drive Overlimit Error | Whether a drive overlimit error occurred |
| Obstacle Block | Whether an obstacle is blocking the path |
| Resume Pending | Whether a resume operation is pending |
Transaction Manager
The Transaction Manager automates material transport workflows between stations. Enable it by checking the Enable Transaction Manager checkbox in the settings.
Three task templates must be configured for transactions to operate:
| Template | Purpose |
|---|---|
| Goto Task Template | Moves the AMR to the designated station |
| Loading Task Template | Handles carrier verification at pickup (scan carrier ID, verify, register via "Carrier Scanned at Port") |
| Unloading Task Template | Handles carrier drop-off at the destination station |
AGV Port Count defines the maximum number of carriers a single AMR can carry simultaneously, configurable from 1 to 100.
Station Ports are configured with the following properties:
| Property | Description |
|---|---|
| Name | Unique identifier for the port |
| Location | Physical location on the map |
| Port Group | Logical grouping for priority and routing |
| Allowed AGVs | Which AMRs may service this port |
| Transfer Content | What type of carrier or material is handled |
Loading and unloading priority can be set within each port group to determine the order in which stations are serviced. AGV-specific overrides allow per-AMR priority adjustments. Port Groups Attribute settings include Loading Priority and Unloading Priority.
Multi Port Rule allows advanced routing by defining a carrier prefix, allowed AGVs, and a combination of ports that work together in a single transaction.
Additional Transaction Manager settings:
| Setting | Description |
|---|---|
| Detour Distance | Maximum detour distance allowed when routing an AMR to a station |
| Carrier ID Duplicate Action | Action when a duplicate carrier ID is scanned (default: Reject) |
| Carrier ID Read Failure Action | Action when carrier ID cannot be read: Remove the transaction, or Continue with an UNKNOWN_ prefix assigned to the carrier |
Traffic Controller
The Traffic Controller manages path allocation and collision avoidance between AMRs. Access these settings from Settings > Traffic Controller.
Three key settings control traffic behavior:
- Maximum Buffer Count -- Configure the Distance (default 15m) and Junction Count (default 5) that are approved ahead of the AMR position. Higher values reduce intermittent stops but lower path-sharing efficiency among multiple AMRs.
- Trailing Mode -- Select between Loose mode (rear AMR moves when the front AMR reaches the next junction) or Tight mode (rear AMR moves when the front AMR departs the current junction). Tight mode increases throughput on shared paths but requires more precise timing.
- Alternative Path Constraints -- Set the Maximum Alternative Distance (default 10000m) to limit how far an AMR will detour to find an alternative path. Enable or disable Alternative Search to control whether AMRs attempt to find alternate routes when their primary path is blocked.
Backup and Restore
Creating a Backup:
- Select the components you want to include in the backup.
- Click Backup Settings to File. The backup file is saved with the naming convention
dfleet_backup_YYYYMMDD_HHMMSS.gz.
Restoring from a Backup:
- Upload the backup
.gzfile. - Select which data components to restore from the backup.
Advanced Restore provides four restore modes for granular control:
| Mode | Behavior |
|---|---|
| Restore | Clean restore -- replaces existing data with backup data |
| Import keep local | Imports backup data but skips any items that conflict with existing local data |
| Import overwrite local | Imports backup data and overwrites any conflicting local data |
| Import keep both | Imports backup data and renames conflicting items to keep both versions |
DFleet Cluster
DFleet Cluster provides high availability by running multiple DFleet servers in a coordinated group. The primary node leads all operations, while replica nodes stand by for failover.
Key cluster characteristics:
| Feature | Description |
|---|---|
| Auto-Failover | If the primary node goes offline, a replica automatically takes over operations |
| Synchronous Replication | Data is replicated synchronously across all nodes in real time |
| Time Synchronization | Clocks are synchronized between all cluster nodes |
| SMTP Alerts | Email alerts are sent when a cluster failure is detected |
Cluster operations available:
| Operation | Description |
|---|---|
| Create Cluster | Initialize a new cluster from this DFleet server |
| Join Cluster | Add this server as a replica to an existing cluster |
| Reassign Primary Node | Promote a replica node to become the new primary |
| Remove Replica Node | Remove a replica from the cluster |
| Destroy Cluster | Disband the entire cluster and return to standalone mode |
Network Connections
The Network Connections page displays the hostname, network scheme, and connection status for each ethernet port on the DFleet server.
Network Configuration Editor allows you to configure each ethernet port as either Static (fixed IP address) or DHCP (automatically assigned).
Hostname Editor allows you to change the DFleet server hostname as it appears on the network.
HTTPS Settings allow you to switch between HTTPS and HTTP mode. You can either upload your own private keys and certificates, or let DFleet auto-generate self-signed certificates.
Date and Time
Configure the system date, time, and timezone from this page. Enable Auto-synchronize with network time server to keep the DFleet clock aligned via NTP.
You can set a local NTP server address if your facility uses an internal time source. The Synchronization Status section displays the IP address of the currently synced NTP server.
DFleet Controller
The DFleet Controller page provides controls to reboot the server, view and toggle between Pause and Running states, and apply configuration changes.
Hot Reload applies task template changes without requiring a soft reboot, minimizing downtime when updating task configurations.
Two reboot options are available:
| Reboot Type | Behavior |
|---|---|
| Soft Reboot | Waits for all AGVs to complete their current tasks before restarting |
| Force Soft Reboot | Immediately restarts the DFleet server regardless of AGV task status |
The Apply Changes checkbox controls whether configuration modifications are applied. Changes are only applied when this checkbox is selected.
Use the mode selector to switch between Tracked and Trackless operating modes.
Users, Groups and Permissions
The Users page allows you to create and delete user accounts, change passwords, manage protection pins, and generate authority tokens.
| Field | Description |
|---|---|
| Username | The login identifier for the user |
| Permission Group | The group that determines the user's access level |
| Active | Whether the user account is enabled |
| Operations | Available actions (edit, delete, manage tokens) |
DFleet includes 4 default permission groups:
| Group | Access Level |
|---|---|
| Admin | Full access including permission list management |
| Supervisor | Extensive control over all system functions except permission list editing |
| User | Normal login access with assigned task templates |
| Call Button | Limited to task creation for assigned task templates only |
The Permissions page defines the access level for each permission group, controlling which features and operations are available to members of that group.
Reports
DFleet provides comprehensive reporting across several categories for monitoring fleet performance and system health.
AGV Activities provides a monthly overview of AMR performance including running jobs and idle time. Reports include Daily Activity Breakdown and Overall Activity Breakdown charts. Download data as CSV, filter by custom date range, and exclude specific AMRs from the report.
Activity codes are assigned by precedence from high to low:
| Code Range | Activity |
|---|---|
| 82-85 | Unplanned Maintenance / Planned Maintenance / System Failure / Hardware Failure |
| 81 | Powered Off |
| 80 | Not Ready |
| 300-303 | FMS Errors |
| 200 | Waiting User |
| 201 | Waiting Traffic |
| 100-199 | Safety Errors |
| 10 | Running App |
| 3 | Charging |
| 2 | Working |
| 1 | Paused |
| 0 | Idle |
Completed Tasks lists all completed tasks with the option to download monthly CSV reports. Analysis options include count-based, duration-based, and combined analysis reports. Custom date range reports are supported.
Completed Transactions shows all completed transactions with download capability, standard reports, and custom report generation.
System Monitor displays real-time CPU, Memory, and Hard Disc usage for the DFleet server.
Custom Log provides a filterable view of custom log messages generated by task template Log Message skills.
System Log displays all previous system logs for troubleshooting and audit purposes.
Download Log allows you to select a date range and download a bundled log file containing all system logs for that period.