mkrep.sh.man.txt #1

  • //
  • guest/
  • perforce_software/
  • sdp/
  • dev/
  • doc/
  • gen/
  • mkrep.sh.man.txt
  • View
  • Commits
  • Open Download .zip Download (5 KB)
/pub/2nd-sdp/dev/Server/Unix/p4/common/bin/mkrep.sh: line 53: sha256sum: command not found
USAGE for mkrep.sh v2.4.8:

mkrep.sh -i <SDP_Instance> -t <Type> -s <Site_Tag> -r <Replica_Host> [-f <From_ServerID>] [-p] [-ssh_opts="opts"] [-skip_ssh] [-L <log>] [-si] [-v<n>] [-n] [-D]

or

mkrep.sh [-h|-man|-V]


DESCRIPTION:
	This script creates makes a replica, and provides enough information to
	make it ready in all respects.

OPTIONS:
 -i <SDP_Instance>
	Specify the SDP Instance.

 -t <Type>
	Specify the replica type tag. The type corresponds to the 'Type:' and
	'Services:' field of the server spec, which describes the type of services
	offered by a given replica.

	Valid values are:
	* ha:   High Availability mandatory standby replica, for 'p4 failover' (P4D 2018.2+)
	* ham:  High Availability metadata-only mandatory standby replica, for 'p4 failover' (P4D 2018.2+)
	* ro:   Read-Only standby replica.
	* rom:  Read-Only standby replica, Metadata only.
	* fr:   Forwarding Replica (Unfiltered).
	* fs:   Forwarding Standby (Unfiltered).
	* frm:  Forwarding Replica (Unfiltered, Metadata only).
	* fsm:  Forwarding Standby (Unfiltered, Metadata only).
	* ffr:  Filtered Forwarding Replica.  Not a valid failover target.
	* edge: Edge Server. Filtered by definition.

	Replicas with 'standby' are always unfiltered, and use the 'journalcopy'
	method of replication, which copies a byte-for-byte verbatim journal file
	rather than one that is merely logically equivalent.

	The tag has several purposes:
	1. Short Hand. Each tag represents a combination of 'Type:' and fully
	qualified 'Services:' values used in server specs.

	2. Distillation. Only the most useful Type/Services combinations have a
	shorthand form.

	3. For forwarding replicas, the name includes the critical distinction of
	whether any replication filtering is used; as filtering of any kind disqualifies
	a replica from being a potential failover target. (No such distinction is
	needed for edge servers, which are filtered by definition).

 -s <Site_Tag>
	Specify a geographic site tag indicating the location and/or data center where
	the replica will physically be located. Valid site tags are defined in the site
	tags file:

	/p4/common/config/SiteTags.cfg

	Current valid site tags defined in this file are:
	tgrep: /p4/common/config/SiteTags.cfg: No such file or directory

 -r <Replica_Host>
	Specify the target replica host.

 -f <From_ServerID>
	Specify ServerID of the P4TARGET server from which we are replicating.
	This is used to populate the 'ReplicatingFrom' field of the server
	spec. The value must be a valid ServerID.

	By default, this is determined dynamically checking the ServerID of the
	master server. This option should be used if the target is something
	other than the master. For example, to create an HA replica of an edge
	server, you might specify something like '-f p4d_edge_syd'.

 -p	This script performs a check to ensure that the Protections table grants
	super access to the group .

	By default, an error is displayed if the check fails, i.e. if super user
	access for the group  cannot be verified. This is
	because, by default, we want to avoid making changes to the Protections
	table. Some sites have local policies or custom automation that requires
	site-specific procedures to update the Protections table.

	If '-p' is specified, an attempt is made to append the Protections table
	an entry like:

	super group  * //...

 -ssh_opts="opts"
	Specify '-ssh_opts' to pass paraemters on to the ssh command. For
	example, to specify ssh operation on non-standard port 2222, specify
	'-ssh_opts="-p 2222"'.

 -skip_ssh
	Specify '-skip_ssh' to skip the SSH access preflight check.

	This is useful if you only intend to do the metadata preparation phase
	of creating a new replica, prior to SSH being setup or perhaps even
	prior to the hardware being available.

 -v<n>	Set verbosity 1-5 (-v1 = quiet, -v5 = highest).

 -L <log>
	Specify the path to a log file, or the special value 'off' to disable
	logging. By default, all output (stdout and stderr) goes in the logs
	directory referenced by $LOGS.

	NOTE: This script is self-logging. That is, output displayed on the screen
	is simultaneously captured in the log file. Do not run this script with
	redirection operators like '> log' or '2>&1', and do not use 'tee.'

-si	Operate silently. All output (stdout and stderr) is redirected to the log
	only; no output appears on the terminal. This cannot be used with
	'-L off'.

 -n	No-Op. Prints commands instead of running them.

 -D	Set extreme debugging verbosity.

 -f	Full Mode Setup: The completes an edge servers setup so no additional steps 
	are required. This setup requires an ssh connection from the master to the 
	edge to be in place first. It also requires the depot log journal and /p4
	mounts to be in place and setup as expected. This setup assumes a standard
	SDP setup.

HELP OPTIONS:
 -h	Display short help message
 -man	Display man-style help message
 -V	Dispay version info for this script and its libraries.

DEPENDENCIES:
	This script depends on ssh keys being defined to allow the Perforce
	operating system user () to ssh to any necessary machines
	without a password.

	This script assumes the replica host already has the SDP fully
	configured.

FILES:
	This Site Tags file defines the list of valid geographic site tags:
	/p4/common/config/SiteTags.cfg

EXAMPLES:
	Prepare an edge server to run on host syc-helix-04:
	mkrep.sh -i acme -t edge -s syd -r syc-helix-04

# Change User Description Committed
#21 31557 C. Thomas Tyler Updated generated script man pages.
#20 30912 C. Thomas Tyler Updated generated script man pages.
#19 30384 C. Thomas Tyler Updated generated script man pages.
#18 30291 C. Thomas Tyler Updated generated script man pages.
#17 30030 C. Thomas Tyler Updated generated script man pages.
#16 29610 C. Thomas Tyler Updated generated script man pages.
#15 29399 C. Thomas Tyler Updated generated script man pages.
#14 28639 C. Thomas Tyler Updated generated script man pages.
#13 28216 C. Thomas Tyler Updated generated script man pages.
#12 28092 C. Thomas Tyler Updated generated script man pages.
#11 27899 C. Thomas Tyler Updated generated script man pages.
#10 27724 C. Thomas Tyler Updated generated script man pages.
#9 27317 C. Thomas Tyler Updated generated script man pages.
#8 27252 C. Thomas Tyler Updated generated script man pages.
#7 27155 C. Thomas Tyler Updated generated script man pages.
#6 27073 C. Thomas Tyler Updated generated script man pages.
#5 27054 C. Thomas Tyler Updated generated script man pages.
#4 27052 C. Thomas Tyler Updated generated script man pages.
#3 27011 C. Thomas Tyler Updated generated script man pages.
#2 27009 C. Thomas Tyler chmod +w
#1 27006 C. Thomas Tyler Updated generated docs.