Job Submitter - Configuration Guide

Job Submitter & Receiver Configuration Guide

This guide explains how to configure and deploy the Job Submitter and Receiver components. The submitter sends batch jobs to clients, and the receiver executes them.

Submitter Overview

The Submitter is a C# application that:

Loads a list of client IPs from submitter.config
Sends commands or script files over TCP
Optionally updates job records in a MySQL database
Receives process IDs from clients and monitors execution

Submitter Configuration File (submitter.config)

PORT:1234
EXECUTION_PATH:C:\temp\batchjobs
LOG_FILE:C:\temp\server_log.txt

HOST_LIST:
{
    # IP Address    | Host name
    192.168.1.101   | AlphaClient
    192.168.1.102   | BetaClient
    192.168.1.103   | GammaClient
}

Field	Description
PORT	The TCP port to send jobs to clients
EXECUTION_PATH	Folder on clients where scripts will be saved and executed
LOG_FILE	Local path where submitter writes job logs
HOST_LIST	List of IP addresses (and optional hostnames) allowed to receive jobs

How to Run the Submitter

Ensure the config file is placed in Config/
Open terminal and run one of the following:
Send a script file:

dotnet run --project JobSubmitter.csproj -- -host 192.168.1.101 -i "C:\scripts\sample.bat"

Send raw command:

dotnet run --project JobSubmitter.csproj -- -host 192.168.1.101 -run "echo Hello from Submitter"

Fetch system info of a client:

dotnet run --project JobSubmitter.csproj -- -host 192.168.1.101 -info

Test all hosts in config:

dotnet run --project JobSubmitter.csproj -- -test

Security & Connectivity Notes

Ensure firewall allows outbound traffic on the specified PORT
All IPs in HOST_LISTmust be reachable from the submitter

Receiver Overview

The Receiver is a lightweight TCP listener that runs on each client. It accepts scripts, saves and runs them, and returns a Process ID back to the submitter.

Receiver Configuration File (receiver.config)

PORT:1982
EXECUTION_PATH:C:\temp\batchjobs
LOG_FILE:C:\temp\server_log.txt

Field	Description
PORT	Port where this receiver listens for job requests
EXECUTION_PATH	Directory to save and run incoming scripts
LOG_FILE	Path to write local logs of job activity

How to Run the Receiver

Place receiver.configin the Config/directory.
Compile or run the receiver project:

dotnet run --project JobReceiver.csproj

Ensure the machine IP is present in the submitter.configHOST_LIST

Security & Connectivity Notes

Open the specified PORTin the firewall
Ensure submitter can reach this IP and port via TCP
The path in EXECUTION_PATHmust exist or will be created at runtime

Summary

The Job Submitter and Receiver allow batch job orchestration across Windows and Linux hosts. Proper configuration of IP addresses, port access, and file paths ensures secure and efficient job execution.