BusinessInsight Agent Launcher Onboarding
=========================================

Company: Al-badar Spining Mills
Client ID / Tenant ID: al_badar_spinin
Agent ID: agent-al_badar_spinin
Selected local database type: Oracle
Control plane URL: http://localhost:5215/

What the launcher file contains
-------------------------------
The Start-al_badar_spinin-Agent.cmd file is your company-specific Agent launcher. It contains:
- Client ID / Tenant ID, so BusinessInsight knows which company this Agent belongs to.
- Agent ID, so the portal can identify this local Agent process.
- Control plane URL, so the Agent can contact the BusinessInsight portal.
- Local database provider selected during signup: Oracle.
- One editable local database connection string.

Where this information is used
------------------------------
When you start the launcher, the Agent reads these values from the launcher file. It uses the Client ID and Agent ID to register with BusinessInsight, then uses the connection string only on your machine to read your selected local database. Keep one launcher and one Agent folder for one company database.

Next steps
----------
1. Extract BusinessInsight-Agent-Package.zip into a folder such as C:\BusinessInsight.Agent.
2. Put Start-al_badar_spinin-Agent.cmd in that same folder, next to BusinessInsight.Agent.dll.
3. Open Start-al_badar_spinin-Agent.cmd in a text editor.
4. Find the line that starts with Agent__TenantConnections__al_badar_spinin__ConnectionString.
5. Replace the sample placeholders with the local database values described below.
6. Save the launcher and run it from the Agent folder.

Connection string to build for your selected database
----------------------------------------------------
Provider value in launcher: Oracle
Starting template:
User Id=YOUR_USERNAME;Password=YOUR_PASSWORD;Data Source=YOUR_SERVER:1521/YOUR_SERVICE_NAME

Replace YOUR_USERNAME and YOUR_PASSWORD with a read-only Oracle user. Replace YOUR_SERVER with the Oracle host name or IP address, 1521 with the listener port if different, and YOUR_SERVICE_NAME with the Oracle service name. Your database administrator can provide the host, port, service name, and user. These values are also commonly visible in SQL Developer connection properties or a tnsnames.ora entry.
Security guidance
-----------------
Use a read-only database login whenever the database type requires a username and password. The Agent only needs permission to read reporting tables, views, and stored procedure results used by dashboards. Do not use an administrator login.

Keep this file with the launcher until onboarding is complete.
