===== PaperCut on GNU/Linux =====

==== How to upgrade PaperCut Primary Server ====

<code bash>
# Stop the PaperCut server
sudo systemctl stop pc-app-server.service

# Login as user 'papercut'
sudo su - papercut

# Make sure you are in /home/papercut/
cd

# Download the setup binary (remove previous downloaded binary first)
wget url-to/pcmf-setup-linux-x64-xxx.sh

# Set execute permission ...
chmod +x pcmf-setup-linux-x64-xxx.sh

# ... and execute
./pcmf-setup-linux-x64-xxx.sh

# ...
# The install needs to perform the following tasks with root privileges:
#     * Start and stop PaperCut Application Server Service
#     * Setting setuid-root on the authentication provider
#     * Configuring print queues
#     * Configure the server's boot scripts
# 
# Would you like to perform these tasks now?  [yes or no]
# no

# ...
# Root tasks can be applied with the script:
#   /home/papercut/MUST-RUN-AS-ROOT
# Please run this script as root after install.
# Press Enter to confirm...

# ...
# Installation complete!
 
# close session
exit
# Execute root tasks (server is started)
sudo /home/papercut/MUST-RUN-AS-ROOT
</code>

=== PaperCut Secondary Server Upgrade ===

PaperCut Software attempts to maintain basic backwards compatibility with the secondary server. This means you can upgrade your primary server, and stagger the upgrade of secondary print servers. //However, we recommend that you upgrade the Secondary Server as best practice.//
> IMPORTANT: you cannot run a secondary server version that is newer than the primary server.