The first time you launchP4V, the ConnectionSetup Wizard (Mac: Connection Setup Assistant) runs automatically. Youcan use the wizard to specify connection settings and create a user andworkspace if required. In subsequentP4Vsessions, the Open Connection dialog box is displayed by default. Torun the wizard/assistant manually, go to Connection > Set UpConnection.
To connect to Helix Core Server using a new connection:
-
LaunchP4Vor, ifP4Vis already running, go to Connection > Open Connection. The Open Connections dialog box opens.
-
In the Open Connection dialog box, enter theHelix Core Servername and port number for the connection using the following syntax:
server_host:port_numberIf yourHelix Core Server is enabled for SSL (Secure Sockets Layer) encryption, use thefollowing syntax:ssl:server_host:port_number
Important
If you attempt to connect to an SSL-enabledHelix Core Server and you see a warning about an untrusted SSL connection oraltered SSL fingerprint, contact yourHelix Core Serveradministrator before completing the connection.
-
In the User field, enter your user name.
- To browse for a particular user, click the Browse buttonand select the user from that list.
- To create a user, click New and fill in the appropriateinformation.
-
(Optional) In the Workspace field, specify the name of yourclient workspace.
- To browse for a particular client workspace, click theBrowse button and select the workspace from thatlist.
- To create a client workspace, click New and fill in therequired information. For details, see Create a workspace.
- Click OK.
- In the Perforce Password Required dialog box, enter your password.
You can click the "eye" icon to make sure you enter the correct password. -
Click OK.
P4Vconnects to the specifiedHelix Core 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 login2in the Helix Core Command-Line (P4) Reference.Note
[P4VS-2753/P4V-23511/P4EXP-476] 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 Core Server using a connection that you have used previously, do one of thefollowing:
- IfP4Vis already running, go to Connection > Open Recent and selectthe connection.
-
When you launchP4V, select the connection from the Connections drop-down in the Open Connection dialog box. The Connections drop-down lists recent and favorite connections.
If your Connectionpreference is set to Restore all previously openedconnections when you launchP4V,P4Vopens the most recently used connection and skips the OpenConnection dialog box.
Environment variables
You can set Windows or Linux environment variables forPerforceconnection settings, which makes the settings available to otherHelix Core Serverclient applications (for example P4EXP, theHelix Plugin for File Explorer).
- To set connection-related environment variables, go toConnection > Environment Settings and specify thesettings you want.
-
To configureP4Vto use environment connection settings at startup, go to Edit> Preferences. On the Connections page, enableOpen the connection that matches yourPerforceenvironment settings for Windows or Linux.
You can also click the Change Settings button on this pageto set your connection-related environment settings.
Favorite connections
You can maintain a list of favorite connections and assign descriptivenames to the entries. This frees you from having to remember port numbersand Helix Core Server host names.
- To add a favorite connection, go to Connection > FavoriteConnections > Add Favorite Connection.
- To modify existing favorites, go to Connection > FavoriteConnections > Manage Favorites.
- To connect to a favorite connection, go to Connection >Favorite Connections and select the connection you want to open.
Connect to a unicode-mode Helix Core Server
The first time you connect to a unicode-mode Helix Core Server,P4Vrequires you to choose a character set. If you are connecting to aunicode-mode Helix Core Server, it is vital to configure this setting correctly toensure that files are transferred properly between your client machineand Helix Core Server. If you are unsure which setting to choose, consult yourHelix Core Serveradministrator.
If you are connecting to a unicode-modeHelix Core Server for the first time,P4Vdisplays the Choose Character Encoding dialog box after you dismissthe Open Connection dialog box. Specify the encoding you want andclick OK. The encoding that you specify overrides any default that isconfigured, and the specified encoding is used when you subsequentlyconnect to the sameHelix Core Server.
To configure a default encoding for unicode-modeHelix Core Server, go to Edit > Preferences (Windows) orP4V> Preferences (Mac) and open the Display page.
Helix Core Serversupports several variants of the UTF-16 character set because theWindows, Mac, and Linux platforms differ in their handling of UTF-16encoding, specifically, in the ordering of multibyte characters and theinclusion of a byte order marker (BOM) in the file header. The standardUTF-16 setting, utf16, is configured according to thetypical defaults for your processor and is the recommended setting,unless you are certain that your client computer requires differentbyte-order/BOM settings.
For full details about configuring client and Helix Core Server instances to handle unicodeenvironments and files, refer to the Internationalization Notes (https://www.perforce.com/perforce/r22.1/user/i18nnotes.txt)for your version ofHelix Core Server, such as https://www.perforce.com/perforce/r22.1/user/i18nnotes.txt for the 2022.1 release.
