5c838751df8a5ee85e2cc0eb48356cd96987a7e7
[AGL/documentation.git] / docs / ATTIC / 3_Developer_Guides / 4_X(cross)_Development_System:_User's_Guide / 4_X(cross)_Development_System:_ Internals / 3.4.4.3_xds-agent / 3.4.4.3.3_Start_Up.md
1 <!-- WARNING: This file is generated by fetch_docs.js using /home/boron/Documents/AGL/docs-webtemplate/site/_data/tocs/devguides/master/xds-docs-guides-devguides-book.yml -->
2
3 # Start-up
4
5 ## Start-up based on systemd user service
6
7 For **Linux** distro, XDS agent can be started as a user service by Systemd.
8
9 ```bash
10 /usr/lib/systemd/user/xds-agent.service
11 ```
12
13 Use well-known systemd commands to control `xds-agent.service` service.
14
15 ```bash
16 # Status XDS agent:
17 systemctl --user status xds-agent
18
19 # Start XDS agent
20 systemctl --user start xds-agent
21
22 # Stop XDS agent
23 systemctl --user stop xds-agent
24 ```
25
26 Default settings are defined in  `/etc/default/xds-agent` file but these
27 settings you can overwritten by `$HOME/.xds/agent/agent-config.json` file,
28 see [Configuration chapter](./2_config.html) for more details.
29
30 ## Manual start-up
31
32 On **Linux or MacOS**, simply execute `xds-agent` executable:
33
34 ```bash
35 /opt/AGL/bin/xds-agent
36 ```
37
38 On **Windows**, simply execute `xds-agent` executable (root path may change
39 depending where you installed/unzipped xds-agent tarball):
40
41 ```batch
42 C:\AGL\bin\xds-agent.exe
43 ```
44
45 <!-- section-note -->
46 **Note:**
47
48 If need be, you can increase log level by setting option
49 `--log <level>`, supported *level* are: panic, fatal, error, warn, info, debug.
50
51 Invoke `xds-agent --help` to get more details about possible options that allow
52 for example to change logging level or select a specific configuration file.
53
54 <!-- end-section-note -->