Manual Discovery and Logon Scripts
In addition to scheduled and menu-driven discovery, xAssets supports manual discovery methods for situations where the standard approach is not suitable -- for example, machines behind restrictive firewalls, laptops that connect intermittently, or environments where remote WMI access is blocked.
Manual Discovery Using PCAnalyser
From any PC that has network access to the Collection Server share, you can run discovery manually using the Start > Run dialog or a command prompt:
\\<collectionserver>\pcanalyser\pcanalyser.exe /enc /flags 535 /idle
This command:
- Runs the PCAnalyser agent on the local machine (takes approximately 4 seconds)
- Writes an encrypted PCA file to
\\<collectionserver>\pcanalyser\netdiscover - Exits without leaving any files or services on the local machine
The PCA file is encrypted and can be viewed using the PCA File Viewer application, which is installed on the Collection Server under Start > xAssets Collection Server.
Manual Discovery Using XDSL Scripts
If the PCAnalyser folder structure is in place on a Collection Server, you can also launch a compiled XDSL script executable directly from the command line. This creates:
- PCA files -- if PCAnalyser was one of the selected technologies in the script
- PCZ files -- containing DNS information and data from agentless discovery techniques (WMI, SNMP, Remote Registry)
This approach is useful for one-off discovery of a specific subnet without going through the web interface.
Logon Script Discovery
Logon script discovery runs the PCAnalyser executable automatically each time a user logs on to their computer (or reboots). This is particularly useful when:
- Remote or mobile users (e.g., salespeople with laptops) only connect to the network occasionally
- Restrictive firewalls prevent remote WMI or SNMP access from the Collection Server
- Different administrator passwords across machines prevent a single Credential Pack from working everywhere
- You want continuous, passive discovery that captures data whenever machines connect
How to Set Up Logon Script Discovery
- Add a call to the PCAnalyser executable in your Active Directory Group Policy logon script:
\\<collectionserver>\pcanalyser\pcanalyser.exe /enc /flags 535 /idle - The
/idleflag ensures PCAnalyser waits until the system is idle before running, minimising impact on login speed - Each time a user logs on, the agent runs and writes an updated PCA file to the Collection Server share
- The data loader picks up these files and imports them into the database on its next run
Logon Script Considerations
| Factor | Detail |
|---|---|
| User impact | With the /idle flag, the impact on login time is minimal (a few seconds) |
| Network traffic | Each run uploads approximately 120KB and downloads approximately 40KB |
| Frequency | Data is collected at every logon, so frequently-rebooted machines will have very current data |
| Coverage | Only machines where users actually log on will be discovered -- machines that are always on but rarely logged into (servers, kiosks) will need a different approach |
Loading the Data
Regardless of whether data was collected manually or via logon scripts, the PCA files must be loaded into the database. This happens automatically when the data loader runs, or you can trigger it manually with Discover > Load Now (see Loading Discovery Data).
Related Articles
- Running Discovery — standard menu-driven discovery
- The PCAnalyser Folder — understanding the file share structure
- Loading Discovery Data — importing results into the database
- Choosing a Discovery Strategy — when to use logon scripts vs. other methods