Command Line Utilities
From DreamFactory
Usage
The Console provides command-line access to all GUI features except reporting. This is provided through Laravel's artisan tool. To see the list of available commands, simply run php artisan from the Console installation directory:
dfadmin@console:/var/www/console$ php artisan Laravel Framework version 5.1.x (LTS) Usage: command [options] [arguments] Available commands: ... dfe dfe:blueprint Generates an instance blueprint dfe:capsule Encapsulate a managed instance for direct access. dfe:cluster Create, update, delete, and manage clusters dfe:daily Performs daily maintenance tasks dfe:deprovision Deprovisions, or shuts down, a running instance dfe:export Create a portable instance export dfe:import Import a portable instance export dfe:info Extract information from the system dfe:manifest Generates a cluster manifest file (.dfe.cluster.json) for DFE installations. dfe:metrics Gather overall system metrics dfe:migrate-instance Run migration for an instance. dfe:mount Create, update, and delete mounts dfe:move-instance Moves an instance from one server to another. dfe:provision Provision a new instance dfe:register Creates a key pair used to communicate with the DFE Console dfe:server Create, update, and delete servers dfe:setup Initializes a new installation and generates a cluster environment file. dfe:token Generates a token for an instance dfe:update Update DFE Console to the latest version. dfe:users Manage DFE Dashboard users. ...
Conventions
In the usage sections to follow, the common options will be omitted. These options exist for**all* console commands:
-h, --help Display this help message
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi Force ANSI output
--no-ansi Disable ANSI output
-n, --no-interaction Do not ask any interactive question
--env[=ENV] The environment the command should run under.
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
=== Command Types ===
There are two basic types of commands: entity and operational. Entity commands manage the logical entities within the [[DFE/Console|Console]]. These commands are `dfe:cluster`, `dfe:mount`, and `dfe:server`. Operational commands are all the rest. These commands manipulate the entities or the system.
== dfe:blueprint ==
Usage:
dfe:blueprint [options] [--] <instance-id> [<instance-uri>] [<admin-email>] [<admin-password>]
Arguments:
instance-id The id of the instance to inspect.
instance-uri The URI of the instance (i.e. "http://localhost")
admin-email An instance administrator email
admin-password An instance administrator password
Options:
--no-commit Do not commit the result to the repo
-d, --dump Dump the blueprint to stdout as well as writing to disk
-k, --api-key=API-KEY The API key to use instead of auto-generated token
Help:
Generates an instance blueprint
== dfe:capsule ==
Usage:
dfe:capsule [options] [--] <instance-id>
Arguments:
instance-id The instance to encapsulate
Options:
-d, --destroy Destroys a previously created capsule.
Help:
The dfe:capsule command encapsulates a managed instance for direct access.
php artisan dfe:capsule <instance-id> [-d|--destroy]
== dfe:cluster ==
Usage:
dfe:cluster [options] [--] <operation> [<cluster-id>]
Arguments:
operation The operation to perform: show, create, update, delete, add (server to cluster), or remove (server from cluster)
cluster-id The id of the cluster upon which to perform operation [default: "cluster-gha-1"]
Options:
--owner-id=OWNER-ID The "owner-id" of this cluster
--owner-type=OWNER-TYPE The type of owner: USER, INSTANCE, SERVER, MOUNT, CLUSTER, SERVICE_USER, OWNER_HASH, CONSOLE, DASHBOARD, APPLICATION, SERVICE, TESTING, _DEFAULT_NAMESPACE_
--subdomain=SUBDOMAIN The subdomain in which this cluster resides
-m, --max-instances=MAX-INSTANCES The maximum number of instances allowed, if any.
--server-id=SERVER-ID The "server-id" to "add" or "remove"
Help:
Create, update, delete, and manage clusters
== dfe:daily ==
Usage:
dfe:daily [options]
Options:
--dry-run When specified, no instances will be deprovisioned.
Help:
Performs daily maintenance tasks
== dfe:deprovision ==
Usage:
dfe:deprovision [options] [--] <instance-id>
Arguments:
instance-id The instance to deprovision
Options:
-c, --cluster-id[=CLUSTER-ID] The cluster containing the instance [default: "cluster-gha-1"]
-h, --help Display this help message
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi Force ANSI output
--no-ansi Disable ANSI output
-n, --no-interaction Do not ask any interactive question
--env[=ENV] The environment the command should run under.
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
Help:
Deprovisions, or shuts down, a running instance
== dfe:export ==
Usage:
dfe:export [options] [--] <instance-id>
Arguments:
instance-id The instance to export
Options:
-d, --destination[=DESTINATION] The path to place the export file.
-h, --help Display this help message
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi Force ANSI output
--no-ansi Disable ANSI output
-n, --no-interaction Do not ask any interactive question
--env[=ENV] The environment the command should run under.
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
Help:
Create a portable instance export
== dfe:import ==
Usage:
dfe:import [options] [--] <owner-id> <instance-id> <snapshot> [<guest-location>]
Arguments:
owner-id The id of the owner of the new instance
instance-id The name of the new instance
snapshot The path of the snapshot file
guest-location The location of the new instance [default: "dreamfactory"]
Options:
-c, --cluster-id[=CLUSTER-ID] The cluster where this instance is to be placed. [default: "cluster-gha-1"]
--indirect If specified, the "snapshot" value is a snapshot-id not a path
--owner-type=OWNER-TYPE The owner-id of the new instance
Help:
Import a portable instance export
== dfe:info ==
Usage:
dfe:info [options] [--] <entity-type> [<entity-id>]
Arguments:
entity-type The type of entity information to retrieve: mount, server, cluster, instance, or metrics
entity-id The id of the entity-type
Options:
-a, --all Return all data, ignoring entity-id
-s, --start-date=START-DATE The start date for a range of metrics data
-e, --end-date=END-DATE The end date for a range of metrics data
-f, --format[=FORMAT] The format in which to output the information. Available formats are: json or xml
-u, --ugly For formatted output, does not pretty-print output
--escaped-slashes For JSON formatted output, slashes will be escaped (default is that they are not)
-t, --owner-type=OWNER-TYPE The "owner-type" of the entity (required by "app-key") [default: 0]
-h, --help Display this help message
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi Force ANSI output
--no-ansi Disable ANSI output
-n, --no-interaction Do not ask any interactive question
--env[=ENV] The environment the command should run under.
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
Help:
Extract information from the system
== dfe:manifest ==
Usage:
dfe:manifest [options] [--] <cluster-id> <web-server-id> [<output-file>]
Arguments:
cluster-id The id/name of the cluster
web-server-id The id/name of the web server from "cluster-id"
output-file The /path/to/manifest/file to write. Otherwise it is written to the current working directory.
Options:
-c, --create Create a new manifest file. This is the default.
-k, --no-keys If specified, no application keys will be generated.
-s, --show If specified, show the contents of an installation's manifest.
--owner-id=OWNER-ID The owner id for the manifest key if not 0 [default: 0]
--owner-type=OWNER-TYPE The owner type for the manifest key if not "dashboard" [default: "dashboard"]
-h, --help Display this help message
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi Force ANSI output
--no-ansi Disable ANSI output
-n, --no-interaction Do not ask any interactive question
--env[=ENV] The environment the command should run under.
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
Help:
Generates a cluster manifest file (.dfe.cluster.json) for DFE installations.
== dfe:metrics ==
Usage:
dfe:metrics [options]
Options:
--gather When specified, all metrics are gathered and written to the database. Use when scheduling jobs.
-f, --to-file=TO-FILE Write metrics to a file.
--console-only Only gather "console" metrics
--dashboard-only Only gather "dashboard" metrics
--instance-only Only gather "dashboard" metrics
--no-usage-data[=NO-USAGE-DATA] Do not send usage data if true [default: false]
--force Force overwrite of daily gather
-h, --help Display this help message
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi Force ANSI output
--no-ansi Disable ANSI output
-n, --no-interaction Do not ask any interactive question
--env[=ENV] The environment the command should run under.
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
Help:
Gather overall system metrics
== dfe:migrate-instance ==
Usage:
dfe:migrate-instance [options] [--] [<instance-id>]
Arguments:
instance-id The instance to migrate
Options:
-a, --all Migrate *all* cluster instances
-c, --cluster-id=CLUSTER-ID If specified with "--all", will migrate only instances managed by "cluster-id".
-s, --seed If specified, "--seed" will be passed to any "migrate" commands
-h, --help Display this help message
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi Force ANSI output
--no-ansi Disable ANSI output
-n, --no-interaction Do not ask any interactive question
--env[=ENV] The environment the command should run under.
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
Help:
Run migration for an instance.
== dfe:mount ==
Usage:
dfe:mount [options] [--] <operation> [<mount-id>]
Arguments:
operation The operation to perform: show, create, update, or delete
mount-id The id of the mount upon which to perform operation
Options:
-t, --mount-type=MOUNT-TYPE The type of mount: LOCAL, SFTP, S3
--owner-id=OWNER-ID The "owner-id" of this mount
--owner-type=OWNER-TYPE The type of owner: USER, INSTANCE, SERVER, MOUNT, CLUSTER, SERVICE_USER, OWNER_HASH, CONSOLE, DASHBOARD, APPLICATION, SERVICE, TESTING, _DEFAULT_NAMESPACE_
-p, --root-path=ROOT-PATH The "root-path" of the mount
-c, --config=CONFIG JSON-encoded array of configuration data for this mount
-h, --help Display this help message
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi Force ANSI output
--no-ansi Disable ANSI output
-n, --no-interaction Do not ask any interactive question
--env[=ENV] The environment the command should run under.
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
Help:
Create, update, and delete mounts
== dfe:move-instance ==
Usage:
dfe:move-instance [options] [--] <server-id> [<instance-id>]
Arguments:
server-id The destination server of the move
instance-id The instance to move
Options:
-a, --all Move *all* instances
-p, --purge Purge existing credentials from database. Only used with database server moves.
-c, --cluster-id=CLUSTER-ID If specified with "--all", only the instances managed by "cluster-id" will be moved.
-h, --help Display this help message
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi Force ANSI output
--no-ansi Disable ANSI output
-n, --no-interaction Do not ask any interactive question
--env[=ENV] The environment the command should run under.
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
Help:
Moves an instance from one server to another.
== dfe:provision ==
Usage:
dfe:provision [options] [--] <owner-id> <instance-id> [<guest-location>]
Arguments:
owner-id The id of the owner of the new instance
instance-id The name of the new instance
guest-location The location of the new instance. Values: "amazon", "dreamfactory", "azure", "rackspace", "openstack", or "local" [default: "dreamfactory"]
Options:
--owner-type[=OWNER-TYPE] The "owner-id" type. Values: "0" (user), "1" (instance), "2" (server), "3" (mount), "4" (cluster), "5" (service_user), "6" (owner_hash), "1000" (console), "1001" (dashboard), "1002" (application), "1003" (service), or "9999" (testing) [default: 0]
-c, --cluster-id[=CLUSTER-ID] The cluster where this instance is to be placed. [default: "cluster-gha-1"]
-h, --help Display this help message
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi Force ANSI output
--no-ansi Disable ANSI output
-n, --no-interaction Do not ask any interactive question
--env[=ENV] The environment the command should run under.
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
Help:
Provision a new instance
== dfe:register ==
Usage:
dfe:register <owner-id> <owner-type>
Arguments:
owner-id The id of the owner of this key
owner-type One of the following owner types: user, instance, server, mount, cluster, service_user, owner_hash, console, dashboard, application, service, or testing
Options:
-h, --help Display this help message
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi Force ANSI output
--no-ansi Disable ANSI output
-n, --no-interaction Do not ask any interactive question
--env[=ENV] The environment the command should run under.
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
Help:
Creates a key pair used to communicate with the DFE Console
== dfe:server ==
Usage:
dfe:server [options] [--] <operation> [<server-id>]
Arguments:
operation The operation to perform: show, create, update, or delete
server-id The id of the server upon which to perform operation
Options:
-t, --server-type=SERVER-TYPE The type of server: APP, WEB, DB
-m, --mount-id=MOUNT-ID The id of the storage mount for this server
-a, --host-name=HOST-NAME The host name of this server
-c, --config=CONFIG JSON-encoded array of configuration data for this server
-h, --help Display this help message
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi Force ANSI output
--no-ansi Disable ANSI output
-n, --no-interaction Do not ask any interactive question
--env[=ENV] The environment the command should run under.
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
Help:
Create, update, and delete servers
== dfe:setup ==
Usage:
dfe:setup [options] [--] <admin-email>
Arguments:
admin-email The admin email address.
Options:
--force Use to force re-initialization of system.
--no-manifest Do not create a manifest file.
--no-keys Do not create initialization keys.
--admin-password[=ADMIN-PASSWORD] The admin account password to use. [default: "dfe.admin"]
--api-secret[=API-SECRET] The API secret to use. If not specified, one will be generated
-h, --help Display this help message
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi Force ANSI output
--no-ansi Disable ANSI output
-n, --no-interaction Do not ask any interactive question
--env[=ENV] The environment the command should run under.
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
Help:
Initializes a new installation and generates a cluster environment file.
== dfe:token ==
Usage:
dfe:token <instance-id>
Arguments:
instance-id The instance id
Options:
-h, --help Display this help message
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi Force ANSI output
--no-ansi Disable ANSI output
-n, --no-interaction Do not ask any interactive question
--env[=ENV] The environment the command should run under.
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
Help:
Generates a token for an instance
== dfe:update ==
Usage:
dfe:update [options]
Options:
--no-composer If specified, a "composer update" will NOT be performed after an update.
--no-clear If specified, the caches will not be cleared after an update.
-h, --help Display this help message
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi Force ANSI output
--no-ansi Disable ANSI output
-n, --no-interaction Do not ask any interactive question
--env[=ENV] The environment the command should run under.
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
Help:
The dfe:update command checks github.com for newer
versions of DFE Console and if found, installs the latest.
php artisan dfe:update
== dfe:users ==
Usage:
dfe:users [options] [--] <operation> <email>
Arguments:
operation The operation to perform: show, create, update, delete, activate, deactivate
email The email address of the target user
Options:
--format=FORMAT Output show in alternate format. Valid types are: json and xml
-u, --ugly For formatted output, does not pretty-print output
--escaped-slashes For JSON formatted output, slashes will be escaped (default is that they are not)
--force Use to force current operation.
--password=PASSWORD The password of the target user
-f, --first-name=FIRST-NAME The first name of the target user
-l, --last-name=LAST-NAME The last name of the target user
--nickname[=NICKNAME] The nickname of the target user
-h, --help Display this help message
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi Force ANSI output
--no-ansi Disable ANSI output
-n, --no-interaction Do not ask any interactive question
--env[=ENV] The environment the command should run under.
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
Help:
Manage DFE Dashboard users.
