> For the complete documentation index, see [llms.txt](https://prosbcdocs.telcobridges.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prosbcdocs.telcobridges.com/telecom-references/other-pages/add-custom-application-to-toolpack-oam.md).

# Add Custom Application to Toolpack OAM

## Add an OAM-friendly application to Toolpack OAM

Toolpack OAM can automatically launch/monitor/relaunch applications (this includes Toolpack's own applications, and custom applications).

To be managed by Toolpack OAM, an application needs to:

* Create instances of classes [CTBCAFServiceAlmMgmt](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/operations/ctbcafservicealmmgmt/README.md) (and optionally [CTBCAFServiceCmMgmtClient](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/api/ctbcafservicecmmgmtclient/README.md))
* Be added to the list of managed applications in the Web Portal

The list of applications that are launched and managed by Toolpack OAM is found in the Toolpack Web Portal, under the following section:

* Applications

### Steps to add new applications

1. Create a new Application Configuration

* Go to Applications menu
* Click "Create New Application"
* Fill in the appropriate information
  * Name of this application
  * Application type (should be "User-specific")
  * "Supports Toolpack ALM" should be checked only if the application implements [CTBCAFServiceAlmMgmt](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/operations/ctbcafservicealmmgmt/README.md)
  * Path of the binary file to launch (some variables can be used here for convenience)
  * Working directory
  * Command-line arguments
* Click "Create"

2. Select on which hosts the application will run

* Go to Applications menu
* Click on the application to edit
* On the bottom of the page, use the controls (<<) to move to the left box any host that the application must be run on
* Go to "System" menu, and "Apply" the configuration

## Add a non-OAM-friendly application

Toolpack can also manage the launch of any 3rd-party applications that do not support ALM (does not implement class [CTBCAFServiceAlmMgmt](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/operations/ctbcafservicealmmgmt/README.md)).

To do this, it is necessary that the option "**Supports Toolpack ALM**" is **unchecked** in the application configuration page in the web portal.


---

# 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, and the optional `goal` query parameter:

```
GET https://prosbcdocs.telcobridges.com/telecom-references/other-pages/add-custom-application-to-toolpack-oam.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.