Skip to content

Commit

Permalink
update skywire-visor documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
0pcom committed Aug 15, 2022
1 parent 91c8a46 commit d819543
Showing 1 changed file with 21 additions and 7 deletions.
28 changes: 21 additions & 7 deletions cmd/skywire-visor/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,8 +24,8 @@ make install

## Skywire-visor usage

After the installation, you can run `skywire-visor -h` to see the usage:

After the installation, you can run `skywire-visor -h` to see the usage or `skywire-visor --all` for advanced usage:
_Note: flags for autopeering are only available with the environmental variable `SKYBIAN=true`
```
$ skywire-visor --help
Expand All @@ -40,7 +40,6 @@ Flags:
-c, --config string config file to use (default): skywire-config.json
-b, --browser open hypervisor ui in default web browser
-i, --hvui run as hypervisor
-u, --user use config at: $HOME/skywire-config.json
--all show all flags
-h, --help help for skywire-visor
-v, --version version for skywire-visor
Expand All @@ -55,22 +54,21 @@ Flags:
skywire-visor [flags]
Flags:
-b, --browser open hypervisor ui in default web browser
-c, --config string config file to use (default): skywire-config.json
-b, --browser open hypervisor ui in default web browser
-i, --hvui run as hypervisor
-j, --hv string add remote hypervisor PKs at runtime
-k, --xhv disable remote hypervisors set in config file
-l, --hvip string set hypervisor by ip (default "192.168.2.2:7998")
-m, --autopeer enable autopeering
-n, --stdin read config from stdin
-p, --pkg use package config /opt/skywire/skywire.json
-q, --pprofmode string pprof mode: cpu, mem, mutex, block, trace, http
-r, --pprofaddr string pprof http port (default "localhost:6060")
-t, --tag string logging tag (default "skywire")
-u, --user use config at: $HOME/skywire-config.json
-y, --syslog string syslog server address. E.g. localhost:514
-z, --completion string [ bash | zsh | fish | powershell ]
-h, --help help for skywire-visor
-v, --version version for skywire-visor
```

### Skywire visor flags
Expand All @@ -88,6 +86,22 @@ Mutually exclusive flags:

The ` -b, --browser` flag is not available to root / with sudo.

### Autopeering visors to a hypervisor

The autopeering system is used in skybian to peer visors to a remote hypervisor on a predetermined static IP address.

For the autopeering of visors to a remote hypervisor to work, neither a remote nor a local hypervisor may be set in the config file.

The `-m` and `-l` flags will simply be ignored if there are remote or local hypervisors in the config file used by the visor

As well, the environmental variable `SKYBIAN=true` must be present

```
skywire-visor -mp
```

To use a desktop as the hypervisor which visors autopeer to, run the `skywire-cli visor pk -w` command on the desktop and specify on the visors (or in the visor's systemd service file) the ip address of the desired hypervisor using the `-l` flag for skywire-visor

## Config file generation

Refer to the [skywire-cli documentation](../skywire-cli/README.md) for more detailed information regarding additional flags and argument that may be passed to the following command:
Expand Down

0 comments on commit d819543

Please sign in to comment.