Manage TRE Lifecycle States

Publish, deactivate, reactivate, and delete a Trusted Research Environment, and update its resource inventory after launch.

Apollo and Trusted Research Environments licenses are required to use Trusted Research Environments on the DNAnexus Platform. Contact DNAnexus Sales for more information.

TRE lifecycle operations cover the state changes TRE Admins perform after creating a Trusted Research Environment: transitioning between states, updating the resource inventory, and deleting a TRE. For an overview of the three lifecycle states and what configuration is possible in each, see Managing Trusted Research Environments.

Publish a TRE

Publishing transitions a TRE from Draft to Active state. For the full publish procedure and pre-publish checklist, see Step 7 in creating a TRE.

Deactivate a TRE

Deactivating transitions a TRE from Active to Maintenance state. While in Maintenance state, the TRE remains visible to Authorized Users in Data Resources > Resource Center but is marked as under maintenance, and new data access requests cannot be submitted. Existing approved requests and active projects are not affected.

Deactivate a TRE when you need to update the resource inventory with a new version.

1. In your org details, navigate to the TRE tab.

2. Click the TRE you want to deactivate.

3. Click Administrative Actions (gear icon) at the top right.

4. Select Deactivate Environment.

5. Click Confirm and Deactivate.

Reactivate a TRE

Reactivating transitions a TRE from Maintenance back to Active state. The TRE becomes visible again to Authorized Users, and new data access requests can be submitted.

1. In your org details, navigate to the TRE tab.

2. Click the TRE you want to reactivate.

3. Click Administrative Actions (gear icon) at the top right.

4. Select Reactivate Environment.

5. Review the confirmation message.

6. Click Confirm and Reactivate.

Update Data Access Policies

Data access policies control the security restrictions enforced on all researcher projects in this TRE. You can update them at any time regardless of lifecycle state. Changes take effect immediately on all existing and future projects.

1. In your org details, navigate to the TRE tab.

2. Click the TRE you want to edit.

3. Under Features & Policies, click Configure Policies.

4. For each policy, select an enforcement option. For a description of the three options, see planning data access policies.

5. Click Save.

Update the Resource Inventory

The resource inventory is locked while a TRE is Active. To update it — for example, to publish a new version of your data resources — you must first deactivate the TRE.

1. Deactivate the TRE to enter Maintenance state.

2. Navigate to Resource Inventory.

3. Update the Version string to reflect the new release, for example 2.0.0.

4. Update the project ID and object ID fields for any changed resources.

5. Reactivate the TRE to make the updated inventory available.

Contact DNAnexus Professional Services for assistance preparing updated File Inventory and Data Collections files.

Delete a TRE

You can delete a TRE only when it is in Draft or Maintenance state, and only if no data access requests exist for it.

Deleting a TRE is permanent. It cannot be recovered.

If data access requests exist, the delete action is disabled.

1. In your org details, navigate to the TRE tab.

2. Click the TRE you want to delete.

3. Click Administrative Actions (gear icon) at the top right.

4. Select Delete Environment.

5. Click Confirm and Delete.