# Release Notes for HI - Helix Installer ## Introduction This document describes changes to the Helix Installer. ## Change History **2024/06/13**: HelixInstaller/MultiArch/2024.1/30412 (2024/06/13). Jobs fixed since change 30299 up to 30412 (F=Feature, D=Doc, B=Bug): * [HI-137](https://perforce.atlassian.net/browse/HI-137 (F): Added Rocky Linux 9 to regression test suite. * [HI-136](https://perforce.atlassian.net/browse/HI-136 (F): Added built-in logging, so use of redirects and tee is no longer necessary. * [HI-135](https://perforce.atlassian.net/browse/HI-135 (F): Changed default Helix Core version to r24.1. * [HI-134](https://perforce.atlassian.net/browse/HI-134 (F): Added support for separate HxCheckpoints volume. * [HI-133](https://perforce.atlassian.net/browse/HI-133 (B): Adjust location of generated crontab file to /p4/common/etc/cron.d/crontab.... * [HI-132](https://perforce.atlassian.net/browse/HI-132 (F): Add '-no_enable' option to avoid enabling installed services. * [HI-129](https://perforce.atlassian.net/browse/HI-129 (B): Set P4MASTERHOST setting in SDP to DNS_name_of_master_server in settings.cfg. * [HI-128](https://perforce.atlassian.net/browse/HI-128 (F): Adapt to changes in SDP 2024.1, including support for linux26aarch64. **2024/05/09**: HelixInstaller/MultiArch/2023.2/30299 (2024/05/09) Jobs fixed since change 30045 up to 30299 (F=Feature, D=Doc, B=Bug): * [HI-127](https://perforce.atlassian.net/browse/HI-127 (F): Added '-si ' to simplify standalone proxy/boker config. * [HI-126](https://perforce.atlassian.net/browse/HI-126 (F): Added 'lslocks' to sudo commands in limited sudoers. * [HI-125](https://perforce.atlassian.net/browse/HI-125 (B): Adapt to changed SDP default password. * [HI-124](https://perforce.atlassian.net/browse/HI-124 (F): Adapt apt to keyring setup for Ubuntu for package.perforce.com. * [HI-123](https://perforce.atlassian.net/browse/HI-123 (F): Added support for managing helix-auth in limited sudoers. **2023/12/22**: HelixInstaller/MultiArch/2023.1/30045 (2023/12/22) Jobs fixed since change 29958 up to 30045 (F=Feature, D=Doc, B=Bug): * [HI-119](https://perforce.atlassian.net/browse/HI-119) (F): Changed default SDP version to r23.2. **2023/12/01**: HelixInstaller/MultiArch/2023.1/29958 (2023/12/01) Jobs fixed since change 29698 up to 29958 (F=Feature, D=Doc, B=Bug): * [HI-117](https://perforce.atlassian.net/browse/HI-117) (D): Enhanced safety warnings. * [HI-116](https://perforce.atlassian.net/browse/HI-116) (B): Improved settings.cfg parsing so things like mail host with a colon don't break it. * [HI-115](https://perforce.atlassian.net/browse/HI-115) (B): Adjusted limited sudoers for varying locations of getcap, setcap. * [HI-114](https://perforce.atlassian.net/browse/HI-114) (B): Fixed wrong/root ownership of 'downloads' dir if '-no_sd' used. **2023/07/11**: HelixInstaller/MultiArch/2023.1/29698 (2023/07/11) Jobs fixed since change 29661 up to 29698 (F=Feature, B=Bug): * [HI-112](https://swarm.workshop.perforce.com/jobs/HI-112) (B): Fixed Workshop URLs broken during Workshop upgrade. **2023/06/27**: HelixInstaller/MultiArch/2023.1/29661 (2023/06/27) Jobs fixed since change 29616 up to 29661 (F=Feature, B=Bug): * [HI-111](https://swarm.workshop.perforce.com/jobs/HI-111) (B): Fixed bug in format of limited sudoers file. **2023/05/25**: HelixInstaller/MultiArch/2023.1/29616 (2023/05/25) Jobs fixed since change 29448 up to 29616 (F=Feature, B=Bug): * [HI-110](https://swarm.workshop.perforce.com/jobs/HI-110) (F): Make Core 2023.1 the default version. **2023/02/27**: HelixInstaller/MultiArch/2022.2/29448 (2023/02/27) Jobs fixed since change 29403 up to 29448 (F=Feature, B=Bug): * [HI-108](https://swarm.workshop.perforce.com/jobs/HI-108) (F): Added 'bc' packages to standard install, as needed for parallel checkpoints. **2023/02/06**: HelixInstaller/MultiArch/2022.2/29403 (2023/02/06) Jobs fixed since change 29075 up to 29403 (F=Feature, B=Bug): * [HI-105](https://swarm.workshop.perforce.com/jobs/HI-105) (F): Updated default Helix Core version from r22.1 to r22.2. * [HI-99](https://swarm.workshop.perforce.com/jobs/HI-99) (F): Helix installer does not have a --help flag **2022/10/10**: HelixInstaller/MultiArch/2022.1/29075 (2022/10/10) Jobs fixed since change 28929 up to 29075 (F=Feature, B=Bug): * [HI-101](https://swarm.workshop.perforce.com/jobs/HI-101) (F): Add 'systemctl cat' to list of limited sudoers commands for p4* services. * [HI-102](https://swarm.workshop.perforce.com/jobs/HI-102) (F): Added p4prometheus to list of services managd with limited sudo. **2022/07/05**: HelixInstaller/MultiArch/2022.1/28929 (2022/07/05) Jobs fixed since change 28834 up to 28929 (F=Feature, B=Bug): * [HI-100](https://swarm.workshop.perforce.com/jobs/HI-100) (B): HISTFILE setting in perforce_bashrc is not cross-Linux portable. * [HI-98](https://swarm.workshop.perforce.com/jobs/HI-98) (B): Bogus indication that verify_sdp.sh is not available. **2022/05/27**: HelixInstaller/MultiArch/2022.1/28834 (2022/05/27) Jobs fixed since change 28663 up to 28834 (F=Feature, B=Bug): * [HI-92](https://swarm.workshop.perforce.com/jobs/HI-92) (F): Allow restart when in limited sudo mode. * [HI-93](https://swarm.workshop.perforce.com/jobs/HI-93) (B): Fix issue with root ownership of email simulator 'mail'. * [HI-94](https://swarm.workshop.perforce.com/jobs/HI-94) (F): Hostname and Timezone take only with -H/-T flags, not in setting.cfg. * [HI-95](https://swarm.workshop.perforce.com/jobs/HI-95) (F): Add firewalld template for p4p. * [HI-96](https://swarm.workshop.perforce.com/jobs/HI-96) (F): Changed default Helix Core version to r22.1. **2022/03/08**: HelixInstaller/MultiArch/2022.1/28663 (2022/03/08) Jobs fixed since change 28409 up to 28663 (F=Feature, B=Bug): * [HI-54](https://swarm.workshop.perforce.com/jobs/HI-54) (F): Support SELinux in enforcing mode on RHEL 8/CentOS 8/Rocky Linux 8. * [HI-84](https://swarm.workshop.perforce.com/jobs/HI-84) (F): Add '-no_firewall' option to skip the firewalld config. * [HI-86](https://swarm.workshop.perforce.com/jobs/HI-86) (F): Add '-no_sudo' option to skip sudoers handling. * [HI-89](https://swarm.workshop.perforce.com/jobs/HI-89) (F): Changed P4Python install method to use package. **2021/11/24**: HelixInstaller/MultiArch/2021.4/28409 (2021/11/24) Jobs fixed since change 28126 up to 28409 (F=Feature, B=Bug): * [HI-27](https://swarm.workshop.perforce.com/jobs/HI-27) (F): Simplify setup of a proxy-only or broker-only SDP server. * [HI-79](https://swarm.workshop.perforce.com/jobs/HI-79) (B): The '-ls' (limited sudo) option works only in '-local' mode. * [HI-80](https://swarm.workshop.perforce.com/jobs/HI-80) (B): Sample Depot checkpoint fails to load when checkpoint is case-insensitive. * [HI-81](https://swarm.workshop.perforce.com/jobs/HI-81) (F): Drop the insecure option from curl/wget commands. * [HI-82](https://swarm.workshop.perforce.com/jobs/HI-82) (F): Changed default version of Helix Core binaries to r21.2. * [HI-83](https://swarm.workshop.perforce.com/jobs/HI-83) (B): The /p4/ssl/config.txt file had incorrect root ownership. Fixed. **2021/10/24**: HelixInstaller/MultiArch/2021.3/28126 (2021/10/24) Jobs fixed since change 27425 up to 28126 (F=Feature, B=Bug): * [HI-72](https://swarm.workshop.perforce.com/jobs/HI-72) (F): Re-add CentOS 8 to new Docker-based test suite. * [HI-77](https://swarm.workshop.perforce.com/jobs/HI-77) (F): Changed default version of Helix Binaries to r21.1. * [HI-78](https://swarm.workshop.perforce.com/jobs/HI-78) (F): Added -no_systemd option to avoid using systemd. **2021/02/09**: HelixInstaller/MultiArch/2021.2/27425 (2021/02/09) Jobs fixed since change 27227 up to 27425 (F=Feature, B=Bug): * [HI-63](https://swarm.workshop.perforce.com/jobs/HI-63) (F): Add option to give limited sudo only. * [HI-64](https://swarm.workshop.perforce.com/jobs/HI-64) (F): Added '-H ' option to set hostname. * [HI-65](https://swarm.workshop.perforce.com/jobs/HI-65) (F): Add ServerID, ServerType, and TargetServerType from SDP mkdirs.sh * [HI-66](https://swarm.workshop.perforce.com/jobs/HI-66) (F): Provide more documentation for '-local' with sample how-to. * [HI-67](https://swarm.workshop.perforce.com/jobs/HI-67) (F): Add -no_tweaks option to skip running SDP os_tweaks.sh script. * [HI-68](https://swarm.workshop.perforce.com/jobs/HI-68) (F): Add -v option to run SDP verify_sdp.sh. * [HI-69](https://swarm.workshop.perforce.com/jobs/HI-69) (B): Make Sample Depot work with non-default /hxdepots mount. * [HI-70](https://swarm.workshop.perforce.com/jobs/HI-70) (F): Drop CentOS 6 rom test suite. **2021/01/19**: HelixInstaller/MultiArch/2021.1/27227 (2021/01/20) Jobs fixed since change 27163 up to 27227 (F=Feature, B=Bug): * [HI-61](https://swarm.workshop.perforce.com/jobs/HI-61) (B): Narrow chown -R to /hxdepots/p4 to avoid .snapshot/lost+found dirs. * [HI-62](https://swarm.workshop.perforce.com/jobs/HI-62) (F): Add best practice of using per-terminal window shell history files. **2021/01/11**: HelixInstaller/MultiArch/2021.1/27163 (2021/01/11) Jobs fixed since change 27157 up to 27163 (F=Feature, B=Bug): * [HI-60](https://swarm.workshop.perforce.com/jobs/HI-60) (B): Fix issue detecting if p4d started when SSL was enabled. **2021/01/09**: HelixInstaller/MultiArch/2021.1/27157 (2021/01/09) Jobs fixed since change 27137 up to 27157 (F=Feature, B=Bug): * [HI-59](https://swarm.workshop.perforce.com/jobs/HI-59) (F): Use SDP systemd service templates if they exist. **2021/01/03**: HelixInstaller/MultiArch/2021.1/27137 (2021/01/03) Jobs fixed since change 27031 up to 27137 (F=Feature, B=Bug): * [HI-57](https://swarm.workshop.perforce.com/jobs/HI-57) (F): Added wait loop for p4d service start with systemd in Sample Depot. * [HI-58](https://swarm.workshop.perforce.com/jobs/HI-58) (F): Drop systemd unit file for p4p. **2020/12/11**: HelixInstaller/MultiArch/2020.2/27031 (2020/12/11) Jobs fixed since change 26973 up to 27031 (F=Feature, B=Bug): * [HI-56](https://swarm.workshop.perforce.com/jobs/HI-56) (F): Support SDP r20.1 **2020/12/01**: HelixInstaller/MultiArch/2020.2/26973 (2020/12/01) Jobs fixed since change 26829 up to 26973 (F=Feature, B=Bug): * [HI-33](https://swarm.workshop.perforce.com/jobs/HI-33) (F): Add capability to load crontab. * [HI-48](https://swarm.workshop.perforce.com/jobs/HI-48) (F): Remove CentOS 6 from test suite after it goes OEL in Nov 2020. * [HI-56](https://swarm.workshop.perforce.com/jobs/HI-56) (F): Support SDP r20.1 **2020/10/07**: HelixInstaller/MultiArch/2020.1/26829 (2020/10/07) Jobs fixed since change 26784 up to 26829 (F=Feature, B=Bug): * [HI-49](https://swarm.workshop.perforce.com/jobs/HI-49) (B): Fix test suite environment issue and CentOS6 hostname issue. * [HI-51](https://swarm.workshop.perforce.com/jobs/HI-51) (B): Fixed 'Blast' logic bug when using separate volumes for /hxmetadata1,2. * [HI-52](https://swarm.workshop.perforce.com/jobs/HI-52) (B): Fixed RHEL/CentOS 8 test suite failure due to missing major version check. * [HI-53](https://swarm.workshop.perforce.com/jobs/HI-53) (B): Fixed issue with extra '/' in symlinks under /p4 for Hx* settings. **2020/09/25**: HelixInstaller/MultiArch/2020.1/26784 (2020/09/25) Jobs fixed since change 26607 up to 26784 (F=Feature, B=Bug): * [HI-43](https://swarm.workshop.perforce.com/jobs/HI-43) (B): Fixed issue calling init script on RHEL/CentOS 6. * [HI-44](https://swarm.workshop.perforce.com/jobs/HI-44) (F): Make /hx* mount points configurable in settings.cfg * [HI-47](https://swarm.workshop.perforce.com/jobs/HI-47) (F): Add Ubuntu 20 to the test suite. **2020/07/10**: HelixInstaller/MultiArch/2020.1/26607 (2020/07/10). * Non-functional changes to maintain shellcheck compliance. **2020/06/17**: HelixInstaller/MultiArch/2020.1/26576 (2020/06/17). * [HI-36](https://swarm.workshop.perforce.com/jobs/HI-36) - In one place, a chmod is used where a chown is needed. * [HI-37](https://swarm.workshop.perforce.com/jobs/HI-37) - When OSUSER perforce is created, set password same as same P4USER. * [HI-40](https://swarm.workshop.perforce.com/jobs/HI-40) - Updated default p4d to r20.1. * [HI-41](https://swarm.workshop.perforce.com/jobs/HI-41) - p4*_N.service.t should point to SDP doc. * [HI-42](https://swarm.workshop.perforce.com/jobs/HI-42) - Adjusted to new order of operations with latest SDP. **2020/01/22**: HelixInstaller/MultiArch/2019.4/26181 (2020/01/22). * [HI-32](https://swarm.workshop.perforce.com/jobs/HI-32) - Updated default Helix binaries to 2019.2. * [HI-31](https://swarm.workshop.perforce.com/jobs/HI-31) - Enhanced '-d ' to use an SDP.Unix.tgz. * [HI-30](https://swarm.workshop.perforce.com/jobs/HI-30) - Added CentOS 8 to test suite. **2019/08/22**: HelixInstaller/MultiArch/2019.4/26029 (2019/08/22). * [HI-28](https://swarm.workshop.perforce.com/jobs/HI-28) - Fix issue with systemd files when OSUSER is not perforce. * [HI-29](https://swarm.workshop.perforce.com/jobs/HI-29) - Enable Sample Depot install with non-default OSUSER. **2019/08/21**: HelixInstaller/MultiArch/2019.4/26010 (2019/08/21). * [HI-26](https://swarm.workshop.perforce.com/jobs/HI-26) - Fixed systemd service file for p4d containing hard-coded ref to instance 1. **2019/08/20**: HelixInstaller/MultiArch/2019.4/26006 (2019/08/20). * [HI-21](https://swarm.workshop.perforce.com/jobs/HI-21) - Make OSUSER and OSGROUP configurable settings. * [HI-24](https://swarm.workshop.perforce.com/jobs/HI-24) - Enhance sample config file to show must/should/shouldn't change values. **2019/08/20**: HelixInstaller/MultiArch/2019.4/25995 (2019/08/20). * https://swarm.workshop.perforce.com/jobs/HI-17 * https://swarm.workshop.perforce.com/jobs/HI-18 * https://swarm.workshop.perforce.com/jobs/HI-19 * https://swarm.workshop.perforce.com/jobs/HI-20 **2019/07/24**: HelixInstaller/MultiArch/2019.3/25890 (2019/07/24): * Fixed issue with Ubuntu 18 tests. * Test suite adjustments. **2019/07/23**: HelixInstaller/MultiArch/2019.3/25869 (2019/07/23): * https://swarm.workshop.perforce.com/jobs/HI-13 * https://swarm.workshop.perforce.com/jobs/HI-16 **2019/07/11**: HelixInstaller/MultiArch/2019.3/25820 (2019/07/11): * https://swarm.workshop.perforce.com/jobs/HI-15 * https://swarm.workshop.perforce.com/jobs/HI-14 * https://swarm.workshop.perforce.com/jobs/HI-12 * https://swarm.workshop.perforce.com/jobs/HI-11 * https://swarm.workshop.perforce.com/jobs/HI-10 * https://swarm.workshop.perforce.com/jobs/HI-9 **2019/06/19**: HelixInstaller/MultiArch/2019.2/25723 (2019/06/19). Upgraded to use 2019.1 Helix Core executables, and made test suite enhancements. **2019/05/02**: HelixInstaller/MultiArch/2019.2/25598 (2019/05/02). Changed default tarball for SDP installs. **2019/04/12**: Helix Installer MultiArch/2019.2/25497. Bug fix so email settings take effect, and added MailFrom setting. **2019/04/11**: Helix Installer MultiArchs/2019.2.25493. Parameterized setup. Changed default tarball for SDP installs. **2019/03/21**: Helix Installer MultiArchs/2019.1.25392. Changed default tarball for SDP installs. **2019/03/21**: Helix Installer MultiArchs/2019.1.25382. Changed default tarball for SDP installs. Added '-C' and '-c' flags to support generating and using config files. **2019/03/08**: Helix Installer MultiArchs/2019.1.25324. Changed default tarball for SDP installs. **2019/03/07**: Helix Installer MultiArchs/2019.1.25313. This update includes minor updates: * Added support for handling firewalld. * Added CentOS 7 to test suite. * Adjusted to use 'ftp' user for Workshop. * Ensure perforce user owns his his own home directory when newly created. * Fixed doc typo in vagrant test suite operation command. **2019/03/06**: Helix Installer MultiArch/2019.1.25285. This update addes connection to the Perforce Package Repository, making it easy to add Helix Swarm, the Git Connector, etc. **2019/03/03**: Helix Installer MultiArch/2019.1.25250. This is a major version release 3.1. Also Updated SDP to 2019.1, a new major SDP release. **2019/02/22**: Helix Installer MultiArch/2019.1.25164. Updated SDP version, other test suite updates. **2018/11/24**: Helix Installer MultiArch/2018.2.24912. Added login for sdp_reader. **2018/11/14**: Helix Installer MultiArch/2018.2.24862. Updated for P4D 2018.2. **2018/04/11**: Helix Installer MultiArch/2018.1.23873. Added openssl-devel to list of packages to install in preparation for running `reset_sdp.sh`. **2018/04/11**: Helix Installer MultiArch/2018.1.23869. Added adding zlib-devel to list of packages to install in preparation for running `reset_sdp.sh`. **2018/04/11**: Helix Installer MultiArch/2018.1.23866. Doc updates only, including adding rsync to list of packages to install in preparation for running `reset_sdp.sh`. **2018/04/03**: Helix Installer MultiArch/2018.1.23826. Update to latest SPD Version **2018/02/12**: Helix Installer MultiArch/2018.1.23597, Updated to latest SDP version. **2018/01/19**: Helix Installer MultiArch/2018.1.23512. Tweaked to simplify running a series of installs while re-using the Downloads dir, acquiring an updated SDP tarfile from the FTP server if needed. Update to latest SDP. **2017/12/08**: HelixInstaller/MultiArch/2017.4/23363. Enhanced workflow for running a series of trials re-using the downloads dir, acquiring a new SDP tar file only if needed. **2017/12/08**: HelixInstaller/MultiArch/2017.4/23359, updated to current SDP. **2017/12/05**: HelixInstaller/MultiArch/2017.4/23333, updated to current SDP. **2017/11/29**: HelixInstaller/MultiArch/2017.4/23281, doc update only. **2017/11/22**: HelixInstaller/MultiArch/2017.4/23243, added support for testing shelved changelists from the SDP dev branch. **2016/05/04**: HelixInstaller/MultiArch/2016.1/19263, first formal release. **2015/04/04**: Broke ground on the Helix Installer project in The Workshop, change [@12333](https://swarm.workshop.perforce.com/changes/12333). (The actual start of the project was a few years earlier; there is no formal history trail prior to The Workshop.) ## For More Information For more information on jobs, commits, change history details, etc, see: [https://swarm.workshop.perforce.com/projects/perforce_software-helix-installer](https://swarm.workshop.perforce.com/projects/perforce_software-helix-installer)