Installing Cruise Server
Introduction
The Cruise Server is the core of your system.
Installation
How to install Cruise Server for Windows
You must be logged in as a user with Administrator privileges to install the Cruise Server on Windows.
- Double-click the cruise-server-${version}.exe installer file and follow the prompts to install Cruise.
- During installation you will be asked to select a directory to install the Cruise Server into. Cruise Server will also store its data in this directory by default.
- At the end of the installation Cruise Server will register itself as a windows service and start running automatically.
- Cruise will create a shortcut on your Desktop and in your Start Menu - double-click the shortcut to go to the Cruise dashboard.
How to install Cruise Server for Mac OSX
- Double-click the downloaded file to unzip the contents.
- Drag the Cruise Server Application to the Applications folder.
- Cruise Server will store its data in /Library/Application Support/Cruise Server
- Double-click on the Cruise Server.app icon to open the launcher.
-
While the Cruise Server is starting up, you'll see a progress bar in the top left of your screen.
- Once the Cruise Server has started, it will open your default browser on the Cruise dashboard page.
- To get back to the Cruise dashboard page when the server is running, click on the link in the About box of the Cruise Server
How to install Cruise Server for Linux
You must be logged in as root, or use "sudo", to install Cruise on Linux. Cruise Server also requires that the Sun Java 6 JRE is installed. The Linux installer will create a user called cruise if one does not exist on the machine. The home directory will be set to /var/cruise. If you want to create your own cruise user, make sure you do it before you install the Cruise Agent
RPM based distributions (i.e. RedHat)
The Cruise Server RPM installer has only been tested on RedHat Enterprise Linux 5 and CentOS 5. However it should work on most Linux distributions which use rpms.
- Run 'sudo rpm -i cruise-server-${version}.noarch.rpm' to install Cruise Server.
Debian based distributions (i.e. Ubuntu)
The Cruise Server installer has only been tested on Ubuntu 7.10. However it should work on most Linux distributions which use debs.
- Run 'sudo dpkg -i cruise-server-${version}.deb' to install Cruise Server.
Once the installation is complete the Cruise Server will be started and it will print out the URL for the Dashboard page. This will be http://<server host name>:8153/cruise
How to install Cruise Server for Solaris
You must be logged in as root, or use "sudo", to install Cruise under Solaris. Cruise Agent also requires that the Sun Java 6 JDK is installed.
The installer will create a user called cruise if one does not exist on the machine.
- Uncompress the package with the command 'gzip -d cruise-server-${version}-solaris.gz'
- Install the package with the command 'sudo pkgadd -d cruise-server-${version}-solaris'
File location after installations of Cruise Server
Windows
All the files of Cruise Server are under the installed directory on Windows, the default location is c:/Program Files/Cruise Server.
linux
/var/lib/cruise-server/
/etc/cruise
/var/log/cruise-server
/usr/share/cruise-server
Mac OSX
/Library/Application Support/CruiseServer
/Library/Logs/CruiseServer
cruisewrapper log information is in /var/log/system.log
Solaris
/var/cruise-server
/etc/cruise
/usr/share/cruise-server
/var/log/cruise-server
Entering your license key
Cruise requires you to enter a license key before you can use it. The first screen you should see upon opening the Cruise dashboard is the screen that prompts you to enter your license key. Cruise will automatically recognise a license key from version 1.0. You do not need to get a new license key if you have one already.
You should have been emailed a license key when you downloaded Cruise. If not, you can get a free trial license key from the Studios website: go to the Cruise page and follow the instructions to get your free license.
Your license key is tied to the username you used to register. Enter the username you used to register, and copy and paste the license key from your email into the textbox provided. Cruise will ignore spaces, line breaks and so forth in the license key. When you are done, click on "Save license" to save your license key. Cruise should tell you either that your license key has been updated successfully, or give you an error message telling you what went wrong.
Once you've entered your license key, you can proceed to set up your first pipeline by clicking on the "Current Activity" tab.
Artifact repository configuration
Cruise needs no configuration once installed. However we recommend that you create a separate partition on your computer's hard disk for Cruise Server to store artifacts. The artifacts repository can grow in size very quickly, and if it fills up your main partition you may experience data loss and unpredictable application behaviour.
Once you have created a new partition, you need to tell Cruise where it is. Go to the "Administration" tab, and click on the tab marked "Source XML". Then click on "edit" to edit Cruise's configuration file. You want to update the configuration so it looks like this:
<cruise>
<server artifactsdir="/path/to/artifacts/directory">
...
</server>
</cruise>
We recommend putting your artifacts directory in "/var/cruise-artifacts" on Linux. In Windows, you may need to assign your artifacts repository partition a separate drive letter. In Windows, your configuration might look like this:
<cruise>
<server artifactsdir="E:\cruise-artifacts">
...
</server>
</cruise>
When you have entered this information, click "Save" to save the configuration file.
You can change the artifacts directory location at any time using the method described above, even when Cruise is running. However Cruise will not move existing artifacts to the new location for you, and changing the location while Cruise is running can result in data loss.
If you decide to move your artifacts repository, the safe way to do it is:
- pause all pipelines, and wait until all activity on the grid has completed (all agents are in the state "idle");
- shut down Cruise Server;
- copy the artifacts repository to the new location;
- edit Cruise's configuration file manually as described above to tell Cruise where the artifacts are;
- restart Cruise Server.
Even when all activity on the grid has stopped, users may still be uploading artifacts using the RESTful URLs, hence the need to stop Cruise Server completely to be safe.