ScanCore Agent - scan-server-resources

From AN!Wiki
Jump to: navigation, search

 AN!Wiki :: ScanCore Agent - scan-server-resources

Template note icon.png
Note: This agent requires the 'scan-server-resources' tool to be installed and running on the target server.

This agent runs a small tool on the target machine which listens for TCP connections on port 26845. When it receives the command GET, it reports back in XML the current hostname, UUID, operating system string, CPU count and load per core, RAM and swap total and used and each mounted drive, its size and used space.

Contents

Server Output

The ScanCore agent calls listed servers. Any that are running the server will report a small amount of XML reporting the resources used and available on the target server.

Template note icon.png
Note: All sizes are in 'bytes'. The CPU load is a percentage between '0' and '100' measure over one second from when the GET command is received.

Example:

telnet 10.255.0.10 26845
Trying 10.255.0.10...
Connected to 10.255.0.10.
Escape character is '^]'.
GET
<?xml version="1.0" encoding="UTF-8"?>
<server os="Windows-7-6.1.7601-SP1" host_name="letoy" uuid="ee7ff22b-2a81-4fa8-9710-1f375ab0a33a" boot_time="1466263455.0">
	<disks>
		<drive name="C:\" filesystem="NTFS" options="rw,fixed" size="479623647232" used="394543112192" />
	</disks>
	<memory>
		<ram total="34327662592" used="4072189952">
		<swap total="68653420544" used="4066205696">
	</memory>
	<cpu>
		<cores count=4>
		<cpu number="0" load="4.7"/>
		<cpu number="1" load="9.4"/>
		<cpu number="2" load="20.2"/>
		<cpu number="3" load="9.5"/>
	</cpu>
</server>
Template note icon.png
Note: The CPU loads are based on one second of load starting from the GET command being received.

This information is then stored in ScanCore.

Install scan-server-resources Tool

This is a basic tool that is set to run on boot. It has no installer and no dependencies. Installation is simply a matter of extracting to compressed directory and files and then telling the operating system to start it on OS boot. Removal is simply the reverse.

On Windows

Template note icon.png
Note: This tool is not yet publicly available, but it will be soon. - (2017/03/05 - Digimer)

Download the 'AN-SSRW-Setup.exe' Windows tool.

  • Current 'md5sum' is: 662f64ab9073f32a5235b52adbfee8a6 AN-SSRW-Setup.exe (2017/03/05)

Run the installer:

Start of scan_server_resources windows install.

Double-click on the 'AN-SSRW-Setup.exe' file to start the scan_server_resources windows install. You will be prompted to allow the installer to run. We haven't setup to be able to sign our packages, so please confirm the md5sum of the file you downloaded and make sure it matches before running the install.

Select install components.

The server is really simple. It exists entirely in one directory and is started on boot via a "Startup" shortcut link. If you don't choose the add the startup link, be aware that ScanCore will not be able to monitor the server's resources until the server is manually started.

Select install directory.

The default directory places the server off of the 'c:\' drive so that special permissions aren't needed to write to files under 'c:\Program Files'.

Installation is complete!

The install should complete quite quickly.

Manually Starting the Server for the First Time

After the install, the server will not yet be running. You can start it manually by finding the link in the Startup menu and clicking it.

Manually starting the server.

Windows Firewall

Template note icon.png
Note: If you are not prompted to open a firewall port, please manually open TCP port 26845 in window's firewall. Windows Server 2016 appears to require manual configuration.

The first time you run it, you may be asked to give the server permission to traverse the windows firewall.

Opening access through the windows firewall.
Template note icon.png
Note: There is no program window. It runs as a daemon in the background.

To confirm that it is running, check in Task Manager and look for the AN-SSRW.exe process in "Task Manager".

Verifying that the server is listening via Task Manager.

Testing

The final test is to use a telnet client to call the server and query its status:

telnet 10.255.1.110 26845
Trying 10.255.1.110...
Connected to 10.255.1.110.
Escape character is '^]'.
GET
<?xml version="1.0" encoding="UTF-8"?>
<server os="Windows-7-6.1.7601-SP1" host_name="test-PC" uuid="64805e83-b7ca-481c-8134-ece472ee3367" boot_time="1466361428.0">
	<disks>
		<drive name="C:\" filesystem="NTFS" options="rw,fixed" size="42842714112" used="23907651584" />
		<drive name="D:\" filesystem="UDF" options="ro,cdrom" size="3320903680" used="3320903680" />
		<drive name="E:\" filesystem="CDFS" options="ro,cdrom" size="56967168" used="56967168" />
	</disks>
	<memory>
		<ram total="4294557696" used="1575657472">
		<swap total="8587210752" used="1352384512">
	</memory>
	<cpu>
		<cores count=2>
		<cpu number="0" load="0.0"/>
		<cpu number="1" load="0.0"/>
	</cpu>
</server>

Windows scan-server-resources Removal

To remove scan-server-resources, use the built-in "Add/Remove Programs" tool and uninstall "AN Scan Server Resources".

Remove scan-server-resources via "Add/Remove Programs".

On Linux

 


 

Any questions, feedback, advice, complaints or meanderings are welcome.
Us: Alteeve's Niche! Support: Mailing List IRC: #clusterlabs on Freenode   © Alteeve's Niche! Inc. 1997-2018
legal stuff: All info is provided "As-Is". Do not use anything here unless you are willing and able to take responsibility for your own actions.
Personal tools
Namespaces

Variants
Actions
Navigation
projects
Toolbox