SDP_Guide.Unix.pdf #36

It appears you don't have a pdf plugin for this browser.

# Change User Description Committed
#105 30531 C. Thomas Tyler Merge down from main to dev with:
p4 merge -b perforce_software-sdp-dev
#104 30440 Robert Cowham Add a couple of emphases...
#103 30385 C. Thomas Tyler Regnerated docs for release.
#102 30294 C. Thomas Tyler Updated docs for release.
#101 30168 Mark Zinthefer updating the Unix docs
#100 30040 C. Thomas Tyler Regenerated docs.
#99 30000 C. Thomas Tyler Refined Release Notes and top-level README.md file in preparation
for coming 2023.2 release.

Adjusted Makefile in doc directory to also generate top-level
README.html from top-level README.md file so that the HTML file is
reliably updated in the SDP release process.

Updated :revnumber: and :revdate: docs in AsciiDoc files to
indicate that the are still current.

Avoiding regen of ReleaseNotes.pdf binary file since that will
need at least one more update before shipping SDP 2023.2.
#98 29953 C. Thomas Tyler Regeneratd docs.
#97 29912 Robert Cowham Remove link to Helix Installer until we refactor that to avoid support errors.
#96 29890 C. Thomas Tyler Regenerated docs.
#95 29727 Robert Cowham Note the need for an extra p4 trust statement for $HOSTNAME
#94 29719 Robert Cowham Fix journal numbering example.
Add section to make replication errors visible.
#93 29700 C. Thomas Tyler Updated Version to release SDP 2023.1.29699.
Re-generated docs.
#92 29622 C. Thomas Tyler Updated Version to release SDP 2023.1.29621.
Re-generated docs.
#91 29611 C. Thomas Tyler Updated Version to release SDP 2023.1.29610.
Re-generated docs.
#90 29483 Robert Cowham Clarify case-insensitive servers
#89 29475 Robert Cowham For SELinux note the yum package to install for basics
#88 29442 C. Thomas Tyler Updated Version to release SDP 2022.2.29441.
Re-generated docs.
#87 29400 C. Thomas Tyler Updated Version to release SDP 2022.2.29399.
Re-generated docs.
#86 29251 C. Thomas Tyler Updated Version to release SDP 2022.2.29250.
Re-generated docs.
#85 29204 C. Thomas Tyler Updated Version to release SDP 2022.1.29203.
Re-generated docs.
#84 29142 C. Thomas Tyler Updated Version to release SDP 2022.1.29141.
Re-generated docs.
#83 29096 Robert Cowham Add a section on installing Swarm triggers
#82 29055 Robert Cowham Update troubleshooting to check ckp_running.txt semaphore
#81 29044 Robert Cowham Update to include troubleshooting 'p4 pull -ls' errors
#80 28988 C. Thomas Tyler Updated Version to release SDP 2022.1.28987.
Re-generated docs.
#79 28980 Robert Cowham Note how to configure Swarm to use postfix
#78 28926 Robert Cowham Added check for Swarm JIRA project access.
#77 28840 C. Thomas Tyler Updated Version to release SDP 2022.1.28839.
Re-generated docs.
#76 28686 Robert Cowham Clarify FAQ for replication errors
#75 28667 Robert Cowham Add a note re monitoring.
Add some FAQ appendix questions.
#74 28650 C. Thomas Tyler Updated Version to release SDP 2021.2.28649.
Re-generated docs.
#73 28604 Robert Cowham Added notes for Python/P4Python and CheckCaseTrigger installation
#72 28503 Robert Cowham Add SELinux tip
#71 28496 Robert Cowham Fix typo in journalctl
#70 28493 Robert Cowham Added notes to get systemd SDP scripts working under SELinux
Thanks to Rich Alloway!
#69 28411 C. Thomas Tyler Updated Version to release SDP 2021.2.28410.
Re-generated docs.
#68 28351 Robert Cowham Tweaked sdp upgrades docs.
#67 28261 C. Thomas Tyler Fixed on-character doc typo (curk -> curl).
#66 28257 C. Thomas Tyler Updated Version to release SDP 2021.1.28253.
Re-generated docs.
#65 28239 C. Thomas Tyler Updated Version to release SDP 2021.1.28238.
Re-generated docs.
#64 28071 Robert Cowham Clarify some notes re setting up Gmail
#63 27978 Robert Cowham Clarifications and warnings around load_checkpoint.sh
Mention recreate_offline_db.sh a little more prominently
Recommend installing postfix for mail.
#62 27920 C. Thomas Tyler Updated Version to release SDP 2020.1.27919.
Re-generated docs.
#61 27900 C. Thomas Tyler Updated Version to release SDP 2020.1.27899.
Re-generated docs.
#60 27821 C. Thomas Tyler Updated Version to release SDP 2020.1.27820.
Re-generated docs.
#59 27764 C. Thomas Tyler Updated Version to release SDP 2020.1.27763.
Re-generated docs.
#58 27760 C. Thomas Tyler Updated Version to release SDP 2020.1.27759.
Re-generated docs.
#57 27725 C. Thomas Tyler Re-generated HTML and PDF from adoc files.
#56 27710 Robert Cowham Another tweak to tmpfs settings
#55 27709 Robert Cowham Note check for serverlocks.
Fix typo in path in failover.
#54 27539 C. Thomas Tyler Updated Version to release SDP 2020.1.27536.
Re-generated docs.
#53 27536 C. Thomas Tyler Legacy Upgrade Guide doc updates:
* Added 'Put New SDP in Place' section.
* Added 'Set SDP Counters' section to set SDP_VERSION and SDP_DATE counters.
* Covered updating depot spec Map fields.
* Covered adding server.id files.
* Added missing content on putting new SDP directory in place.

SDP_Guide.Unix doc updates:
* Added Legacy Upgrade Scripts section w/clear_depot_Map_fields.sh.

Updated Makefile with new doc build dependencies.

Regenerated docs.
#52 27526 C. Thomas Tyler Updated Version to release SDP 2020.1.27524.
Re-generated docs.
#51 27505 C. Thomas Tyler Enhanced doc for Systemd/SysV services management and configuration
docs, separating basic configuration for start/stop/status from
enabling for start on boot (with Systemd/SysV variations for each).

Added doc coverage for using systemd to enable multiple broker configs.

Added doc coverage for applying limited sudo.

Spell check.
#50 27462 C. Thomas Tyler Updated Version to release SDP 2020.1.27457.
Re-generated docs.
#49 27414 C. Thomas Tyler Updated SDP Guide.
#48 27406 C. Thomas Tyler Updated Version to release SDP 2020.1.27403.
#47 27398 C. Thomas Tyler Refined Makefile for generating docs and regenerated docs.
#46 27351 C. Thomas Tyler Updated AsciiDoc-generated files.
#45 27322 C. Thomas Tyler Updated AsciiDoc-generated files.
#44 27253 C. Thomas Tyler Updated generated docs.
#43 27213 C. Thomas Tyler Regenerated docs.
#42 27156 C. Thomas Tyler Consolidated SDP Standards into the SDP Guide for UNIX/Linux.

Added references to those sections in the Windows SDP Guide.

Normalized doc titles.

Various other doc update.
#41 27096 C. Thomas Tyler Refactored SDP Legacy Upgrade content into a separate doc.
The SDP
Guide will be remain comprehensive and cover how to upgrade the SDP
itself forwardm from the current version (2020.1) using the new,
p4d-like incremental upgrade mechanism.

The content for manual upgrade procedures needed to get older
SDP installations to 2020.1 is only useful until sites are on
2020.1. This content is extensive, narrowly focused, and of value
only once per installation, and thus the legacy upgrade content
is separated into its own document.

Regenerated work-in-progress HTML files for easier review.
#40 27074 C. Thomas Tyler Regenerated SDP Guide docs from adoc.
#39 27058 Robert Cowham Added direct links to the various scripts where they are explained.
Tweak some wording in SDP upgrade section
#38 27055 C. Thomas Tyler Pulled the SDP Upgrade Guide for Linux into the main SDP Guide,
and deleted the separate upgrade doc. Also other minor refinements.

Pulled in updated mkrep.sh v2.5.0 docs.

This version is still in progress.  Search for EDITME to find
areas requiring addtional content.
#37 27041 Robert Cowham Windows Guide directly includes chunks of the Unix guide for replication etc, with a little
ifdef to avoid Unix only comments.
Fix Makefile and add missing generated man page.
#36 27033 C. Thomas Tyler Work in progress updates to SDP_Guilde.Unix.
#35 27021 C. Thomas Tyler Re-ordered so `systemd` info comes first (as it is more likely
to be relevant), and older SysV docs deferred.

Various other tweaks.
#34 27014 C. Thomas Tyler Regenerated AsciiDoc output.
#33 26992 Robert Cowham Document SiteTags.cfg file
#32 26851 Robert Cowham Fix typo in tmpfs /etc/fstab entry which stopped it working in the doc.
Mention in pre-requisites for failover and failover guide the need to review
OS Config for your failover server.
Document Ubuntu 2020.04 LTS and CentOS/RHEL 8 support. Note performance
has been observed to be better with CentOS.
Document pull.sh and submit.sh in main SDP guide (remove from Unsupported doc).
Update comments in triggers to reflect that they are reference implementations, not just examples. No code change.
#31 26780 Robert Cowham Complete rename of P4DNSNAME -> P4MASTERHOST
#30 26755 Robert Cowham Include p4verify.sh man page in SDP Guide automatically for usage section.
#29 26748 Robert Cowham Add recommended performance tweaks:
- THP off
- server.locks directory into RAM
#28 26747 Robert Cowham Update with some checklists for failover to ensure valid.
Update to v2020.1
Add Usage sections where missing to Unix guide
Refactor the content in Unix guide to avoid repetition and make things read more sensibly.
#27 26727 Robert Cowham Add section on server host naming conventions
Clarify HA and DR, and update links across docs
Fix doc structure for Appendix numbering
#26 26661 Robert Cowham Tidying up cross references.
Added missing sync_replica.sh docs.
#25 26654 Robert Cowham First draft of new Failover Guide using "p4 failover"
Linked from SDP Unix Guide
#24 26649 Robert Cowham More SDP Doc tidy up.
Removed some command summary files.
#23 26644 Robert Cowham SDP Doc Update to address jobs.
Mainly documents scripts which lacked any mention.
#22 26637 Robert Cowham Include script help within doc
Requires a couple of tags in the scripts themselves.
#21 26631 Robert Cowham New AsciiDoc version of Windows SDP guide
#20 26629 Robert Cowham Fixed Makefile to generate HTML
Check in theme
Some notes in README
Remove the .docx!
#19 26628 Robert Cowham Basically have things working for AsciiDoc
#18 26627 Robert Cowham First version of AsciiDoc with associated PDF
#17 25188 Robert Cowham Remove sdp_install doc - info covered by SDP_Guide
#16 25187 Robert Cowham Reworked style in SDP Unix Guide for better Appendix auto numbering etc.
Moved some stuff to Appendix to get to the meat of the doc faster.
Removed Best Practice doc as contained in the other.
#15 25134 Robert Cowham Update the guide:
- Explain SSL
- Clarify how to check environment
- many clarifications as per fixed jobs
- example commands
- remove non-existent scripts
#14 25124 Robert Cowham Updated to refer to mkdirs.1.cfg
Removed aspects of section 5 on maintenance scripts
Clarified some working
#13 24407 C. Thomas Tyler Recovering recreate_db_checkpoint.sh and undoing other changes done in
change @24393 as a quick patch/fix for SDP-341.

Also uncommenting the test for this script as the script is being
re-added.

Bypassing pre-commit review for this, as I need to commit this before
making the next set of more review-worthy changes, including renaming
this script per discussion in review:
https://swarm.workshop.perforce.com/reviews/24394/#comments
#12 24393 C. Thomas Tyler Removed recreate_db_checkpoint.sh, and references to it in
crontab and documentation.  It may be restored in a future
release.

See job SDP-341 for details and alternatives to deleting this script.

#review-24394 @robert_cowham @josh
#11 22975 Robert Cowham Update to refer to mkdirs.cfg
#10 21601 Robert Cowham Update the diagram with Tom's comments.
#9 21267 Robert Cowham Fix failing tests.
Changed default filesystem names to:
DB1=hxmetadata1
DB2=hxmetadata2
DD=hxdepots
LG=hxlogs

hx=Helix. Updated docs to reflect this
#8 20198 Russell C. Jackson (Rusty) Updated doc with adminpass changes.
#7 19113 Russell C. Jackson (Rusty) Changed name of daily_backup.sh to daily_checkpoint.sh
Changed name of weekly_backup.sh to recreate_db_checkpoint.sh

Updated crontabs with new names, and changed to run recreate_db_checkpoint
on the 1st Sat. of Jan. and July. For most companies, this is a better
practice than recreating weekly per discussion with Anton.

Remove solaris crontab since Solaris is pretty much dead, and we don't test on it.

Updated docs to reflect name changes, and did a little clean other other sections
while I was in there.
#6 18538 Robert Cowham Include mention of recreate_offline_db
#5 16784 C. Thomas Tyler Routine Merge Down to dev from main using:
p4 -s merge -n -b perforce_software-sdp-dev
#4 15375 adrian_waters Routine merge-down from main->dev
#3 12028 C. Thomas Tyler Refreshed SDP dev branch, merging down from main.
#2 11463 Russell C. Jackson (Rusty) Updated dev to prepare for Summit agreed changes.
#1 10961 C. Thomas Tyler Merge down from main.
//guest/perforce_software/sdp/dev/doc/SDP_Guide.pdf
#2 10666 C. Thomas Tyler Merge down from main.
 No actual merging was needed (just
'resolve -as').
#1 10638 C. Thomas Tyler Populate perforce_software-sdp-dev.
//guest/perforce_software/sdp/main/doc/SDP_Guide.pdf
#1 10148 C. Thomas Tyler Promoted the Perforce Server Deployment Package to The Workshop.