blob: 91bbdc2c2dcae4dd77050eb5be670ee00223639c (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
|
SOLARCTL(1)
# NAME
solarctl - manage _solard_ instances across a network
# SYNOPSIS
solarctl <remote host> <subcommand> [options]
# DESCRIPTION
solarctl is a command-line API client for `solard` API servers to manage virtual
machines over a network.
# SUBCOMMANDS
All subcommands except "login" will require authentication.
## LOGIN
Performs the first-time login process with a remote solard server, and stores it
in $XDG_CONFIG_HOME/$REMOTE_ADDRESS/config.json.
Syntax:
solarctl <remote host> login <random key>
The random key is printed to the stdout of the remote solard server, and changes
each time the server is restarted. The token returned will be a PASETO public
token signed by the remote solard server.
## LIST
Lists all created virtual machines on the remote server.
Example:
solarctl localhost:3000 list
## PAUSE
Pauses a virtual machine.
Example:
solarctl localhost:3000 pause <uuid>
The UUID of the virtual machine can be obtained from the LIST command.
## STOP
Sends the shutdown signal to the virtual machine. When used with *-f*, sends a
force-shutdown signal.
Example:
solarctl localhost:3000 stop <uuid> [-f]
## REBOOT
Sends the reboot signal to the virtual machine. When used with *-f*, sends a
force-reboot signal.
Example:
solarctl localhost:3000 reboot <uuid> [-f]
## START
Starts the virtual machine if it is stopped.
Example:
solarctl localhost:3000 start <uuid>
## VIEW
Opens a virtual console window to the virtual machine using virt-viewer(1).
Example:
solarctl localhost:3000 view <uuid>
# SEE ALSO
_virt-viewer_(1)
|
