Install on Linux

The Linux installation process involves a few steps with the command line, and assumes you have the installation tar.gz file available on the system. You should be the superuser (root) to perform the installation.

su or sudo sh
curl http://cirrusprint.com/download/install_cp20.sh >/tmp/install_cp20.sh
chmod 544 /tmp/install_cp20.sh
/tmp/install_cp20.sh [-yes]

This will prompt for an install location (defaulting to an existing install), then download the 64-bit or 32-bit tar file, extract it, and run the setup.sh script. If the -yes parameter is supplied, it is passed to the setup.sh script that is run. This will auto-install the dependencies without prompting, after prompting if you want to install system updates.

Create a directory to install the software in, and make it the current directory.

This should be on a file system with plenty of disk space, at least several GB of free space, though actual disk space needed can vary considerably depending on many factors, such as they variety and types of documents you print, and how high or low log and cache purge settings are defined. If you aren't sure, just pick the file system with the most available space.

If you are updating an existing 2.0 installation, use the existing installation directory. Do not rename the existing directory or it will invalidate the license.

mkdir -p /opt/cp20
chmod 777 /opt/cp20
cd /opt/cp20

Do not install CirrusPrint into a directory containing other files.

Uncompress and extract the contents of the downloaded tar file. For example, if the tar file is available in the /tmp directory:

gunzip /tmp/cp20_linux_x86.tar.gz
tar xvf /tmp/cp20_linux_x86_tar

Some systems support a "z" option on the tar command, which performs decompression automatically, so you could enter just one command:

tar xvzf /tmp/cp20_linux_x86.tar.gz

If this is a new installation, run the setup.sh script. This script will prompt you to view and accept the CirrusPrint license agreement.

./setup.sh

This will create /usr/bin/cp20s, and also attempt to create a systemd-based or init.d-based boot configuration. If the install is not currently activated, it will also activate it as a 21-day demo.

It will prompt for which set of HTTP/HTTPS ports to use. For a dedicated machine, you can choose standard ports (80/443), but if this machine runs another web server, you must choose private ports (8482/8483).

Lastly, if there is either the yum (Redhat-based) or apt-get (Debian-based) package manager available, it will attempt to ensure prerequisites are installed, prompting at each step if you want to install a package, such as Openssl, Ghostscript, ImageMagick, and Apache.

If you want to answer "yes" (y) to all the prerequisite installs, you can enter ./setup.sh -yes

When the server is running, you can use the browser interface for monitoring and configuration. The browser interface provides extensive monitoring and configuration tools. When first started, the server establishes a user login "admin" with a random password. To view the password from the command line, while logged in as root, enter:

Using this password, you can login to the browser interface and change the login to your own preference. If you'd prefer to set your own password from the command line:

CirrusPrint by default is configured to start a private instance of the Apache web server. On Linux installations, most standard Apache configurations are automatically recognized, but if not, then you can manually edit the [httpd] section of config.ini. The key lines are:

Uncomment these lines and ensure that httpd points to the Apache web server executable, and serverroot points to a directory where modules (*.so files) reside, or where a "modules" directory resides.

GhostScript is useful to CirrusPrint when it needs to convert PostScript print data to PDF format for browser viewing. CirrusPrint will look for the GhostScript executable as /usr/bin/gs or /usr/local/bin/gs, but if you have a custom location or name for it, you can set gs=path/to/executable in the [server] section of config.ini, or use the Configuration tool in the browser admin interface. Ghostscript is available from the Linux distribution supplier, or from http://ghostscript.com. Ghostscript is usually installed automatically if you install the CUPS spooler.

ImageMagick's convert program (renamed magick.exe at their version 7.0) is used to convert image files to other formats on demand. For example, if you submit a jpeg file to a printer, a Magick-Ghostscript chain will be used to convert that file to postscript or pcl for a printer. ImageMagick is available from the Linux distribution supplier, or from http://imagemagick.org

The setup.sh script will offer to install Ghostscript and ImageMagick if required, using one of the two primary package management tools in the Linux environment, yum or apt-get.