summaryrefslogtreecommitdiffstats
path: root/docs/part-2/2_xds-agent/3_start.md
blob: d750fac8471c30c37da99a338af919ae4a62f28b (plain)
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
# Start-up

## Start-up based on systemd user service

For **Linux** distro, XDS agent can be started as a user service by Systemd.

```bash
/usr/lib/systemd/user/xds-agent.service
```

Use well-known systemd commands to control `xds-agent.service` service.

```bash
# Status XDS agent:
systemctl --user status xds-agent

# Start XDS agent
systemctl --user start xds-agent

# Stop XDS agent
systemctl --user stop xds-agent
```

Default settings are defined in  `/etc/default/xds-agent` file but these
settings you can overwritten by `$HOME/.xds/agent/agent-config.json` file,
see [Configuration chapter](./2_config.html) for more details.

## Manual start-up

On **Linux or MacOS**, simply execute `xds-agent` executable:

```bash
/opt/AGL/bin/xds-agent
```

On **Windows**, simply execute `xds-agent` executable (root path may change
depending where you installed/unzipped xds-agent tarball):

```batch
C:\AGL\bin\xds-agent.exe
```

<!-- section-note -->
**Note:**

If need be, you can increase log level by setting option
`--log <level>`, supported *level* are: panic, fatal, error, warn, info, debug.

Invoke `xds-agent --help` to get more details about possible options that allow
for example to change logging level or select a specific configuration file.

<!-- end-section-note -->