Release Notes for SDP - Helix Server Deployment Package Helix Server Components Introduction This document notes changes to the SDP. There are two flavors of the SDP, Unix and Windows. At a high level, the core function of the SDP is similar on Unix and Windows: To maintain an offline copy of the Helix databases, and perform routine offline checkpoints in preparation for backups. At a detailed level, there are differences in both implementation and behavior on the various platforms. Enhancements are needs-driven, and not necessarily applied across Unix and Windows platforms. -------------------------------------------------------------------------- Upgrading the SDP on Unix To incorporate a new version of the SDP into an existing SDP installation, first stage the deployment as in this example, assuming you have put the SDP distribution tar file in /depotdata. Working as user root on a Perforce server: cd /depotdata # If an sdp folder exists here, move it aside, e.g. to # sdp.MOVED_2014-09-11 tar -xzpf sdp.Unix.2014.2.10649.tgz chown -R perforce:perforce sdp.Unix.2014.2.10649.tgz /depotdata/sdp cd /depotdata/sdp/Server/Unix/p4/common/bin # Copy 'p4', 'p4d', 'p4broker', 'p4web', 'p4p', etc. (only # those currently used) into this 'bin' folder. cd /depotdata/sdp/Server/Unix/setup vi mkdirs.sh # Review and adjustments to mkdirs.sh suit your environment. ./mkdirs.sh 1 -test Using 'mkdirs.sh' script with the '-test' flag as illustrated above will deploy to the SDP to /tmp/p4 rather than /p4 area. If working on the Production server directly, DO NOT forget to use the '-test' flag. -------------------------------------------------------------------------- Upgrading the SDP on Windows: Install the SDP onto a different machine - configure sdp_master_config.ini - run create_env.py Manually copy resulting files to the appropriate places in your existing installation. -------------------------------------------------------------------------- Versioning the SDP: We strongly recommend that files in the following locations are versioned in your local Helix server: On Unix: /p4/1/bin /p4/common On Windows: C:\p4\1\bin C:\p4\common C:\p4\config COMING SOON: Helix DVCS and Streams features enable a new method for updating the SDP long-term, greatly simplifying the process of bringing in updates from The Workshop into your environment, and then merging into your local as-deployed SDP (as configured and possibly customized). A simple 'p4 fetch' and 'p4 merge' process. The setup and mechancis will be documented in Q1 2016. -------------------------------------------------------------------------- CHANGE HISTORY: Released: Rev. SDP/MultiArch/2016.2/20972 (2016/11/01) Jobs Fixed since change 20856 up to 20970 (F=Feature, B=Bug): job000616 (F): Add -recent flag to p4verify.sh to verify recent changes. job000626 (B): p4login.*.log files are not being cleaned up by the standard clean-up mechanism (remove_old_logs in backup_function.sh). job000627 (F): Allow for multiple depot volumes. job000628 (B): Fixed missing LOGFILE varialbe issue in p4verify.sh. job000629 (B): Fix formatting of logs to use simple HTML line breaks for Windows SDP. job000630 (B): Various test suite improvements. job000631 (B): fixed issue with broken def'n of P4PORT with multiple SSL prefixes. job000632 (F): Enhanced two-factor auth mechanims. job000633 (F): Tweak to slightly reduce mkdirs.sh configuration. Released: Rev. SDP/MultiArch/2016.2/20856 (2016/10/04) Jobs Fixed since change 20805 up to 20856 (F=Feature, B=Bug): job000618 (F): Enhanced logic to favor init scripts in /p4/N/bin over /etc/init.d. job000619 (B): Fixed quoting bug in p4login. job000620 (F): hms checks for cfg files in /p4/common/config. job000621 (B): Fixed hms bug re: wrong master host discovered in failback testing Released: Rev. SDP/MultiArch/2016.2/20805 (2016/10/02) Jobs Fixed since change 20790 up to 20805 (F=Feature, B=Bug): job000611 (B): Fixed ssh hang issues with hms scripts. job000612 (F): Implemented global/central start stop. job000613 (F): mkrep.sh: Added more replica types and journalcopy support. job000615 (F): Implement checkauth feature in HMS broker_wrapper. Released: Rev. SDP/MultiArch/2016.2/20790 (2016/09/30) Jobs Fixed since change 20755 up to 20790 (F=Feature, B=Bug): job000606 (B): Minor p4 login fix to show P4TICKETS output reliably. job000608 (B): Fix mkrep.sh to use $P4BIN instead of p4. job000609 (F): Added basic p4login-super.sh script. job000610 (B): Added hms dir to mkdirs.sh. Released: Rev. SDP/MultiArch/2016.2/20755 (2016/09/29) Jobs Fixed since change 20559 up to 20755 (F=Feature, B=Bug): job000545 (F): Add option to install_sdp_python.sh to build P4Python with SSL. job000595 (B): Fix attempted login count in p4login. job000597 (B): Fixed order-of-operations issue that caused some log files to be lost on rotation. job000598 (B): Cosmetic fix to broker init script with 'status all' run w/no config files. job000600 (F): Add Helix Management System (HMS) files to SDP. job000601 (F): Enhance p4login to avoid hang issue with auth.id set. job000602 (F): Further test suite docker environment updates. job000603 (F): Add Two Factor Authentication sample auth script. job000604 (B): Correct crontab to run sync_replica.sh every day. job000605 (B): Fix bugs in convert_label_to_autoreload.py. Jobs Fixed since change 20491 up to 20559 (F=Feature, B=Bug): job000590 (B): Fix recent regression with 'restart' option in init scripts. Released: Rev. SDP/MultiArch/2016.1/20491 (2016/09/09) Jobs Fixed since change 20460 up to 20491 (F=Feature, B=Bug): job000589 (B): Fix special case env insulation bug running init scripts as root. Released: Rev. SDP/MultiArch/2016.1/20460 (2016/09/08) Jobs Fixed since change 20395 up to 20460 (F=Feature, B=Bug): job000584 (B): Fixed a typo inserted in mkdirs.sh. job000588 (B): chmod +x fix on some scripts. Released: Rev. SDP/MultiArch/2016.1/20395 (2016/09/04) Jobs Fixed between changelists 20387 and 20395 (F=Feature, B=Bug): job000584 (B): Fixed a typo inserted in mkdirs.sh. Released: Rev. SDP/MultiArch/2016.1/20387 (2016/09/04) Jobs Fixed between changelists 20348 and 20387 (F=Feature, B=Bug): job000579 (B): Fixed several issues in email.sh maint script. job000582 (B): Fixed using with runRemoteCmd getting error if USER not defined in non-core SDP script. job000583 (B): Removed references to legacy names for checkpoint scripts (non-functional change). Jobs Fixed between changelists 20028 and 20348 (F=Feature, B=Bug): job000545 (F): Add option to install_sdp_python.sh to build P4Python with SSL. job000564 (F): Add p4sanity_check.sh script from Battle School. job000565 (B): Fix missing echo of command into log file in p4verify.sh. job000567 (F): Change adminspass to use hidden, and now instance-specific, password files job000568 (F): Add mkrep script to simplify replica creation. job000569 (F): Update p4verify.sh to verify shelves on master/replicas. job000570 (F): Add script to convert labels to autoreload. job000571 (F): Add Evil Twin Detector maintenance script. job000575 (F): Add script to simplify adoption of OS-level best practices recommended by Support. job000577 (B): Eliminate syntax error if user forgets start/stop/status arg; just display status. job000578 (F): Use pid to shutdown p4d rather than 'p4 admin stop' to enhance reliability. Released: Rev. SDP/MultiArch/2016.1/20028 (2016/08/03) Jobs Fixed between changelists 19888 and 20028 (F=Feature, B=Bug): job000548 (F): Defend against environment hijacking of P4ENVIRO. job000557 (F): Revive external auth LDAP group mirror scripts. job000550 (B): sdp_sync.sh v2.1.7: Fixed environment bug (missing defs), HMS support. job000553 (F): Simplify login ticket handling for sophisticated topologies. job000556 (F): Prevent cross-instance contamination if p4_vars is loaded multiple times. Released: Rev. SDP/MultiArch/2016.1/19888 (2016/07/07) Jobs Fixed between changelists 19838 and 19888 (F=Feature, B=Bug): job000274 (B): SDP trigger breaks with Streams workspaces in P4V. job000547 (B): Daily/weekly_backup can fail leaving lock file present requiring manual intervention job000548 (F): Defend against environment hijacking of P4ENVIRO. Released: Rev. SDP/MultiArch/2016.1/19838 (2016/06/26) Jobs Fixed between changelists 19768 and 19838 (F=Feature, B=Bug): job000274 (B): SDP triggers break with Streams workspaces in P4V. job000546 (F): Add defense against known-misbehaving client versions. Released: Rev. SDP/MultiArch/2016.1/19768 (2016/06/24) Jobs Fixed between changelists 19661 and 19768 (F=Feature, B=Bug): job000541 (F): Change to best-practice configurables; auth.autologinprompt=0. job000543 (B): p4master_run operates incorrectly as root. Released: Rev. SDP/MultiArch/2016.1/19661 (2016/06/08) Jobs Fixed between changelists 19410 and 19661 (F=Feature, B=Bug): job000538 (F): Add KEEPJNLS to allow keeping more jnls than ckps. job000539 (F): Rename replica scripts to be consistent with earlier rename of checkpoint scripts. job000540 (F): Enhance error checkong and logging replica handling scripts. job000541 (F): Change to best-practice configurables; auth.autologinprompt=0. Released: SDP/MultiArch/2016.1/19410 (2016/05/17) Jobs Fixed between changelists 18958 and 19410: job000510: Work with license check in P4D 2016.1. job000512: Change p4verify.sh to use -S to verify shelves on a replica instead job000513: Removed the HOST_IP settings from mkdirs and instance_vars since it job000514: Dockerify SDP test suite. job000515: Add replica cleanup script on Windows. job000516: Get p4verify.sh to check SHAREDDATA on replicas. job000517: Avoid chmod on a replica if it shares data with the master. job000518: Use 'p4 admin journal' on master to rotate journal. Released: SDP/MultiArch/2016.1/18958 (2016/04/08) Jobs Fixed between changelists 18619 and 18958: job000484: Proxy status init script can show proxy is up when it is not. job000489: Moved ckp_running.txt to LOGS dir. job000490: Fix missing LOGFILE= in replica_cleanup.sh. job000491: De-emphasized changeType=restricted. job000492: Update Perl/P4Perl Python/P4Python job000493: Support multiple broker configs. job000494: Enhanced p4_vars.template to support non-p4d hosts. job000495: SDP-ify P4DTG init script. job000496: Enhanced p4deleteuser.py to check for shelves, double-deletes. Released: SDP/MultiArch/2016.1/18619 (2016/03/10): Jobs Fixed between changelists 17297 and 18619 job000427 on 2015/12/15 by ttyler *closed* 'Enhanced offline_db 'stale data' Jobs Fixed between changelists 16784 and 17297: job000436: Support $MAILTO values with'#' char in gen_default_broker_cfg.sh. job000446: sdp_sync.sh: Fix 'null crontab' bug. job000447: p4d_base: When stopping p4d, send stderr to /dev/null. job000448: global_replica_status.sh: Support instance-specifc host config. job000449: Support email addresses starting with '#'. Released: SDP/MultiArch/2016.1/16784 (2016/01/12) job000434: Add documentation for sdp_sync.sh to SDP Guide. job000436: Support $MAILTO values with'#' char in gen_default_broker_cfg.sh. -------------------------------------------------------------------------- For more information on jobs, change history details, etc, see: https://swarm.workshop.perforce.com/projects/perforce-software-sdp
# | Change | User | Description | Committed | |
---|---|---|---|---|---|
#83 | 27114 | C. Thomas Tyler |
Changed format of SDP Release Notes from Markdown to adoc. Updated old release notes content to use new format (using disposable link conversion scripts). |
||
#82 | 26594 | C. Thomas Tyler |
Merge Release Notes and Version file from main, with a 'resolve -ay' (ignore changes made in main during a recent patch from main). This is just to keep the "Merge Down" clean in prep for the coming SDP release. |
||
#81 | 26495 | C. Thomas Tyler | Updated Version to release SDP 2019.3.26494. | ||
#80 | 26479 | C. Thomas Tyler | Updated Version to release SDP 2019.3.26478. | ||
#79 | 26474 | C. Thomas Tyler | Updated Version to release SDP 2019.3.26472. | ||
#78 | 26469 | C. Thomas Tyler | Updated Version to release SDP 2019.3.26468. | ||
#77 | 26410 | C. Thomas Tyler | Updated Version to release SDP 2019.3.26407. | ||
#76 | 26402 | C. Thomas Tyler | Updated Version to release SDP 2019.3.26400. | ||
#75 | 26271 | C. Thomas Tyler | Added SDP-448 to release notes for prior release. | ||
#74 | 26245 | C. Thomas Tyler | Updated Version to release SDP 2019.3.26239. | ||
#73 | 26160 | C. Thomas Tyler | Updated Version to release SDP 2019.3.26159. | ||
#72 | 25950 | C. Thomas Tyler | Updated Version to release SDP 2019.2.25949. | ||
#71 | 25939 | C. Thomas Tyler | Updated Version to release SDP 2019.2.25938. | ||
#70 | 25926 | C. Thomas Tyler | Updated Version to release SDP 2019.2.25923. | ||
#69 | 25595 | C. Thomas Tyler | Updated Version to release SDP 2019.2.25594. | ||
#68 | 25482 | C. Thomas Tyler | Updated Version to release SDP 2019.1.25480. | ||
#67 | 25388 | C. Thomas Tyler | Updated Version to release SDP 2019.1.25386. | ||
#66 | 25379 | C. Thomas Tyler | Updated Version to release SDP 2019.1.25374. | ||
#65 | 25321 | C. Thomas Tyler | Updated Version to release SDP 2019.1.25320. | ||
#64 | 25310 | C. Thomas Tyler | Updated Version to release SDP 2019.1.25309. | ||
#63 | 25278 | C. Thomas Tyler | Updated Version to release SDP 2019.1.25276. | ||
#62 | 25243 | C. Thomas Tyler | Updated Version to release SDP 2019.1.25238. | ||
#61 | 25050 | C. Thomas Tyler | Updated Version to release SDP 2018.1.25045. | ||
#60 | 24392 | C. Thomas Tyler | Updated Version and ReleaseNotes.txt for patch release. | ||
#59 | 23594 | C. Thomas Tyler | Updated Version to release SDP 2018.1.23583. | ||
#58 | 23509 | C. Thomas Tyler | Added two more jobs. | ||
#57 | 23507 | C. Thomas Tyler | Updated Version to release SDP 2018.1.23504. | ||
#56 | 23356 | C. Thomas Tyler | Updated Version to release SDP 2017.4.23354. | ||
#55 | 23330 | C. Thomas Tyler | Updated Version to release SDP 2017.4.23329. | ||
#54 | 23043 | C. Thomas Tyler | Updated Version to release SDP 2017.3.23041. | ||
#53 | 23005 | C. Thomas Tyler | Updated Version to release SDP 2017.3.23003. | ||
#52 | 22336 | C. Thomas Tyler |
Merge/ignore to dev of release notes and Version from main to avoid fowling the auto-gen rlease notes on the next regular release. |
||
#51 | 22206 | C. Thomas Tyler | Updated Version to release SDP 2017.2.22201. | ||
#50 | 22184 | C. Thomas Tyler | Updated Version to release SDP 2017.2.22177. | ||
#49 | 21947 | C. Thomas Tyler | Accounted for job renaming in Release Notes. | ||
#48 | 21809 | C. Thomas Tyler | Updated Version to release SDP 2017.1.21808. | ||
#47 | 21722 | C. Thomas Tyler | Updated Version to release SDP 2017.1.21720. | ||
#46 | 21531 | C. Thomas Tyler | Updated Version to release SDP 2016.2.21528. | ||
#45 | 21493 | C. Thomas Tyler | Updated Version to release SDP 2016.2.21489. | ||
#44 | 21482 | C. Thomas Tyler | Updated Version to release SDP 2016.2.21480. | ||
#43 | 21380 | C. Thomas Tyler | Updated Version to release SDP 2016.2.21379. | ||
#42 | 21379 | C. Thomas Tyler | Updated Version to release SDP 2016.2.21369. | ||
#41 | 21337 | C. Thomas Tyler | Updated Version to release SDP 2016.2.21328. | ||
#40 | 21243 | C. Thomas Tyler | Updated Version to release SDP 2016.2.21239. | ||
#39 | 21239 | C. Thomas Tyler |
Manually adjusted release notes to include all jobs, and to adjust a formatting sensitivity of the rel_notes.sh script. |
||
#38 | 21195 | Russell C. Jackson (Rusty) | Update notes on dev. | ||
#37 | 21127 | C. Thomas Tyler | Updated Version to release SDP 2016.2.21123. | ||
#36 | 21104 | C. Thomas Tyler | Updated Version to release SDP 2016.2.21103. | ||
#35 | 21102 | C. Thomas Tyler | Updated Version to release SDP 2016.2.21101. | ||
#34 | 21034 | C. Thomas Tyler | Updated Version to release SDP 2016.2.21033. | ||
#33 | 20996 | C. Thomas Tyler | Updated Version to release SDP 2016.2.20995. | ||
#32 | 20973 | C. Thomas Tyler | Corrected change number to reflect merge down with no net content change. | ||
#31 | 20971 | C. Thomas Tyler | Updated Version to release SDP 2016.2.20970. | ||
#30 | 20857 | C. Thomas Tyler | Updated Version to release SDP 2016.2.20856. | ||
#29 | 20856 | C. Thomas Tyler | Rollback version; 2016.2.20853 was not released. | ||
#28 | 20854 | C. Thomas Tyler | Updated Version to release SDP 2016.2.20853. | ||
#27 | 20806 | C. Thomas Tyler | Updated Version to release SDP 2016.2.20805. | ||
#26 | 20791 | C. Thomas Tyler | Updated Version to release SDP 2016.2.20790. | ||
#25 | 20766 | C. Thomas Tyler | Updated Version to release SDP 2016.2.20755. | ||
#24 | 20755 | C. Thomas Tyler | Correction or order-of-listing issue in release notes. | ||
#23 | 20564 | C. Thomas Tyler | Updated Version to release SDP 2016.1.20559. | ||
#22 | 20515 | C. Thomas Tyler | Updated Version to release SDP 2016.1.20491. | ||
#21 | 20480 | C. Thomas Tyler | Updated Version to release SDP 2016.1.20460. | ||
#20 | 20397 | C. Thomas Tyler | Updated release notes. | ||
#19 | 20389 | C. Thomas Tyler | Updated Version to release SDP 2016.1.20387 (2016/09/04). | ||
#18 | 20387 | C. Thomas Tyler | Updated Version to release SDP 2016.1.20382 (2016/09/04). | ||
#17 | 20352 | C. Thomas Tyler |
Updated SDP Version file in preparation for release of SDP 2016.1.20348. |
||
#16 | 20049 | C. Thomas Tyler |
Upated SDP Version and Release Notes prior to release, to: 2016.1.20028 (2016/08/03). |
||
#15 | 19895 | C. Thomas Tyler |
Updated Version for release to: SDP/MultiArch/2016.1/19888 (2016/07/07). |
||
#14 | 19840 | C. Thomas Tyler | Tweaked Version prior to release. | ||
#13 | 19834 | C. Thomas Tyler | Updated Version and Release Notes for release. | ||
#12 | 19692 | C. Thomas Tyler | Updated Version and ReleaseNotes.txt prior to release. | ||
#11 | 19413 | C. Thomas Tyler | Updated Version and ReleaseNotes.md prior to release. | ||
#10 | 18959 | C. Thomas Tyler | Updated Verion and Release Notes for relesae push. | ||
#9 | 18624 | Russell C. Jackson (Rusty) | Merge in changes from main. | ||
#8 | 17312 | C. Thomas Tyler | Updated Version and Release Notes for release. | ||
#7 | 16872 | C. Thomas Tyler |
Resurrected the "Change History" section of the Release Notes. Added list of jobs to be fixed in the next formal release. |
||
#6 | 12028 | C. Thomas Tyler | Refreshed SDP dev branch, merging down from main. | ||
#5 | 11535 | Russell C. Jackson (Rusty) | Updated dev from main. | ||
#4 | 11463 | Russell C. Jackson (Rusty) | Updated dev to prepare for Summit agreed changes. | ||
#3 | 11038 | Robert Cowham | Catchup from Main | ||
#2 | 10994 | Robert Cowham | Catchup from Main | ||
#1 | 10961 | C. Thomas Tyler | Merge down from main. | ||
//guest/perforce_software/sdp/dev/doc/relnotes-unix.txt | |||||
#2 | 10867 | C. Thomas Tyler | Merge Down: Rereshed 'dev' from 'main'. | ||
#1 | 10638 | C. Thomas Tyler | Populate perforce_software-sdp-dev. | ||
//guest/perforce_software/sdp/main/doc/relnotes-unix.txt | |||||
#2 | 10500 | C. Thomas Tyler | Updated SDP Version, added new distro tar file. | ||
#1 | 10148 | C. Thomas Tyler | Promoted the Perforce Server Deployment Package to The Workshop. |