This is the home of the Perforce Helix Installer project.
Perforce Helix is a unified platform for collaborative development, version management, and protection of intellectual property. It consists of an integrated ecosystem of proven, enterprise-grade systems for versioning, code collaboration and review, continuous delivery.
Helix Installer is capabile of quickly transforming a vanilla machine -- virtual or bare metal -- into a demonstraion grade deployment of Helix, suitable for a Proof of Concept rollout. Further, because the demo-grade uses the Perforce Server Deployment Package (SDP, also availalbe in The Workshop), it is very easy to convert it to a production-grade installation.
This is an alternative to the Helix Enterprise Evaluation virtual appliance (OVA).
The Component Based Development (CBD) system, another project in The Workshop, uses this Helix Installer as part of its automated test suite. In conjunction with Vagrant and Virtual Box, which build a vanilla VM from the groud up, the CBD Test Suite uses the Helix Installer to deploy a Perforce server, complete with Sample Depot test data set, plus Python and P4Python needed to test the CBD scripts.
The <CODE>reset_sdp.sh</CODE> script is the only script that should be downloaded. It downloads everything it needs, including other scripts and files from this Helix Installer package, executables from the Perforce FTP site, and the SDP from The Workshop (acquired by cloning).
Once installing a vanilla CentOS 6.7 (or similar) machine, do this as root:
<PRE> useradd perforce
mkdir -p /depotdata/reset
chown -R perforce:perforce /depotdata/reset
cd /depotdata/reset
p4 -u ftp -p workshop.perforce.com:1666 print -q -o reset_sdp.sh //guest/tom_tyler/helix-installer/main/src/reset_sdp.sh
chmod +x reset_sdp.sh
./reset_sdp.sh -man
./reset_sdp.sh 2>&1 | tee reset_sdp.log </PRE>
A similar procedure works for Mac OSX, except that the standard Mac interface is used for creating the <CODE>perforce</CODE> user account rather than the <CODE>useradd</CODE> command, and the <CODE>chown</CODE> command may need to specify a different group, depending on how the user account is created.
HI 1.0, available today, can install the following Helix Components, all fully configured an intgegrated:
HI v1.0 supports:
Future releases may add support for other popular Linux distributions, including those using APT, e.g. Ubuntu and Debian. It may well work as-is presently on other YUM-based installastions.
Please contact Perforce Consulting (mailto:Consulting@Perforce.com) for more information.
This project is functional.
Note that this software SHOULD NEVER EXIST on a Production Perforce server. The is intended to quickly tear down and rebuild a fresh Perforce server (e.g. for operating test suites). It shoudl not exist on a machine containing real Perforce data.
Perforce Helix Installer ("HI") === Welcome --- This is the home of the Perforce Helix Installer project. Perforce [Helix](http://www.perforce.com/helix) is a unified platform for collaborative development, version management, and protection of intellectual property. It consists of an integrated ecosystem of proven, enterprise-grade systems for versioning, code collaboration and review, continuous delivery. Helix Installer is capabile of quickly transforming a vanilla machine -- virtual or bare metal -- into a demonstraion grade deployment of Helix, suitable for a Proof of Concept rollout. Further, because the demo-grade uses the Perforce Server Deployment Package ([SDP](https://swarm.workshop.perforce.com/projects/perforce-software-sdp), also availalbe in The Workshop), it is very easy to convert it to a production-grade installation. This is an alternative to the [Helix Enterprise Evaluation virtual appliance (OVA)](http://www.perforce.com/downloads/helix). Features --- * Fast. Runs in under 20 minutes, including download time. * Easy. Provides reasonable defaults for port numbers, passwords, data storage areas, and all inputs that would otherwise require human interaction. * Comprehensive. Installs P4D and P4Broker, SDP, and a complete development pre-configured environment include Perl, P4Perl, Python, and P4Python, with appropraite shell environment settings to use them all immediately. And more to come -- future versions will include Swarm, Git Fusion, and GitSwarm. * Automates connection to the [Perforce Package Repository](http://package.perforce.com/). * Pre-loads the [Perforce Sample Depot](http://answers.perforce.com/articles/KB/2439) * Simplifies Entrerprise Deployment. While optimized for getting going quickly, the Helix Installer is designd to enable a fast path from a PoC to small-scale production deployment following the Helix evaluation, with a nominal hop from there to a large-scale enterprise deployment. It is based on the Consulting [Server Deployment Package (SDP)](https://swarm.workshop.perforce.com/projects/perforce-software-sdp), use by the Consulting Services team at Perforce to manage various Helix components in large, globally districuted organizations. Usage in Test Suite (Sample) --- The Component Based Development ([CBD](https://swarm.workshop.perforce.com/projects/perforce-software-cbd)) system, another project in The Workshop, uses this Helix Installer as part of its automated test suite. In conjunction with Vagrant and Virtual Box, which build a vanilla VM from the groud up, the [CBD Test Suite](https://swarm.workshop.perforce.com/projects/perforce-software-cbd/files/main/test/auto_test_cbd_vagrant.sh) uses the Helix Installer to deploy a Perforce server, complete with Sample Depot test data set, plus Python and P4Python needed to test the CBD scripts. Instructions and Usage Exmaple --- The <CODE>reset\_sdp.sh</CODE> script is the only script that should be downloaded. It downloads everything it needs, including other scripts and files from this Helix Installer package, executables from the Perforce FTP site, and the SDP from The Workshop (acquired by cloning). Once installing a vanilla CentOS 6.7 (or similar) machine, do this as root: <PRE> useradd perforce mkdir -p /depotdata/reset chown -R perforce:perforce /depotdata/reset cd /depotdata/reset p4 -u ftp -p workshop.perforce.com:1666 print -q -o reset_sdp.sh //guest/tom_tyler/helix-installer/main/src/reset_sdp.sh chmod +x reset_sdp.sh ./reset_sdp.sh -man ./reset_sdp.sh 2>&1 | tee reset_sdp.log </PRE> A similar procedure works for Mac OSX, except that the standard Mac interface is used for creating the <CODE>perforce</CODE> user account rather than the <CODE>useradd</CODE> command, and the <CODE>chown</CODE> command may need to specify a different group, depending on how the user account is created. Helix Installer Roadmap === HI 1.0 (Available Now) --- HI 1.0, available today, can install the following Helix Components, all fully configured an intgegrated: * P4D 2015.2 - the Helix Versioning Engine, the core of Helix. * P4Broker 2015.2 - the Helix Broker, enhances custom automation capabilities, simplifies maintenances. * SDP 2015.2 - Consulting Services Server Deployment Package * Swarm and Git Fusion packages are installed, but not configured. Helix 1.5 (ETA February 2016) will add support for: --- * Helix Swarm - Collaborative web-based code review and continuous delivery. * Helix Git Fusion - enables Git collaboration and access to the Helix Versioning Engine for Git users. * Helix GitSwarm * Optimized for easy Git repo insertion. A <code>p4import</code> user is created and configured with an SSH key, ready to immediately start Git repo imports. A supplemental <code>higf_import</code> tool imports Git the master branch of a git repos in a single step, needing only the cloning URL as input. Platform Support --- HI v1.0 supports: * CentOS/RHEL 6.5 thru 6.7. * Limited support for Mac OSX/Darwin Future releases may add support for other popular Linux distributions, including those using APT, e.g. Ubuntu and Debian. It may well work as-is presently on other YUM-based installastions. Contact Us --- Please contact Perforce Consulting (mailto:Consulting@Perforce.com) for more information. Project Status --- This project is functional. Safety Warning --- Note that this software ***SHOULD NEVER EXIST*** on a Production Perforce server. The is intended to quickly tear down and rebuild a fresh Perforce server (e.g. for operating test suites). It shoudl not exist on a machine containing real Perforce data.
# | Change | User | Description | Committed | |
---|---|---|---|---|---|
#39 | 30497 | C. Thomas Tyler |
Released SDP 2024.1.30495 (2024/07/23). Copy Up using 'p4 copy -r -b perforce_software-helix-installer-dev'. |
||
#38 | 30414 | C. Thomas Tyler |
Released SDP 2024.1.30412 (2024/06/13). Copy Up using 'p4 copy -r -b perforce_software-helix-installer-dev'. |
||
#37 | 30301 | C. Thomas Tyler |
Released SDP 2023.2.30299 (2024/05/09). Copy Up using 'p4 copy -r -b perforce_software-helix-installer-dev'. |
||
#36 | 30046 | C. Thomas Tyler |
Released SDP 2023.1.29958 (2023/12/01). Copy Up using 'p4 copy -r -b perforce_software-helix-installer-dev'. |
||
#35 | 29960 | C. Thomas Tyler |
Released SDP 2023.1.29958 (2023/12/01). Copy Up using 'p4 copy -r -b perforce_software-helix-installer-dev'. |
||
#34 | 29913 | Robert Cowham |
Add warnings at the top that this is not preferred method - too dangerous for inexperiecned users. To be revisited later. |
||
#33 | 29707 | C. Thomas Tyler |
Released SDP 2023.1.29698 (2023/07/11). Copy Up using 'p4 copy -r -b perforce_software-helix-installer-dev'. |
||
#32 | 29618 | C. Thomas Tyler |
Released SDP 2023.1.29616 (2023/05/25). Copy Up using 'p4 copy -r -b perforce_software-helix-installer-dev'. |
||
#31 | 29450 | C. Thomas Tyler |
Released SDP 2022.2.29448 (2023/02/27). Copy Up using 'p4 copy -r -b perforce_software-helix-installer-dev'. |
||
#30 | 29405 | C. Thomas Tyler |
Released SDP 2022.2.29403 (2023/02/06). Copy Up using 'p4 copy -r -b perforce_software-helix-installer-dev'. |
||
#29 | 28931 | C. Thomas Tyler |
Released SDP 2022.1.28929 (2022/07/05). Copy Up using 'p4 copy -r -b perforce_software-helix-installer-dev'. |
||
#28 | 28863 | C. Thomas Tyler |
Released SDP 2022.1.28834 (2022/05/27). Copy Up using 'p4 copy -r -b perforce_software-helix-installer-dev'. |
||
#27 | 28665 | C. Thomas Tyler |
Released SDP 2022.1.28663 (2022/03/08). Copy Up using 'p4 copy -r -b perforce_software-helix-installer-dev'. |
||
#26 | 28415 | C. Thomas Tyler |
Released SDP 2021.4.28409 (2021/11/24). Copy Up using 'p4 copy -r -b perforce_software-helix-installer-dev'. |
||
#25 | 28129 | C. Thomas Tyler |
Released SDP 2021.3.28126 (2021/10/24). Copy Up using 'p4 copy -r -b perforce_software-helix-installer-dev'. |
||
#24 | 27427 | C. Thomas Tyler |
Released SDP 2021.2.27425 (2021/02/09). Copy Up using 'p4 copy -r -b perforce_software-helix-installer-dev'. |
||
#23 | 26976 | C. Thomas Tyler | Minor doc tweaks to README.md | ||
#22 | 26975 | C. Thomas Tyler | Released HelixInstaller 2020.2.26973 (2020/12/01). | ||
#21 | 26031 | C. Thomas Tyler | Released Helix Installer 2019.4.26026 (2019/08/22). | ||
#20 | 25999 | C. Thomas Tyler | Released HelixInstaller 2019.4.25995 (2019/08/20). | ||
#19 | 25871 | C. Thomas Tyler | Released Helix Installer 2019.3.25869 (2019/07/23) | ||
#18 | 25822 | C. Thomas Tyler | Released HelixInstaller/MultiArch/2019.3/25820 (2019/07/11). | ||
#17 | 25725 | C. Thomas Tyler | Released HelixInstaller/MultiArch/2019.2/25723 (2019/06/19). | ||
#16 | 25600 | C. Thomas Tyler | Released HelixInstaller 2019.2.25598. | ||
#15 | 25315 | C. Thomas Tyler |
Released Rev. HelixInstaller/MultiArch/2019.1/25313 (2019/03/07). |
||
#14 | 25284 | C. Thomas Tyler |
Released Rev. HelixInstaller/MultiArch/2019.1/25282 (2019/03/06). |
||
#13 | 25260 | C. Thomas Tyler |
Released Rev. HelixInstaller/MultiArch/2019.1/25250 (2019/03/02). |
||
#12 | 24865 | C. Thomas Tyler | Released HelixInstaller v2018.2.24862. | ||
#11 | 23875 | C. Thomas Tyler | Released HelixInstaller/MultiArch/2018.1/23873. | ||
#10 | 23872 | C. Thomas Tyler | Release HelixInstaller/MultiArch/2018.1/23869. | ||
#9 | 23868 | C. Thomas Tyler | Released HelixInstaller/MultiArch/2018.1/23866 (2018/04/11). | ||
#8 | 23608 | C. Thomas Tyler |
Added 'yum install -y gcc gcc-c++' to avoid getting an error that tells you to do that anyway. |
||
#7 | 23283 | C. Thomas Tyler | Released Helix Installer 2017.4.23281 | ||
#6 | 23009 | C. Thomas Tyler | Tweaked LICENSE copyright year and README.md. | ||
#5 | 21671 | C. Thomas Tyler |
Varios updates to the README.md file: * Corrected to use 'curl' rather than 'p4 print' to get the reset_sdp.sh script, since the 'p4' won't exist on a vanilla CentOS/RHEL box. * Updated to reflect modern SDP, using /hxdepots rather than /depotdata. * Updated Project Status to note that support for Swarm and Git Fusion have been deferred. |
||
#4 | 19266 | C. Thomas Tyler | Minor corrections and typo fixes. | ||
#3 | 19265 | C. Thomas Tyler |
Updated README.md for first formal release. Added Version and doc/ReleaseNotes.md files. |
||
#2 | 19261 | C. Thomas Tyler | Accounted for move to //guest/perforce_software from //guest/tom_tyler. | ||
#1 | 19230 | C. Thomas Tyler |
Populate -o //guest/tom_tyler/helix-installer/... //guest/perforce_software/helix-installer/.... |
||
//guest/tom_tyler/helix-installer/main/README.md | |||||
#5 | 16848 | C. Thomas Tyler | Fixed a typo. | ||
#4 | 16672 | C. Thomas Tyler | Added clear step-by-step usage instructions. | ||
#3 | 16669 | C. Thomas Tyler | Updated README.md file for Helix Installer Project. | ||
#2 | 16410 | C. Thomas Tyler | Updated supported versions. | ||
#1 | 15829 | C. Thomas Tyler |
Moved Helix Installer to new Workshop Standard for personal projects. |
||
//guest/tom_tyler/sw/main/hi/README.md | |||||
#1 | 12335 | C. Thomas Tyler | Copied README.me up to main. | ||
//guest/tom_tyler/sw/dev/hi/README.md | |||||
#1 | 12333 | C. Thomas Tyler | Bootstrapped doc file. |