Platform notes

This page provides additional implementation notes for CloudBees CD/RO platforms in your enterprise. Refer to the following topics for a list of officially supported platforms for CloudBees CD/RO:

CloudBees CD/RO server platform notes

Here are platform notes for the CloudBees CD/RO, web, repository, and CloudBees Analytics servers.

Microsoft Windows platforms

Platform	Notes
Windows 10 (64-bit)	No notes.
Windows 8.1 (64-bit)	No notes.
Windows 7 (64-bit)	Service Pack 1 is recommended. An administrator might need to disable User Account Control (UAC). If the installer runs under account x , but services will run under account y , installation directories (both program and data) will probably have permissions that prevent y ’s access. This applies particularly to data directories.
Windows Server 2016 (64-bit) Windows Server 2012 R2 (64-bit) Windows Server 2012 (64-bit)	An administrator might need to disable User Account Control (UAC). If the installer runs under account x , but services will run under account y , installation directories (both program and data) will probably have permissions that prevent y ’s access. This applies particularly to data directories.

Platform

Notes

Windows 10 (64-bit)

No notes.

Windows 8.1 (64-bit)

No notes.

Windows 7 (64-bit)

Service Pack 1 is recommended.
An administrator might need to disable User Account Control (UAC). If the installer runs under account x , but services will run under account y , installation directories (both program and data) will probably have permissions that prevent y ’s access. This applies particularly to data directories.

Windows Server 2016 (64-bit) Windows Server 2012 R2 (64-bit) Windows Server 2012 (64-bit)

An administrator might need to disable User Account Control (UAC). If the installer runs under account x , but services will run under account y , installation directories (both program and data) will probably have permissions that prevent y ’s access. This applies particularly to data directories.

Linux platforms

Platform Notes

Platform	Notes
CentOS 7 (64-bit)	The following installation prerequisites apply to all CloudBees CD/RO installers. Do not choose `nobody` for the CentOS user. CentOS does not allow a command such as `su - nobody -c foo.sh`, because it is not a shell account.
Red Hat Enterprise Linux 7 (64-bit) Red Hat Enterprise Linux 6 (64-bit)	The following installation prerequisites apply to all CloudBees CD/RO installers. Do not choose `nobody` for the RHEL user. RHEL does not allow a command such as `su - nobody -c foo.sh`, because it is not a shell account.
Ubuntu 18.04 (64-bit) Ubuntu 16.04 (64-bit) Ubuntu 14.04 (64-bit)	The following installation prerequisites apply to all CloudBees CD/RO installers. Choosing the Ubuntu user Do not choose “nobody” for the Ubuntu user. Ubuntu does not allow a command such as `su - nobody -c foo.sh`, because it is not a shell account. Adding the bin directory to the PATH environment variable Update `/etc/environment` to include the CloudBees CD/RO Automation Platform `bin` directory in the PATH environment variable. Steps running with impersonation on Ubuntu use PATH that is set in `/etc/environment`. As a side-effect, the CloudBees CD/RO Automation Platform `bin` directory is not in PATH in the impersonation context, so calls to tools such as ectool and postp fail with a “not found” error. Fixing the `raise ValueError, need a file or string` Error If you receive an error during installation similar to the following: `File "/usr/lib/lsb/install_initd", line 3, in <module> import sys, re, os, initdutil File "/usr/lib/lsb/initdutils.py", line 18 raise ValueError, 'need a file or string' ^ SyntaxError: invalid syntax run the following command: sudo sed -i "s/python3/python/" /usr/lib/lsb/install_initd` ▼ This error is a known Ubuntu bug.

CentOS 7 (64-bit)

The following installation prerequisites apply to all CloudBees CD/RO installers.

Do not choose nobody for the CentOS user. CentOS does not allow a command such as su - nobody -c foo.sh, because it is not a shell account.

Red Hat Enterprise Linux 7 (64-bit) Red Hat Enterprise Linux 6 (64-bit)

The following installation prerequisites apply to all CloudBees CD/RO installers.

Do not choose nobody for the RHEL user. RHEL does not allow a command such as su - nobody -c foo.sh, because it is not a shell account.

Ubuntu 18.04 (64-bit) Ubuntu 16.04 (64-bit)

Ubuntu 14.04 (64-bit)

The following installation prerequisites apply to all CloudBees CD/RO installers.

Choosing the Ubuntu user

Do not choose “nobody” for the Ubuntu user. Ubuntu does not allow a command such as su - nobody -c foo.sh, because it is not a shell account.

Adding the bin directory to the PATH environment variable

Update /etc/environment to include the CloudBees CD/RO Automation Platform bin directory in the PATH environment variable. Steps running with impersonation on Ubuntu use PATH that is set in /etc/environment. As a side-effect, the CloudBees CD/RO Automation Platform bin directory is not in PATH in the impersonation context, so calls to tools such as ectool and postp fail with a “not found” error.

Fixing the raise ValueError, need a file or string Error

If you receive an error during installation similar to the following:

File "/usr/lib/lsb/install_initd", line 3, in <module>
import sys, re, os, initdutil
File "/usr/lib/lsb/initdutils.py", line 18
raise ValueError, 'need a file or string'
^
SyntaxError: invalid syntax
run the following command:
sudo sed -i "s/python3/python/" /usr/lib/lsb/install_initd▼

This error is a known Ubuntu bug.

Agent platform notes

This section lists agent platform notes. You can drive automation on target machines by either installing agents natively or by running them remotely using proxy agents.

Pure agent platforms

All server platforms support pure agents; see their notes here. Consult the table below for additional pure agent platforms.

Platform Notes

Platform	Notes
macOS X 10.4 (Tiger) or later (Intel architecture)	No notes.
SUSE Linux Enterprise Server 12.3 (32- and 64-bit)	Run `zypper install libstdc++6-32bit` before installing agents on a 64-bit machine. This command installs the SUSE 32-bit libraries required by the CloudBees CD/RO executable file.
SUSE Linux Enterprise Server 11.4 (32 and 64-bit)	No notes.

macOS X 10.4 (Tiger) or later (Intel architecture)

No notes.

SUSE Linux Enterprise Server 12.3 (32- and 64-bit)

Run zypper install libstdc++6-32bit before installing agents on a 64-bit machine. This command installs the SUSE 32-bit libraries required by the CloudBees CD/RO executable file.

SUSE Linux Enterprise Server 11.4 (32 and 64-bit)

No notes.

Proxy agents for other platforms

A proxy agent is a CloudBees CD/RO agent that channels to a proxy target, which lets you drive automation in an agentless fashion. A proxy agent is an agent on a supported Windows or Linux platform that you use to take actions on any platform that is not listed above. For example, you can use a proxy agent to automate actions on an IBM z Systems mainframe running z/OS or Linux OS.

You can use a proxy agent to communicate with any target platform that can run commands via an SSH protocol. For details, refer to Configure an environment proxy server.