Connecting to Helix server

The first time you launch P4V, the Connection Setup Wizard (Mac: Connection Setup Assistant) runs automatically. You can use the wizard to specify connection settings and create a user and workspace if required. In subsequent P4V sessions, the Open Connection dialog is displayed by default. To run the wizard/assistant manually, go to Connection > Set Up Connection​.

To connect to Helix server using a new connection:

  1. Launch P4V or, if P4V is already running, go to Connection > Open Connection​. The Open Connections dialog opens.

    Open Connection dialog
  2. In the Open Connection dialog, enter the Helix server name and port number for the connection using the following syntax: server_host:port_number

    If your Helix server is enabled for SSL (Secure Sockets Layer) encryption, use the following syntax: ssl:server_host:port_number

    Important

    If you attempt to connect to an SSL-enabled Helix server and you see a warning about an untrusted SSL connection or altered SSL fingerprint, contact your Helix server administrator before completing the connection.

  3. In the User field, enter your user name.

    • To browse for a particular user, click the Browse​ button and select the user from that list.
    • To create a user, click New​ and fill in the appropriate information.
  4. (Optional) In the Workspace field, specify the name of your client workspace.

    • To browse for a particular client workspace, click the Browse​ button and select the workspace from that list.
    • To create a client workspace, click New​ and fill in the required information. For details, see Create a workspace.
  5. Click OK.

    P4V connects to the specified Helix server and displays a new instance of its main window.

    Note

    If the server you are connecting to is configured with multi-factor authentication (MFA), you are prompted for another layer of verification. Depending on the setup, you may need to select a method of verification before you can enter your credentials.

    For more information, see p4 login2 in the Helix Core P4 Command Reference.

    Note

    If the server you are connecting to is configured for authentication with Helix Authentication Service, the Identity Provider (IdP) web page opens, prompting you for the credentials registered with your Identity Provider (IdP). For details, see Helix Authentication Service Administrator Guide or contact your Helix Core server administrator.

To connect to Helix server using a connection that you have used previously, do one of the following:

  • If P4V is already running, go to Connection > Open Recent and select the connection.
  • When you launch P4V, select the connection from the Connections drop-down in the Open Connection dialog. The Connections drop-down lists recent and favorite connections.

    Note

    If your Connection preference is set to Restore all previously opened connections when you launch P4V, P4V opens the most recently used connection and skips the Open Connection dialog.

Note

You can set Windows or Linux environment variables for Perforce connection settings, which makes the settings available to other Helix server client applications (for example P4EXP, the Helix Plugin for File Explorer).

  • To set connection-related environment variables, go to Connection > Environment Settings and specify the settings you want.
  • To configure P4V to use environment connection settings at startup, go to Edit > Preferences​. On the Connections page, enable Open the connection that matches your Perforce environment settings for Windows or Linux.

    You can also click the Change Settings button on this page to set your connection-related environment settings.

Favorite connections

You can maintain a list of favorite connections and assign descriptive names to the entries. This frees you from having to remember port numbers and Helix server host names.

  • To add a favorite connection, go to Connection > Favorite Connections > Add Favorite Connection.
  • To modify existing favorites, go to Connection > Favorite Connections > Manage Favorites.
  • To connect to a favorite connection, go to Connection > Favorite Connections and select the connection you want to open.

Connecting to a unicode-mode Helix server

The first time you connect to a unicode-mode Helix server, P4V requires you to choose a character set. If you are connecting to a unicode-mode Helix server, it is vital to configure this setting correctly to ensure that files are transferred properly between your client machine and Helix server. If you are unsure which setting to choose, consult your Helix server administrator.

If you are connecting to a unicode-mode Helix server for the first time, P4V displays the Choose Character Encoding dialog after you dismiss the Open Connection dialog. Specify the encoding you want and click OK. The encoding that you specify overrides any default that is configured, and the specified encoding is used when you subsequently connect to the same Helix server.

To configure a default encoding for unicode-mode Helix server, go to Edit > Preferences (Windows) or P4V > Preferences (Mac) and open the Display page.

Helix server supports several variants of the UTF-16 character set because the Windows, Mac, and Linux platforms differ in their handling of UTF-16 encoding, specifically, in the ordering of multibyte characters and the inclusion of a byte order marker (BOM) in the file header. The standard UTF-16 setting, utf16, is configured according to the typical defaults for your processor and is the recommended setting, unless you are certain that your client computer requires different byte-order/BOM settings.

For full details about configuring client and Helix server instances to handle unicode environments and files, refer to the Internationalization Notes (https://www.perforce.com/perforce/doc.current/user/i18nnotes.txt) for your version of Helix server, such as https://www.perforce.com/perforce/r20.1/user/i18nnotes.txt.