infra-agent/INSTALLER_GUIDE.txt at develop · ddthien-coder/infra-agent · GitHub

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
Infrastructure Agent Installer Creation Guide
==========================================

This guide explains how to create an installer for the Infrastructure Agent that includes a configuration wizard for server URL and login credentials.

PREREQUISITES:
--------------
1. Python 3.6 or higher
2. Inno Setup 6 (download from http://www.jrsoftware.org/isinfo.php)
3. Required Python packages (will be installed automatically):
   - cx_Freeze
   - requests
   - psutil

CREATION STEPS:
---------------

1. BUILD THE EXECUTABLE:
   Run the build script:
   > python build_package.py --build

2. CREATE THE INSTALLER:
   a. Open setup.iss in Inno Setup Compiler
   b. Click "Build" or press F9
   c. The installer will be created as InfraAgentSetup.exe

INSTALLER FEATURES:
------------------

The installer includes:
- Configuration wizard for server URL and login credentials
- Option to run at Windows startup for all users
- Automatic detection of logged-in domain users
- Simple installation process

INSTALLER USAGE:
----------------

When running the installer, users will be prompted to:
1. Select installation directory
2. Enter server URL (default: https://10.1.32.66)
3. Enter email and password for authentication
4. Choose whether to run at startup

The installer will:
- Install the agent to Program Files
- Configure the agent with provided settings
- Optionally add the agent to Windows startup for all users
- Create desktop and start menu shortcuts

ADMINISTRATOR INSTALLATION:
--------------------------

For domain environments:
1. Run the installer as administrator
2. The agent will be installed for all users
3. Each user login will be correctly detected by the agent
4. Data will be reported with the correct user context

TECHNICAL DETAILS:
-----------------

The installer uses Inno Setup with custom code to:
- Show configuration pages during installation
- Update the config.json file with user-provided values
- Create shortcuts in the All Users startup folder when selected
- Handle both local and domain user scenarios

The agent's enhanced user detection works by:
1. Using WMIC to query the current logged-in user
2. Checking active user sessions with "query user"
3. Using PowerShell WMI queries as fallbacks
4. Analyzing environment variables for user context