Getting started

Part 1 of the ELTMaestro User Guide. Signing in, a tour of the main window, and the menu bar.

Signing in

Launch the ELTMaestro client to open the ELTMaestro Server Login window.

The login window

Field	What it is
Server	Hostname or IP of the ELTMaestro meta-service (e.g. <server_ip>).
Port	Meta-service SOAP port — default 8181 (HTTPS). See the architecture diagram.
User Name	Your ELTMaestro account.
Password	Account password.
Sign in	Authenticates. Enter works too (it's the default button).

All four fields pre-fill from your last successful sign-in (saved in your Windows user settings); on a fresh install they're blank.

First sign-in (setup)

1. Point Server / Port at your meta-service (e.g. <server_ip> / 8181).
2. Sign in with the seeded admin account: integrator / integrator123. Change it right after via Admin ▸ Users.
3. On success the login window closes, the main Workflow(s) window opens, and your server / port / user are remembered for next time.

Administrators: your first real task after signing in is setting up connections — the databases, SSH hosts, and cloud/S3 endpoints your workflows will read from and write to. That's the Administration & Setup guide (the initialization step). The connections you create there are exactly what you'll pick from later in the Job editor.

What sign-in does

Sign in calls MaestroServerRPC.initialize(server, port, user, password), which opens the SOAP/HTTPS channel to the meta-service and authenticates. The session token it returns is attached to every later request. The transport is HTTPS (a self-signed server certificate is accepted).

If sign-in fails

Message	Meaning	What to check
Login Error	Server reached, credentials rejected	User name / password; that the account exists and is enabled
Cannot Reach Server	Host/port wrong, or service down	Server / Port values; that the meta-service is running (OPERATIONS.md)
Login Timeout	Service or network slow/blocked	Connectivity and firewall to the port
Connection Error	TLS / transport problem	That HTTPS is answering on the port; cert / proxy issues

Signing in again as the same user elsewhere (another client, or a raw SOAP call) invalidates the earlier session — the first client then gets Invalid Session on its next action.

Main window overview

After signing in you land on the main window. It has a menu bar across the top and a row of tabs; the default tab, Workflow(s), is your home base.

The Workflow(s) tab

Lists the workflows (jobs) on the server, with a toolbar of icon buttons:

Button	What it does
New	Create a new, empty workflow and open it in the Job editor.
Delete	Delete the selected workflow from the server.
Config (gear icon)	Open the Job Metadata editor for the selected workflow — description, tags, support notes (descriptive only; doesn't affect the run).
Edit Workflow	Load the selected workflow into the Job editor to design it.
Unlock Job	Release the edit lock on the selected workflow(s).
Search	Filter the workflow list (your last search is remembered).

A workflow is locked while open in an editor so two people can't edit it at once. If a session ends abnormally the lock can linger — Unlock Job clears it.

Other tabs

Tab	What's there
License Expiration Warning	Shown in red only when the license is near expiry.

Menu bar at a glance

Menu	Contains
File	Create Work Flow · Theme (Light / Blue / Dark / Dark Blue / Use System Theme) · Exit
Administration	Configure Maestro Server → the Admin Interface · Metrics Configuration (Control Test, Data Quality Management) · Workflow Configuration (Job Watermarks, Email Alerts) · Scheduler · Migration (Export / Import Workflow(s))
Runtime & Logs	Logging (Workflow Logs, Server Logs) · Reports (Metrics Report, Data Lineage Utility) · Runtime Operations
Help	About · License Information

Each menu is detailed in Menus in depth.

---

Next: Administration & Setup — create your connections (the first-time initialization).