Post-installation configuration
After the p4-server package has been installed, additional
configuration is required to create a P4 Server.
When you run the script, you will need to enter the following server credentials:
-
Service name
-
P4ROOT
-
P4PORT
-
Username
-
Password
Complete the following steps to run the post-installation configuration:
-
Use the
configure-p4d.shscript to configure a Perforce service after the package has been installed. Run the script in interactive mode:sudo /opt/perforce/sbin/configure-p4d.sh
The script displays the default settings and then prompts you to confirm or update each option.
-
When the script starts, it displays a summary of the current and default settings, then prompts you for the information needed to configure your P4 Server.
At each prompt, press Enter to accept the default value, or type a new value to override it.
If you already have a P4 Server configured, enter the name of an existing service and the script prompts you only for settings that can be changed.
The sections below describe each prompt in detail.
-
P4 Service name:
The service name identifies the P4 Server when you start or stop it using
P4 Server Control (p4dctl).It is also used to set the server’s
serverid, which uniquely identifies this P4 Server if you have more than one.For example, enter
p4primaryas a service name. -
P4 Server root (P4ROOT):
This is the directory where versioned files and metadata will be stored. By default, a directory named after your P4 Service name is suggested. Press Enter to create the suggested directory. For more information, see P4ROOT.
-
P4 Server unicode-mode:
This is off by default.
If you turn Unicode mode on, you will not be able to turn it off. Be sure you are familiar with Unicode functionality when selecting this mode. See Unicode mode for information. -
P4 Server case-sensitive:
This is on by default. To learn more, see Case sensitivity and multi-platform development.
-
The Server Address (P4PORT):
The server address (P4PORT) tells P4 Server which host and port to listen on, and how clients connect to it (whether to communicate in plaintext or over SSL/TLS).
You must enter a value for this setting.
For a local installation, enter:
localhost:1666This configures the server to listen on port
1666on the local machine. If you leave this value blank, the configuration will not complete successfully. -
P4 super-user login:
Enter a
useridfor a new user to be created withsuperlevel privileges. This user has full administrative access to the server. For more information, see Access levels. -
P4 super-user password:
Enter a password for the new superuser. Due to the unlimited privileges granted to this user, a strong password is required and must be entered twice
-
-
When you respond to all prompts, the script configures the server, displays progress messages, and shows a summary of the completed configuration.
P4 Server is now set up. To check your P4 Server configuration, run the following:
p4dctl list
This will output a list of the P4 Servers that are running, which should include the P4 Server you have just installed and configured.
What's next
After you have P4 Server installed and running, configure the server further by connecting to P4V. To learn more, see Download and install P4V and other client applications.