If your Code42 for Enterprise does not restart when its Linux host reboots or upgrades, follow these instructions to determine whether a new or revised restart script will solve the problem. If so, follow the instructions to create a Code42 for Enterprise restart script in /lib/systemd/system/crashplan.service or to modify the existing script at /etc/init.d/crashplan.
CrashPlan apps installed on Linux for all users (the default). When Linux reboots, the CrashPlan app fails to restart. Or a Linux upgrade process reports an error.
The information presented here is intended to offer information to advanced users. However, Code42 does not design or test products for the use described here. This information is presented because of user requests.
Our Customer Champions cannot assist you with unsupported processes, so you assume all risk of unintended behavior. You may want to search our forums for information from other users: Code42 for Enterprise use the Code42 customer community and CrashPlan for Small Business use the support forum.
Code42 for Enterprise writes its restart script to a file in /etc/init.d, a long-time standard for Linux systems. Two Linux variations require a new or revised script:
Missing systemd script
Some Linux systems (see the list below) look for restart scripts in /lib/systemd rather than /etc/init.d. To make those systems restart Code42 for Enterprise when they reboot, you need to create a restart script at /lib/systemd/system/crashplan.service.
- CentOS 7.14.04, April 2014
- Debian v8, April 2015
- Fedora v15, May 2011
- openSUSE 12.2, Sept. 2012
- Red Hat Enterprise Linux (RHEL) 7.0, June 2014
- SUSE Linux Enterprise Server v12, Oct. 2014
- Ubuntu 15.04, April 2015
For details see this Wikipedia article on systemd.
Non-compliant init.d script
In addition, some Linux systems that use init.d scripts, or both systemd and init.d, require compliance with a standard called Linux Standard Base (LSB). To meet that standard, you need to add some header information to the file /etc/init.d/crashplan.
- Red Hat Enterprise Linux (RHEL)
Diagnose and solve
Code42 for Enterprise may fail to restart after its Linux host reboots for either or both of the causes described above. Follow the instructions below to:
- Determine whether your Linux host uses systemd.
If it does, install the systemd script, then reboot the Linux host.
If Code42 for Enterprise restarts, the problem is solved. You are finished.
- Determine whether your Linux host requires LSB compliance.
If it does, edit the init.d script.
Understand the importance of taking those steps in the order presented. An LSB problem may not show up until after a systemd problem is solved and the system rebooted.
Diagnose and implement systemd
Determine whether your Linux host uses systemd
At the Linux command line, enter the command:
sudo stat /proc/1/exe | head -1
If the command returns a reference to a systemd directory, as in the example below, then your Linux distribution does use systemd to manage services. Proceed with Install the systemd script, immediately below.
>$ sudo stat /proc/1/exe | head -1 >$ File: '/proc/1/exe' -> '/usr/lib/systemd/systemd'
If your Linux distribution does not use systemd, skip ahead to Diagnose and implement LSB compliance.
Install the systemd script
- Copy the script below into a new file /lib/systemd/system/crashplan.service
[Unit] Description=Code42 Server After=network.target [Service] Type=forking PIDFile=/opt/proserver/proserver.pid WorkingDirectory=/opt/proserver ExecStart=/opt/proserver/bin/proserver start ExecStop=/opt/proserver/bin/proserver stop [Install] WantedBy=multi-user.target
- Edit the file paths in the script, if necessary.
The script below points to the default paths. Only a nonstandard installation needs changes to the script.
- At the Linux command line, enter two commands:
sudo systemctl daemon-reload
sudo systemctl enable crashplan.service
- Verify that the second command returns results that report creating the symlink:
Created symlink from /etc/systemd/system/multi-user.target.wants/crashplan.service to /lib/systemd/system/crashplan.service
Do not create the symlink manually; that may lead to problems of ownership and privileges.
- Restart Code42 for Enterprise with the new crashplan.service script. The command is:
sudo systemctl restart crashplan
- Reboot Linux with this command:
sudo shutdown -r now
- Verify that Code42 for Enterprise restarted with this command:
sudo systemctl status crashplan.service
If Code42 for Enterprise restarts, the problem is solved. Your work is done.
If Code42 for Enterprise does not restart, proceed with Diagnosing And Implementing LSB Compliance.
Diagnose and implement lsb compliance
Determine whether your Linux host requires lsb compliance
Search through your system logs using a command like the following:
sudo grep -r proserver /var/log/*
Look for a message like this one:
insserv: warning: script 'proserver' missing LSB tags and overrides
If you find such a message, edit the existing init.d script to comply with the LSB standard.
Edit init.d script to comply with lsb
- Open /etc/init.d/crashplan with a text editor.
- Copy the following 13 lines to the top of the file.
#!/bin/sh # Linux Standard Base comments ### BEGIN INIT INFO # Provides: proserver # Required-Start: $local_fs $network $remote_fs # Required-Stop: $local_fs $network $remote_fs # Should-Start: # Should-Stop: # Default-Start: 2 3 4 5 # Default-Stop: 0 1 6 # Short-Description: PROserver service # Description: PROserver service ### END INIT INFO
- Reboot the Linux host with this command:
sudo shutdown -r now
- Verify that the CrashPlan app restarted by connecting with a web browser, or with a command like the following:
If Code42 for Enterprise does not restart, contact our Customer Champions for Code42 for Enterprise support.