Skip to main content

KBA1062 Jet Stream Admin FAQ


Q: When I add a VDB to a Jet Stream Container, what happens?

A: When a VDB is first added to a Container, it will be refreshed to the latest point in time on the parent object. This allows Jet Stream to begin tracking the VDB from a known point and keep accounting for future changes. As of 5.1.6, it is possible to add an existing VDB to a container without the refresh.

Q: Why is the initial Refresh when adding a VDB to a container so long?

A: The initial Refresh is always from the latest Point-in-Time on the respective sources. If it's been a while since a snapshot has taken, it can take a significant amount of time to apply the necessary archive logs for Oracle sources. You can reduce the time this takes by taking a new Snapshot of the source prior to creating Containers.

Q: How do I figure out why a Jet Stream operation failed?

A: Jet Stream operations will result in jobs and actions just like operations performed in the Admin App. Just like any other VDB operation, you should be able to see the underlying failure in the Actions pane or the Dashboard. 


Q: I have a lot of objects in each Container, how do I figure which one caused the Jet Stream job to fail.

A: You’ll need to either focus on the failed jobs in the Action pane, or look at all of the jobs in the Dashboard that occur after the start time of the parent Jet Stream job and before the end time. If you have a lot of activity on the Delphix Engine, you may need to figure out which VDBs are associated with the Container to be able to decipher which jobs are associated. Remember, a failure on any of the objects in the Container will cause the operation on the Container to fail.


Q: My user reports that their Container shows Attempt Recovery what should I do?

A: This is an indication that a persistent failure has occurred during an operation. For example: a Refresh they performed failed and Jet Stream couldn’t revert back to the previous state either. Generally, this is indicative of an environmental problem since the automated recovery didn’t work. Possible sources of the issue could be listener issues, authentication failure, target environment problems, etc and to resolve look into those areas and errors found in the Admin App. In particular, looking through the Dashboard for Failed jobs can help quickly isolate the issue.


Q: Since we started using Jet Stream, I see snapshots that are being held beyond the retention period. What is causing that?

A: There are a couple of reasons that this could happen.

1. Since Jet Stream allows users to create Bookmarks and those Bookmarks are held until deleted, they could be keep open references to those snapshots. Even if the Bookmarks have been deleted, if a user has branched or restored from that point, they may still be holding a reference to the underlying data. 

2. The other common way for this to occur is via Branches. Jet Stream will perform retention on data associated with Branches but will not remove the Branch through retention. If the user has a Branch that hasn’t been refreshed in a while, it may be holding references to older data causing Snapshots to be held.

Having users be cognizant of the resources they're using, and encouraging them to remove unneeded bookmarks as well as removing or regularly refreshing branches, can help avoid many problems.

Q: The Trash button is not available on a Template, why? 

A: In order to delete the Template, you’ll need to ensure that all of the Containers derived from the Template have been deleted.


Q: The Trash button is not available on the Container, why?

A: In versions of Delphix prior to 4.3.3, Containers that needed recovery could not be deleted from the UI. In order to delete the container, you’ll need to log into the CLI and perform the deletion there. Below are the steps:


ssh -l delphix_admin@DOMAIN delphix

delphix> jetstream

delphix jetstream> container

delphix jetstream container>

delphix jetstream container> select CONTAINER-1

delphix jetstream container 'CONTAINER-1'> delete

delphix jetstream container 'CONTAINER-1' delete *> ls

delphix jetstream container CONTAINER-1 delete *> set deleteDataSources=false/true

delphix jetstream container 'CONTAINER-1' delete *> commit

   Dispatched job JOB-7327


   JETSTREAM_USER_CONTAINER_DELETE job for "CONTAINER-1" completed successfully.

delphix jetstream container>
  • Was this article helpful?