Jet Stream Data Templates: An Overview
A Jet Stream data template represents a collection of data sources that you can provision to a Jet Stream user. A data source can be a dSource, a VDB, or vFiles. These sources can be used in multiple data templates. Once you have created a data template, the set of data sources associated with it is fixed; you cannot add data sources to an existing template, nor can you remove data sources from it. In addition to data sources, you can define the set of metadata that is relevant for a given template – for example, notes, descriptions, names for sources that are relevant to an end user, and other configuration details. Once you have created the template, it provides a stencil for provisioning data containers. This, in turn, enables Jet Stream users to have self-service access to a space-efficient copy of the data sources defined in the data template.
Jet Stream Data Template Activities
Data templates are managed by a Delphix admin. The admin can provision data containers from the data template and assign a data container to an end user. The admin can also create bookmarks on the data template timeline in order to mark meaningful points in time.
When creating a data template, it is important to consider the set of users who will own data containers provisioned from it. In Jet Stream, templates effectively define the boundaries of the data that users can share directly with each other. Only owners of data containers created from the same data template are able to share data using bookmarks.
Creating a Data Template and Adding Data Sources
A data template consists of an arbitrary set of dSources, virtual databases (VDBs), and vFiles. These are created and managed in the Delphix Admin
interface, and can be used in Jet Stream as data sources. You can use any data type supported by the Delphix Engine as a data source in Jet Stream. For more information, refer to the Linking/Provisioning documentation for the standard Delphix Engine. The following is an example of the many kinds of data sources you can use to create a data template.
Data Sources, version 1.0.0
When adding data sources to the data template, it is important to consider whether there are any dependencies between them. For example, do data operations need to begin with a VDB (database) source before the same operation occurs on vFiles (application binary)? Or can data operations be performed in parallel on each of the data sources? The Jet Stream data source dependencies are by default synced together in parallel during any data operation, including starting the data container and its sources. When working with specific ordering constraints, such as with Oracle EBS, you can set up and configure the ordering sequence for each data source.
To create a data template:
- From the drop-down menu in the upper right-hand corner of the Delphix UI, select Jet Stream.
Jet Stream Drop Down, version 1.0.0
- On the Mgmt Overview page, click Add Template.
Jet Stream Add Data Template, version 1.0.0
This will send you to the Create Data Template page.
- Enter a Name for the data template.
- Optionally, enter a description for the data template.
- Click Add Data Source to add data sources to the template.
Jet Stream Data Template Creation, version 1.0.0
Default vs. Setting the Ordering of Data Sources to a Data Template
You have the option of setting the ordering of data sources to a data template. This option minimizes the time needed to complete Jet Stream operations by running them in parallel on each data source. You cannot change this setting after the data template has been created. If you want default behavior, do NOT select the box highlighted in the image above.
When your template has ordering constraints, as with Oracle EBS, you must set the startup order for each data source. Check the Set startup order of data sources box. The Delphix Engine will select the data source with order 1 as the first source started and the last one to be stopped. The data source with order 2 will be selected as the second source started, and this sequence will continue until the last data source is selected and ordered. Note that it is not possible to have operations performed in parallel on a subset of data sources and sequentially on a different subset of data sources.
Setting the Ordering of Data Sources
- Use the drop-down menu to select the source you want to include. The drop-down menu will display all dSources in the system and all VDBs and vFiles that are not already assigned to a Jet Stream data container.
- Enter a Jet Stream-specific name for the data source.
- Optionally, enter a description in the Notes section. Jet Stream users see a copy of these notes in the data containers they own.
- Click Add Data Source to continue to add and configure more data sources to the data template. You can remove data sources using the Delete icon.
- Click Create to finish creating the data template.
Setting Ordered Data Sources to a Data Template
For Oracle EBS, the vFiles dbTechStack will have order 1, the Oracle database order 2, and the vFiles appsTier order 3. For more information about EBS, see the EBS documentation.
Once you have created a template, you cannot change the set of data sources in it. Any VDBs or dSources being used as data sources in Jet Stream will appear with a special badge in the Admin App.
Selecting Masked Data Sources
Using Jet Stream with Masked Data Sources
When creating a data template with masked data sources, select the parent masked VDBs as sources to use in the data template.
Viewing Data Templates
As the Delphix Admin user, you can view what sources have been included in a data template. You can distinguish the masked sources from the unmasked sources by referring to the corresponding data icons, as seen below.
Example of a template containing both masked and unmasked VDB’s
Managing Data Template Notes
After you have created the data template, it will be visible from the Management Overview
page under the Data Templates
tab, which is the default tab.
Data Template Details in Jet Stream Management Overview
- Each tile corresponds to a data template and contains high-level information about that data template. For example, the number of child data containers is visible under the name of the container.
- You can search, sort, and filter the data template tiles, making it easy to manage a large number of data templates in Jet Stream.
Editing a Data Template's Name
- Click the Edit icon next to the data template name.
Data Template Editing, version 1.0.0
- Enter the new name.
- Click the checkmark icon to confirm changes.
Data Template Editing2, version 1.0.0
Deleting a Data Template
- Select the data template you want to delete.
- Click the Delete icon in the lower right-hand corner of the tile.
Note: If there are any data containers provisioned from the data template, you must remove them before you can delete the data template. See instructions in the Managing Data Containers section of this guide.