ScriptAgent Server

This program is used to deploy and run the CPL24Inventory.exe on a specific ip range.

Prerequistes

• Download and install the Microsoft .NET Desktop Runtime v6.0.0 or higher.
• Please ensure that .NET strong crypto is allowed in case your webservice is using TLS 1.2 or higher. See How to enable TLS 1.2 on clients.

Detailed Setup steps

To setup, please follow the following steps

1. Download and unzip the files.
2. Open a PowerShell/PowerShell Core in Administrator mode and cd into the Folder
3. Execute the command to copy the downloaded files to the default target (C:\Program Files\CPL24 GmbH\ScriptAgentCore)

./Setup -Copy

4. Execute the command (from the target directory)

./Setup -Install

When asked, provide credentials for the service user. Please keep in mind, that this user must have at least local administrator rights!

5. Execute the command

./Setup -Configure

This copies the default examples and overrides existing files.

6. Open the ScriptAgentJob.config and edit at least the following blocks

• IPRange e.g. 192.168.1.1 192.168.1.2 192.168.2.0/24
• Scanparams e.g. --TargetUrl https://cpl24.yourdomain.com:port/path/VeryLongIdProvidedAfterSetup

By default the job runs imediately after start and repeats it all 24 hours.

7. Place CPL24Inventory.exe into the program folder
8. Start the service by rebooting, services menu or by commandline

Start-Service -Name CPL24ScriptAgentCore

Quick Setup

Combine the commands to speedup the setup process

./Setup -Load -Copy -Install -Configure

Now follow the steps 6 to 8 from the Detailed Setup steps section

Hints

• If you have different environments with different credentials, please install the service on another machine with those different credentials. Alternatively you can install the service in multiple folders and provide the -SERVICE_NAME switch when installing.
• If you use the -Load option, the latest CPL24Inventory.exe-file is downloaded. Mind that an alreay existing file would be replaced.
• We suggest to use group policy to enable strong crypto in .NET. You can export a once defined GPO and then just import and link in further environments to speed up deployment.

Uninstall / Remove

• Stop the service
• Run

./Setup -Uninstall

• Delete the folder