Go User Documentation

Installing Go server

Before you install the Go server or agent, please take a look at System Requirements.

Installation

How to install Go server for Windows

You must be logged in as a user with Administrator privileges to install the Go server on Windows.

Double-click the go-server-${version}.exe installer file and follow the prompts to install Go.
During installation you will be asked to select a directory that will serve as the root path for your Go server installation. Go server will store all of its associated data in this directory by default.
You will next be prompted to choose the bundled Oracle 7 JRE or specify the location of JRE (or JDK) installed on your system
At the end of the installation, Go server will register itself as a windows service owned by 'Local System' and start running automatically.
Shortcuts to Go will be placed on your Desktop and in your Start Menu for convenience - double-click the shortcut to go to the Go dashboard.

Override default startup arguments

Create a file named wrapper-properties.conf inside the config directory
With reference to the representation above, if you wish to increase the maximum java heap size from default 1024m to 2048m,
1. Copy the property wrapper.java.additional.2=-Xmx1024m from wrapper-server.conf to wrapper-properties.conf
2. Change the value associated to wrapper.java.additional.2 to the desired value 2048m as shown in the above representation
Adding a new property entails:
1. Increment the x by 1 in wrapper.java.additional.x where x is the highest number in wrapper-server.conf and wrapper-properties.conf combined
2. Add this newly created property to the wrapper-properties.conf

How to install Go server for Mac OSX

Double-click the downloaded file to unzip the contents.
Drag the Go server Application to the Applications folder.
Go server will store its data in Library/Application Support/Go Server subfolder of the user's home folder
Double-click on the Go Server.app icon to open the launcher.
While the Go server is starting up, you'll see a progress bar in the top left of your screen.
Once the Go server has started, it will open your default browser to the Go dashboard page.
To get back to the Go dashboard page when the server is running, click on the link in the About box of the Go server

Prior to 12.3.1, Go server stored its data in /Library/Application Support/Go Server. From 12.3.1, it will be in < user-home >/Library/Application Support/Go Server.

If you upgrade your Mac OS to Lion/Mountain Lion, Go installations prior to 12.3.1 will not continue to work. You will need to manually upgrade to 12.3.1 and copy the existing configuration from /Library/Application Support to < user-home >/Library/Application Support

On OSX 10.8.x (Mountain Lion), you may get the following error. "Go Server" is damaged and can't be opened. You should move it to the Trash. This is due to enanced security protections. To allow the install to proceed

Go to System Preferences->Personal->Security & Privacy.
Launch the Security and Privacy applet.
Click on the General tab to highlight it.
Click on the lock icon to allow changes.
Under the heading "Allow applications downloaded from:" click on the Anywhere radio button.

The installation will proceed as normal.

When it is finished, you can change the Security & Privacy setting back to the previous setting.

How to install Go server for Linux

You must be logged in as root, or use sudo, to install Go on Linux. Go server also requires that Oracle or Open JRE or JDK - version 6 or above - is installed.

The Linux installer will create a user called go if one does not exist on the machine. The home directory will be set to /var/go. If you want to create your own go user, make sure you do it before you install the Go server

RPM based distributions (i.e. RedHat)

The Go server RPM installer has been tested on RedHat Enterprise Linux and CentOS. It should work on linux distributions which use rpms

Run rpm -i go-server-${version}.noarch.rpm to install Go server.

Debian based distributions (i.e. Ubuntu)

The Go server deb installer has been tested on Ubuntu. It should work on linux distributions which use debs

Run dpkg -i go-server-${version}.deb to install Go server.

The following command could be used after installation:

Check Go server status with command sudo /etc/init.d/go-server status
Start Go server with command sudo /etc/init.d/go-server start
Stop Go server with command sudo /etc/init.d/go-server stop

Once the installation is complete the Go server will be started and it will print out the URL for the Dashboard page. This will be http://< server host name >:8153/go

How to install Go server for Solaris

The Go server installer has been tested on OpenIndiana

You must be logged in as root, or use sudo or pfexec, to install Go under Solaris. Go server also requires that Oracle or Open JRE or JDK - version 6 or above - is installed.

The installer will create a user called go if one does not exist on the machine. The home directory will be set to /var/go. If you want to create your own go user, make sure you do it before you install the Go server.

Uncompress the package with the command gzip -d go-server-${version}-solaris.gz
Install the package with the command pkgadd -d go-server-${version}-solaris

The following command could be used after installation:

Check Go server status with command svcs go/server
Start Go server with command svcadm enable -s go/server
Stop Go server with command svcadm disable -s go/server

Copying existing config to a new Go-Server instance

You can replicate a go-server with all the pipeline, stage, job, tasks & materials definitions/configuration intact.

To do this Administrator should copy cruise-config.xml to the new server and clear 'serverId' attribute of server tag along with the license.

Location of files after installation of Go server

Windows

All the files for the Go server are under the root installation path on Windows. The default location is C:\Program Files\Go Server.

Linux

/var/lib/go-server       #contains the binaries and database
/etc/go                  #contains the pipeline configuration files
/var/log/go-server       #contains the server logs
/usr/share/go-server     #contains the start script
/etc/default/go-server   #contains all the environment variables with default values. These variable values can be changed as per requirement.

Mac OSX

< user-home >/Library/Application Support/Go Server

Some logging information is also written to /var/log/system.log

Solaris

/var/lib/go-server   #contains the binaries and database
/etc/go              #contains the configuration files
/var/log/go-server   #contains the server logs
/usr/share/go-server #contains the start script