Post-installation configuration
After the helix-p4d
package has been installed, additional
configuration is required to create a Helix Core Server.
Perform the following steps:
-
Use the
configure-helix-p4d.sh
script to configure a Perforce service.The
configure-helix-p4d.sh
script can be used in a few different ways. The steps below outline the most straightforward configuration using interactive mode, but you can review the options by running:$ sudo /opt/perforce/sbin/configure-helix-p4d.sh -h
Run in interactive mode:
$ sudo /opt/perforce/sbin/configure-helix-p4d.sh
In interactive mode, the configuration script begins by displaying a summary of default settings and those that have optionally been set with a command-line argument.
-
Provide information to the configuration script.
After the summary, the configuration script prompts for information it needs to set up your Helix Core Server.
If you already have a Helix Core Server configured, and you supply its
service name
, then the configuration script only prompts for settings that you can change on an existing service.At each prompt, you can accept the proposed default value by pressing Enter, or you can specify your own value.
The list below contains details about the options for each prompt:
-
The Service Name:
The name used when when starting and stopping the service with
Helix Core Server Control (p4dctl)
.This name is also used to set the Perforce
serverid
attribute on thisp4d
server, to distinguish it from otherp4d
servers that might be in your overall installation. -
The Server Root (
P4ROOT
):The directory where versioned files and metadata should be stored.
-
The Unicode Mode for the server:
This is off by default.
WarningIf 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.
-
The Case Sensitivity for the server:
This is on by default.
See Case sensitivity and multi-platform development for information.
-
The Server Address (
P4PORT
):This specifies the host and port where the Helix Core Server should listen, and whether to communicate in plaintext or over SSL. For more information, see Communicating port information.
-
Superuser login:
The desired userid for a new user to be created with
super
level privileges.For more information about superusers, see Access levels.
-
Superuser password:
The desired password to be set for the new superuser.
Due to the unlimited privileges granted to this user, a strong password is required.
After you answer all prompts, the script begins configuration according to your choices. As it runs, the script displays information about the configuration taking place.
After the configuration has completed successfully, a summary is displayed with details about what was done, and where settings are stored.
You can now connect to the service, or you can manage the service using the
p4dctl
utility. For more information, see Helix Core Server Control (p4dctl). -