> For the complete documentation index, see [llms.txt](https://docs.balkan.id/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.balkan.id/getting-started/setting-up-your-tenant/application-integrations/direct-application-integration/oracle-e-business-suite-integration-setup/service-management-and-troubleshooting.md).

# Service management and troubleshooting

You can use the following commands to configure and maintain the agent:

| Action        | Linux                                             | Windows                                           |
| ------------- | ------------------------------------------------- | ------------------------------------------------- |
| Status        | `systemctl status balkanid-ebs-agent`             | `Get-Service BalkanIDEBSAgent`                    |
| Start / stop  | `systemctl start\|stop balkanid-ebs-agent`        | `Start-Service\|Stop-Service BalkanIDEBSAgent`    |
| Restart       | `systemctl restart balkanid-ebs-agent`            | `Restart-Service BalkanIDEBSAgent`                |
| Logs (follow) | `journalctl -u balkanid-ebs-agent -f`             | `Get-Content ...\logs\<today>.log -Tail 50 -Wait` |
| Run now       | `balkanid-ebs-agent --tui` → "Run extraction now" | same                                              |

### Common Error Codes

| Symptom                                                  | Likely cause                                                | Fix                                                                    |
| -------------------------------------------------------- | ----------------------------------------------------------- | ---------------------------------------------------------------------- |
| `ORA-01017` invalid username/password                    | Wrong DB creds                                              | Re-run `--configure`; verify `db_username`/`db_password`.              |
| `ORA-01045: ... does not have CREATE SESSION`            | Account lacks login                                         | `GRANT CREATE SESSION TO balkanid_ro;`                                 |
| `counting <schema>.FND_USER failed (check SELECT grant)` | Missing / wrong schema grant                                | Grant `SELECT` on the FND views; check `schema:`.                      |
| `lastLoginTime` missing on most users                    | `FND_LOGINS` not granted and `LAST_LOGON_DATE` unmaintained | `GRANT SELECT ON apps.fnd_logins TO balkanid_ro;`                      |
| No `FND_INIT_SQL` insight                                | Profile tables not granted                                  | Grant `SELECT` on `fnd_profile_options` + `fnd_profile_option_values`. |
| `oracle-ebs integration not found for tenant`            | Integration not installed, or wrong `appId`                 | Install the `oracle-ebs` integration; or set `auth.integration_id`.    |
| Upload returns 401/403                                   | Bad tenant key/secret                                       | Re-copy `tenant_key`/`tenant_secret` from the platform.                |
| `invalid schema/owner`                                   | Disallowed `schema:` value                                  | Use a plain identifier (`^[A-Za-z0-9_$#]{1,30}$`).                     |
| Connection hangs / times out                             | Host/port/firewall                                          | Confirm reachability to the DB listener; check `use_tls`.              |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.balkan.id/getting-started/setting-up-your-tenant/application-integrations/direct-application-integration/oracle-e-business-suite-integration-setup/service-management-and-troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.