Using P4Sandbox

P4V comes bundled with P4Sandbox, which enables distributed, connection-independent versioning and branching within the context of a shared Perforce versioning service. P4Sandbox provides a local Perforce versioning service to work with or without an active connection to a shared Perforce service; you connect to a shared service only when you want to merge down changes or share your work.

You can use P4V as your P4Sandbox client, and you can create a local P4Sandbox by launching the P4Sandbox Configuration Wizard directly from P4V.

To create a local P4Sandbox:

  1. Launch the P4Sandbox Configuration Wizard using one of the following options:
  2. Complete the wizard pages:
    Page Task Notes
    Welcome to the Sandbox Setup Wizard Create a new or edit an existing P4Sandbox. This page does not appear when you launch the wizard directly from P4V, although you can go back to it.
    Specify Central Server Settings Specify connection to the shared Perforce service or to a local P4Sandbox only. This page does not appear when you launch the wizard directly from P4V, although you can go back to it. The wizard populates your existing P4V connections settings by default, although you can change them.

    The connection setting you specify here determines whether the local P4Sandbox is a connected or standalone implementation. This selection determines the pages that the Configuration Wizard displays next.

    Replication Settings Define pulling interval and select files. When you launch the wizard from P4V, this page comes up first, populated with your current P4V connection settings.

    Choose the files to copy from the shared versioning service to the local P4Sandbox. These files occupy space on your hard disk and require time to transfer across the network. Minimize the number of folders you copy to minimize disk space and increase performance.

    Note that if you do not define a pulling interval, you must manually perform this action. P4Sandbox prompts you to pull changes, as needed, before allowing you to push changes.

    Specify Local Sandbox Server and Workspace Settings Review connection settings for a local P4Sandbox. Specify the Server, Port, User, Workspace Name, Workspace Root, and Charset (character set) for Unicode Servers fields.

    You cannot specify the same port number for use by multiple P4Sandboxes. When you attempt to re-use an existing port number, the following message appears:

    The specified port number is already in use by another P4Sandbox.

    Settings Summary

    Review P4Sandbox settings before finalizing. Shows settings and number of files to be replicated.

    Review and click Finish to complete the configuration.

  3. When the configuration wizard finishes creating the P4Sandbox, P4V does one of the following:

Note. To stop a running P4Sandbox service, you must use the Perforce Command-Line Client.

For more information, see the Perforce Sandbox User's Guide.