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 NEW: 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 (locally configured and possibly customized). It entails a straightforward 'p4 fetch' and 'p4 merge' process. For more information, see the hms_ts_setup.sh ship documentation. This documentation is not complete as of this release, and is targeted for new deployments. While the concepts can be retrofitted into any existing SDP installation, some custom procedures are required, as the scripts do not account for evolution of the SDP structure. Contact consulting@perforce.com for more information. -------------------------------------------------------------------------- CHANGE HISTORY: Released: Rev. SDP/MultiArch/2017.4/23354 (2017/12/08) Jobs Fixed since change 23329 up to 23354 (F=Feature, B=Bug): SDP-281 (B): Fixed journalPrefix logic in mkdirs.sh Released: Rev. SDP/MultiArch/2017.4/23329 (2017/12/05) Jobs Fixed since change 23041 up to 23329 (F=Feature, B=Bug): SDP-265 (B): sync_replica.sh and recreate_db_sync_replica.sh should avoid rsync compression SDP-266 (B): Fixed logging issue with sync_replica.sh and recreate_db_sync_replica.sh. SDP-267 (B): Fixed issue detecting an edge server; wrong EDGESERVER value. SDP-268 (F): Added basic comments to all functions in backup_functions.sh. SDP-269 (F): Optimize journalPrefix values for master, edge, standby, replica. SDP-270 (F): Added trigger script to create Swarm reviews (and unit test). SDP-271 (F): Refactor to push common arg_parse into P4Triggers. SDP-272 (F): Enhance p4login info in error output, added -d debug flag. SDP-273 (F): New RequireJob pre-submit trigger. SDP-274 (F): Added trigger to validate contents YAML files. SDP-276 (B): Make mkrep.sh work when /p4/hms instance does not exist. SDP-277 (F): Added license time remaining check script. SDP-278 (F): Enhance upgrade.sh run on machines with only broker/proxy. SDP-279 (F): Added filetype.bypasslock=1 configurable, recommended for Swarm. SDP-280 (F): Updated Support coverage info and enhanced other info in SDP README file. Released: Rev. SDP/MultiArch/2017.3/23041 (2017/10/24) Jobs Fixed since change 23003 up to 23041 (F=Feature, B=Bug): SDP-143 (F): Enhance init scripts to display usage with no args. SDP-259 (B): Fixed logging issue in upgrade.sh - p4broker/p4p start/stop not captured. SDP-260 (F): Simplified stop_p4d() in backup function due to logic now in p4d_base. SDP-261 (B): Fixed minor issue message about rotating journal escaping log capture. SDP-262 (F): Take advantage of '--daemonsafe' arg in P4D 2017.1. SDP-263 (B): Fixed login count in p4login script. Released: Rev. SDP/MultiArch/2017.3/23003 (2017/10/19) Jobs Fixed since change 22201 up to 23003 (F=Feature, B=Bug): SDP-223 (B): Fix EDGESERVER check in p4d_base regression. SDP-224 (B): Fix os_tweaks.sh to work on RHEL/CentOS 6.9. SDP-225 (B): Updated hms_ts_setup.sh to adapt to mkdirs.cfg changes. SDP-226 (B): Fixed typo in variable name in libcore.sh. SDP-227 (B): install_sdp_perl.sh: Added DVCS environment isolation safety feature. SDP-228 (F): install_sdp_perl.sh: Now uses r17.1 API. SDP-232 (F): Re-establish autologinprompt default behavior. SDP-233 (B): Fix bug in sdp_sync.sh related to args passed to rrun function. SDP-234 (B): Change Unix default server.id to be unique to support remote depots SDP-236 (B): Avoid issues interacting with incompatible local Perl. SDP-237 (B): Scripts using libcore.sh display a harmless but scary error after all processing completes. SDP-239 (F): Renamed crontab templates files to be template.job.p4s rather than *.template. SDP-240 (B): Fixed cosmetic logging bug affecting several scripts. SDP-241 (B): Update systemd templates to add new wait targets. SDP-242 (B): Corrected filetypes on some scripts to chmod +x. SDP-248 (F): Provide an override for diff between proxy listen and target ports. SDP-249 (F): Extended P4IGNORE for more Mac files. SDP-250 (F): Add value for db.monitor.shared configurable. SDP-251 (F): Tweaked versions for which net.tcpsize=0 is set. SDP-252 (B): SetWsOptionsAndView.py trigger should exit 0 when p4 client used w/ -t