Managed Instances > one instance. At the top, how it is - waiting to connect, * checking in or gone quiet - with what can be done to it: sign in as support, update it, * check for updates, make it read-only or suspend it. Under that, what needs a look from its * last report, the connection code while it's waiting for one, and what it has been asked and * how that went; alongside, what this manager sets for it and what it reported about itself. * * A connection code shows once, on the page its making redirects to - only its hash is kept * (managedInstanceNewCode()). The handlers are admin/post/managed_instances.php. */ require_once "includes/inc_all_admin.php"; // Off unless config.php turns it on - the list says how if (!managerEnabled() || !settingsColumnExists($mysqli, 'config_manager_keys')) { redirect('managed_instances.php'); } $instance_id = intval($_GET['id'] ?? 0); $row = managedInstanceRow($instance_id); if (!$row) { ?>
That instance is gone - it may have been deleted. Managed Instances
['tone' => 'secondary', 'icon' => 'fa-unlink'], $state === 'pending' => ['tone' => 'secondary', 'icon' => 'fa-plug'], $state === 'offline' => ['tone' => 'danger', 'icon' => 'fa-server'], $worst === 'danger' => ['tone' => 'danger', 'icon' => 'fa-server'], $worst === 'warning' => ['tone' => 'warning', 'icon' => 'fa-server'], default => ['tone' => 'success', 'icon' => 'fa-server'], }; // What it has been asked, newest first $commands = []; $sql = mysqli_query($mysqli, "SELECT * FROM managed_instance_commands WHERE managed_command_instance_id = $instance_id ORDER BY managed_command_created_at DESC, managed_command_id DESC LIMIT 15"); while ($command = mysqli_fetch_assoc($sql)) { $commands[] = $command; } $waiting = (bool) array_filter($commands, function ($command) { return in_array($command['managed_command_status'], ['queued', 'sent', 'running'], true); }); $updating = (bool) array_filter($commands, function ($command) { return $command['managed_command'] === 'update_now' && in_array($command['managed_command_status'], ['queued', 'sent', 'running'], true); }); $can_act = !$removed && $connected && $url !== ''; $status_pill = function (string $status) { $tone = ['queued' => 'secondary', 'sent' => 'info', 'running' => 'primary', 'done' => 'success', 'failed' => 'danger', 'cancelled' => 'secondary'][$status] ?? 'secondary'; $words = ['queued' => 'Waiting for its check-in', 'sent' => 'Sent', 'running' => 'Running', 'done' => 'Done', 'failed' => 'Failed', 'cancelled' => 'Cancelled'][$status] ?? $status; return '' . escapeHtml($words) . ''; }; $fact = function (string $label, string $value_html) { return '
  • ' . $label . '' . $value_html . '
    • '; }; $when = function ($datetime, string $never = 'Never') { return $datetime ? '' . escapeHtml(timeAgo($datetime)) . '' : '' . $never . ''; }; $size = function ($mb) { $mb = floatval($mb); return $mb >= 1024 ? round($mb / 1024, 1) . ' GB' : round($mb) . ' MB'; }; ?>
    >

    Removed

    Removed . It lets go at its next check-in - what this manager set comes off it, and its support user is archived. . It checks in every minute from its own cron - either cron has stopped there, the server is down, or it can't reach this ITFlow. Checked in .

    Updating - it picks the request up at its next check-in and updates in the background. This page refreshes itself.

    It updates itself .

    Sign in as support Update
    Check for updates
    $mode_label) { if ($mode_key === $mode) { continue; } $mode_text = [ 'active' => ['Make it active', 'fa-check-circle', 'Everything works again for its users.'], 'read_only' => ['Make it read-only', 'fa-lock', 'Its users can sign in and look, export and download - but nothing can be changed. The portal and guest links work the same way.'], 'suspended' => ['Suspend it', 'fa-ban', 'Nobody can use it - agents, the portal, guest links and the API get a notice instead. Its data stays as it is, and backups and updates still run.'], ][$mode_key]; ?>
    New connection code
    Remove
    Delete

    Connect it

    1. On that ITFlow, sign in as an admin and open Admin > Managed By. It needs to be on this version or newer.
    2. Paste the code there and choose Connect. It works once, until .

    Copy it now - it isn't shown again. If it's lost, make a new one.

    time()) { ?>

    The code was shown when it was made - only a fingerprint of it is kept here. If it's lost, make a new one; the old one stops working.

    New connection code

    There's no code that works - .

    Make a connection code

    It checks in with this ITFlow at , so that has to be reachable from where it is. Nothing here ever connects to it - it can be behind a firewall.

    Health

    Reported
    All good - cron is running, it's up to date, backups are recent and nothing has gone wrong today.
    The last update stopped with:

    Requests

    Nothing asked of it yet. Updates you start here, and automatic ones, show here with how they went.
    Request Status Asked Result
    Automatic' : escapeHtml((string) $command['managed_command_requested_by']) ?>

    Set from here

      ' . escapeHtml($row['managed_instance_mode_message']) . '
    ' : '')) ?> 0 ? '' . $seat_limit . ' agent' . ($seat_limit === 1 ? '' : 's') . '' : 'None - its own config decides') ?> Not set from here' : ($key_info ? 'On
    until ' . escapeHtml(date('M j, Y', strtotime((string) $key_info['expires']))) . '
    ' : 'The key has run out')) ?> Automatic
    ' . (intval($row['managed_instance_update_delay_days']) > 0 ? intval($row['managed_instance_update_delay_days']) . ' day' . (intval($row['managed_instance_update_delay_days']) === 1 ? '' : 's') . ' after one comes out' : 'As soon as one comes out') . ' - security fixes straight away
    ' : 'By hand
    From here - its admins can\'t
    ') ?>

    The instance

    Its details show once it has checked in.
    ') ?> ' . escapeHtml((string) $row['managed_instance_last_ip']) . '') ?>

    Notes