Setting up streams

To set up streams for the first time, you must create a stream depot and create and populate a mainline stream.

To create a stream depot:

  1. Launch P4Admin (from P4V, choose Tools > Administration) and connect to Helix Server as a user that has admin privilege.

  2. Choose File > New…​ > Depot, specify a name for the stream depot, such as "projectA", and click OK.

    The Depot dialog is displayed.

  3. For Depot Type, choose stream.
  4. Click OK, and verify that your new stream depot is listed in the Depots tab.

To create the mainline stream:

  1. Launch P4V and connect to the Helix Server where you want your streams to reside.

  2. Choose File > New > Stream.

    The Stream: New dialog is displayed.

  3. Specify the Stream Name ("main" is a typical name), depot, and root folder. Omit parent because the mainline is parentless.
  4. For Stream Type, choose "mainline".
  5. Select the stream depot for this stream, such as the "projectA" depot.
  6. Notice that the Location has the format //depotName/streamName, such as //projectA/main
  7. Click OK to save your stream specification.

  8. Verify that your new mainline stream is displayed in the Streams tab. Note that the mainline stream is not displayed in the Depot tab until you populate it with files.

    For more information, see Creating streams.

To populate your mainline stream:

  1. Copy some files or folders to the root folder of the workspace of the stream.
  2. In P4V, switch to the left-pane Workspace tab. Your files are displayed undecorated (that is, as plain file icons), which indicates that they are not under Helix Server control.

  3. Right-click the top-level folder and choose Mark for Add…​.

  4. Click OK.

    In the Pending Changelists tab, verify that your files are listed in the default changelist, decorated with a red plus sign.

  5. Right-click the default changelist and choose Submit…​.

    The Submit Changelist dialog is displayed.

  6. Enter a descriptive comment and click Submit.
Note

As an alternative, you can populate streams by branching files from existing depot locations.

To verify that your files have been submitted, check the Log pane at the bottom of the screen and the left-pane Depot tab. If your submission succeeded, your files are listed in the mainline folder in your stream depot. Now you can branch the files in the mainline to development and release streams, edit files in those streams, and propagate changes among them.