Welcome to 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, collaboration and code review, continuous integration and delivery, and other aspects of a DevOps pipeline.
Th Helix Installer is capable of quickly transforming a vanilla Linux machine -- virtual, bare metal, Docker container, etc. -- into a near-enterprise-grade deployment of several Helix Server components typically be present in a true enterprise installation. The installation uses the Server Deployment Package (SDP).
The installation is suitable for:
The Helix Installer is 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 ground 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.
A slightly modified Helix Installer is a key component of the Battle School Workshop. The Battle School Workshop Lab Engine quickly tears down and spins up a fresh, enterprise-style Helix installation -- and then breaks it in order to simulate real-world problems that students learn to identify and fix. The Battle School version of the Helix Installer (not presently available for public consumption) uses a simulated global topology with replicas and edge servers.
reset_sdp.sh 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:
useradd perforce mkdir -p /hxdepots/reset chown -R perforce:perforce /hxdepots/reset cd /hxdepots/reset curl -k -s -O https://swarm.workshop.perforce.com/downloads/guest/perforce_software/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
A similar procedure works for Mac OSX, except that the standard Mac interface is used for creating the
perforce user account rather than the
useradd command, and the
chown command may need to specify a different group (e.g.
staff), depending on the Mac OSX environment.
See the Helix Installer Release Notes.
Helix Installer 2016.1 is available today, and installs the following Helix Components, all fully configured an integrated:
The 2017.1 release is expected to add support for:
The 2017.2 release is expected to add support for:
Helix Git Fusion - enables Git collaboration and access to the Helix Versioning Engine for Git users.
p4importuser is created and configured with an SSH key, ready to immediately start Git repo imports. A supplemental
higf_importtool imports Git the master branch of a git repos in a single step, needing only the cloning URL as input.
Helix Installer 2016.1 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 installations.
As of February 2017, this project is functional and has been actively used since April 2015. It has been actively maintained to keep pace with SDP changes. However, planned releases to add new features, auto-installing Swarm and Git Fusion support, have been deferred.
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 should not exist on a machine containing real Perforce data.
It may be useful for doing an initial installation, e.g. to a cloud hosted environment. After the initial install, the reset_sdp.sh script should be removed.
Please [contact Perforce Consulting Services] (mailto:Consulting@Perforce.com) for more information.
|#22||26030||tom_tyler||Documentation enhancements, including adding sample generated settings.cfg file.|
|#21||25998||tom_tyler||More README.md tweaks prior to release.|
|#20||25997||tom_tyler||Updated Version, ReleaseNotes.md, and README.md for release.|
Adjusted test suite to test only Ubuntu 16.04 Long Term Support (LTS)
|#18||25821||tom_tyler||Updated Version and Release Notes for release.|
Dropping Ununtu 18 from test suite. Defauilt shell is 'sh' rather than 'bash',
and our Package repository doesn't yet support Ubuntu 18. Support may be re-added
Refactored test suite details into a separate file.
Added a missing 'chmod +x' step.
Removed exported HTML format, opting to rely soley on Markdown
|#15||25288||tom_tyler||Fixed typo in 'vagrant' command for test suite.|
|#14||25283||tom_tyler||Updated for release.|
|#13||25249||tom_tyler||Updated for v3.x.|
Updated Road Map.
Added Support comments to more clearly indicate the Helix Installer is community supported.
Added notes on Test Suite and testing with Vagrant.
|#11||23873||tom_tyler||Added openssl-devel to list of needed packages.|
|#10||23869||tom_tyler||Added zlib-devel to list of needed packages.|
|#9||23866||tom_tyler||Updated roadmap and fixed a typo.|
|#8||23865||tom_tyler||Added rsync to list of packages needed.|
|#7||23864||tom_tyler||Added rsync to list of packages needed.|
|#6||23609||tom_tyler||Routine merge-down from main.|
Updated README page and release notes.
Updated Version for release.
|#4||23011||tom_tyler||Routine merge down to dev from main.|
|#3||21827||tom_tyler||Helix Installer, Routine merge down to dev from main.|
|#2||19315||tom_tyler||Routine Merge Down to dev from main for helix-installer.|
|#1||19232||tom_tyler||Populate -b perforce_software-helix-installer-dev.|
|#1||19230||tom_tyler||Populate -o //guest/tom_tyler/helix-installer/... //guest/perforce_software/helix-installer/....|
|#5||16848||tom_tyler||Fixed a typo.|
|#4||16672||tom_tyler||Added clear step-by-step usage instructions.|
|#3||16669||tom_tyler||Updated README.md file for Helix Installer Project.|
|#2||16410||tom_tyler||Updated supported versions.|
Moved Helix Installer to new Workshop Standard
for personal projects.
|#1||12335||tom_tyler||Copied README.me up to main.|
|#1||12333||tom_tyler||Bootstrapped doc file.|