mkdirs.sh.man.txt #23

  • //
  • guest/
  • perforce_software/
  • sdp/
  • dev/
  • doc/
  • gen/
  • mkdirs.sh.man.txt
  • View
  • Commits
  • Open Download .zip Download (486 B)

Usage Error:

No instance specified.


USAGE for mkdirs.sh v6.5.0:

mkdirs.sh <instance> [-s <ServerID>] [-t <ServerType>] [-tp <TargetPort>] [-lp <ListenPort>] [-I <svc>[,<svc2>]] [-MDD /bigdisk] [-MCD /ckps] [-MLG /jnl] [-MDB1 /db1] [-MDB2 /db2] [-f] [-p] [-no_init|-no_systemd|-no_enable] [-fs|-ls] [-test [-clean]] [-n] [-L <log>] [-d|-D]

OR

mkdirs.sh <instance> [-c <CfgFile>] [-f] [-p] [-no_init|-no_systemd] [-test [-clean]] [-n] [-L <log>] [-d|-D]

or

mkdirs.sh [-h|-man]

# Change User Description Committed
#30 31957 C. Thomas Tyler Updated generated script man pages.
#29 31557 C. Thomas Tyler Updated generated script man pages.
#28 31366 C. Thomas Tyler Updated generated script man pages.
#27 31187 Will Kreitzmann Updated generated script man pages.
#26 31064 C. Thomas Tyler Updated generated script man pages.
#25 30912 C. Thomas Tyler Updated generated script man pages.
#24 30782 C. Thomas Tyler Added new install_sdp.sh script and supporting documentation.

The new install_sdp.sh makes SDP independent of the separate
Helix Installer software (the reset_sdp.sh script).  The new
script greatly improves the installation experience for new
server machines. It is ground up rewrite of the reset_sdp.sh
script. The new script preserves the desired behaviors of the
original Helix Installer script, but is focused on the use
case of a fresh install on a new server machine. With this focus,
the scripts does not have any "reset" logic, making it completely
safe.

Added various files and functionalityfrom Helix Installer into SDP.
* Added firewalld templates to SDP, and added ufw support.
* Improved sudoers generation.
* Added bash shell templates.

This script also installs in the coming SDP Package structure.
New installs use a modified SDP structure that makes it so the
/p4/sdp and /p4/common now point to folders on the local OS
volume rather than the /hxepots volume. The /hxdepots volume,
which is often NFS mounted, is still used for depots and
checkpoints, and for backups.

The new structure uses a new /opt/perforce/helix-sdp structure
under which /p4/sdp and /p4/common point. This structure also
contains the expaneded SDP tarball, downloads, helix_binaries,
etc.

This change represents the first of 3-phase rollout of the new
package structure. In this first phase, the "silent beta" phase,
the new structure is used for new installations only. This phase
requires no changes to released SDP scripts except for mkdirs.sh,
and even that script remains backward-compatible with the old
structure if used independently of install_sdp.sh.  If used with
install_sdp.sh, the new structure is used.

In the second phase (targeted for SPD 2024.2 release), the
sdp_upgrade.sh script will convert existing installations to
the new structure.

In the third phase (targeted for SDP 2025.x), this script will
be incorporated into OS pacakge installations for the helix-sdp
package.

Perforce internal wikis have more detail on this change.

#review-30783
#23 30681 C. Thomas Tyler Added gen_sudoers.sh script to generate a sudoers file for perforce OSUSER.

This generates a more secure limited sudoers file.

Previously, adding a sudoers entry for the OSUSER (usually 'perforce') was done only by the Helix Installer. In the Helix Installer variant, a single "one-size-filts-all" sudoers file was used, with the following characteristics:
* The instances for Helix Core services were referenced with a '*' wildcard to match all SDP instances, which has since been determined to introduce a vulnerability. In this new script, the wildcard is replaced with separate entries for each SDP instance.
* There were entries for all known paths of utilities like lslocks, setcap, and getcap. This new script generates the correct path valid for the current machine.

With this change, the functionality will be available in the SDP directly. This new gen_sudoers.sh script can be called by mkdirs.sh directly to update the sudoers file each time a new SDP instance is added, if the new '-fs' (full sudo) or '-ls' (limited sudoers) entries are used. There is no change to the default behavior of mkdirs.sh; only a change if new options are utilized.

This script comes with docs and examples for the new script as well as doc changes for mkdirs.sh. (Also added missing documentation for the '-no_enable' option).

Further changes needed:
* Add doc reference in SDP_Guide.Unix.adoc
#22 30384 C. Thomas Tyler Updated generated script man pages.
#21 30039 C. Thomas Tyler Updated generated script man pages.
#20 30030 C. Thomas Tyler Updated generated script man pages.
#19 29699 C. Thomas Tyler Updated generated script man pages.
#18 29621 C. Thomas Tyler Updated generated script man pages.
#17 29399 C. Thomas Tyler Updated generated script man pages.
#16 29203 C. Thomas Tyler Updated generated script man pages.
#15 28410 C. Thomas Tyler Updated generated script man pages.
#14 28216 C. Thomas Tyler Updated generated script man pages.
#13 28092 C. Thomas Tyler Updated generated script man pages.
#12 27899 C. Thomas Tyler Updated generated script man pages.
#11 27820 C. Thomas Tyler Updated generated script man pages.
#10 27759 C. Thomas Tyler Updated generated script man pages.
#9 27724 C. Thomas Tyler Updated generated script man pages.
#8 27396 C. Thomas Tyler Updated generated script man pages.
#7 27317 C. Thomas Tyler Updated generated script man pages.
#6 27252 C. Thomas Tyler Updated generated script man pages.
#5 27155 C. Thomas Tyler Updated generated script man pages.
#4 27073 C. Thomas Tyler Updated generated script man pages.
#3 27032 C. Thomas Tyler Updated generated script man pages.
#2 27009 C. Thomas Tyler chmod +w
#1 27006 C. Thomas Tyler Updated generated docs.