# Starting an Engagement

<mark style="background-color:yellow;">Step 1:</mark> From the **Runbooks** module home page (the **Engagements** tab), click **Start New Engagement**.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FUinkJqj4zDAXrJ00ZQY4%2Fimage.png?alt=media&#x26;token=d0e74c6c-9ffe-4360-85aa-37ffc7b1a6b1" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 2:</mark> Select the client from the **Client** pulldown menu.

<figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FWd5CK5U5Et1jpeSXe6Uw%2Fimage.png?alt=media&#x26;token=20982f70-60da-4d5a-9e0b-994f4a74492b" alt=""><figcaption></figcaption></figure>

<mark style="background-color:yellow;">Step 3:</mark> Select if the engagement is new or to be modified from an existing test plan.&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2Fjx1zcLfsAY1gYyYMbXAB%2Fimage.png?alt=media&#x26;token=d052fff4-79ac-46fc-96a2-f0867dbef8f5" alt=""><figcaption></figcaption></figure></div>

Existing test plans are greyed out unless "Start from an existing Test Plan" is selected. These plans can be leveraged as a starting point by clicking **Select** next to the test plan.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FeHH8RXlKgpfqPprPayqy%2Fimage.png?alt=media&#x26;token=be8cb265-6a12-4215-8feb-4dc50b10c839" alt=""><figcaption></figcaption></figure></div>

To reduce the list of test plans provided, filter by tactic or test plan title in the search box.

<mark style="background-color:yellow;">Step 4:</mark> Click **Next**.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2Fm20QUeASnByYc4DVEI4B%2Fimage.png?alt=media&#x26;token=8713be07-9246-4243-b76b-998d638bc5e6" alt=""><figcaption></figcaption></figure></div>

<mark style="background-color:yellow;">Step 5:</mark> On the **Engagement Details** tab, enter a title (required), a description, and any required tags. If an existing test plan was selected in the previous step, information in that test plan is populated by default and can be edited.&#x20;

Click **Continue**.&#x20;

<figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2F5bYnGLFAL6eqOxehdHTr%2Fimage.png?alt=media&#x26;token=d624115c-a5d1-40bf-a54d-35f35533f726" alt=""><figcaption></figcaption></figure>

<mark style="background-color:yellow;">Step 6:</mark> On the **Select Procedures** tab, select the procedures for this engagement by clicking the **Select** button next to the procedure to add. If leveraging an existing test plan, all procedures from that template are displayed in the right-hand column.&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FMMJU0k9INw0eTD8g039z%2Fimage.png?alt=media&#x26;token=112a556a-bee5-4716-9b09-71412ea48456" alt=""><figcaption></figcaption></figure></div>

This list can be reduced by clicking the x button of the procedure to remove at the right of the box.&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FSd0vHyNJdfz2A5sYfcQc%2Fimage.png?alt=media&#x26;token=d63db91a-23fa-4263-807a-fab0a78c6c57" alt=""><figcaption></figcaption></figure></div>

The procedure sequence can be adjusted by clicking and dragging the procedure to its desired line.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FkdgC5VmKmhk85lljXfoY%2Fimage.png?alt=media&#x26;token=553c36af-27d0-4fae-be26-0b267ce4ddc0" alt=""><figcaption></figcaption></figure></div>

The list of procedures displayed on the screen can be adjusted using the provided filter options.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FdznZcqy946oyhmm8sW3K%2Fimage.png?alt=media&#x26;token=16be57a9-8112-46ed-a8b0-f32479935629" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
If required procedures have not yet been created, the engagement can be completed and procedures added later, but it is recommended to create the procedures first in [**RunbooksDB**](https://docs.plextrac.com/plextrac-documentation/product-documentation/content-library/runbooksdb).&#x20;
{% endhint %}

<mark style="background-color:yellow;">Step 7:</mark> Click **Add X Procedures** when finished.&#x20;

<mark style="background-color:yellow;">Step 8:</mark> View a summary of the engagement from the **Finalize Engagement** tab. The title, description, tags, engagement coverage, and assigned procedures are displayed.

Click **Create Engagement**.&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FDFUcVak9I5jcCf6gKqVl%2Fimage.png?alt=media&#x26;token=ae0c0a50-5b8e-4efb-abfe-9d46b8f9d7f5" alt=""><figcaption></figcaption></figure></div>

The engagement is now active and ready to be executed.&#x20;

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2Fx0KwvIIHZEm9Pw9L7wvl%2Fimage.png?alt=media&#x26;token=08c53406-4eee-40b5-83b5-580e096837e3" alt=""><figcaption></figcaption></figure></div>

It also is now listed on the **Engagements** tab.

<figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2F4jTafZev8Et4ZQptFwKS%2Fimage.png?alt=media&#x26;token=ad2b8dd4-2779-4810-9428-5ce6eaa6b436" alt=""><figcaption></figcaption></figure>
