Set up cPanel plugin

{info}

h3. Set Up the cPanel Plugin


1. In the Main menu, click *Policy*. Server Backup Manager displays the Policies window.


2. Click on the necessary Policy with Control Panel Instances added.

!19cp.png!

3. Click on the "Control Panels" tab in the "Policy Details" window.

!cp-tab.png!


4. Click on the "Download Plugin" icon, located in the right column.

!22cp.png!

5. Upload the file to the server.

6. Extract the file using the following command:

{code}tar -vzxf r1soft-cpanel-plugin-1.1.tar.gz{code}

!tar.png|border=1!

7. Inside the archive, there is a "README" file with directions on how to set it up.

!ls-al.png|border=1!

8. Open the {{r1redirect.php}} file in your favorite Linux text editor (vi, emacs, pico, or mcedit).

!php.png|border=1!

9. Locate the line that contains the following string:

{code}$CDP_SERVER_URL = "..."{code}

Replace the URL with the URL of your Backup Manager (for example, [http://10.230.200.38]).

!url.png|border=1!

10. Locate the line that contains the following text:

{code}$CONTROL_PANEL_ID = "..."{code}
\\

Replace the ID with the ID of your Control Panel Instance (for example, 8e367b22-0ce5-481c-98ad-2667d50cf48c).
{info:title=Tip}The Control Panel Instance ID is located in the "Control panel instance Id" column.

!23cp.png!
{info}
!id.png|border=1!

11. Copy the {{r1redirect.php}} file to your cPanel theme folder(s). For example:

{code}cp r1redirect.php /usr/local/cpanel/base/frontend/default/{code}

12. Run the following command to integrate the plugin with cPanel:

{code}/usr/local/cpanel/bin/register_cpanelplugin r1soft-cdp.cpanelplugin{code}

13. The Backup Manager link should now appear inside of cPanel.

!cp-icon.png!\\

h3. Set Up the cPanel Plugin using the Paper Lantern Theme

Follow the instructions below to install the cPanel plugin for Paper Lantern (version 11.44 or higher). This will provide a link inside of cPanel so that you can access your SBM backups.

{info:title=Note}
Installing this plugin in a non-Paper Lantern theme or cPanel version earlier than 11.44 will result in unexpected behavior and may not function properly.
{info}
1. To download the SBM Paper Lantern plugin from the SBM web interface, follow steps 1 through 5 in the previous procedure .

To download the Paper Lantern plugin directly, access the following address: _https://<SBM IP>/cpplugins/r1soft-cpanel-plugin-2.0.tar.gz_

2. Extract the cPanel plugin archive using the following command:
{code}tar -xzf r1soft-cpanel-plugin-2.0.tar.gz{code}
3. Open the file *r1soft-cpanel-plugin-2.0/r1redirect.php* in a text editor.

For example:
{code}vi r1soft-cpanel-plugin-2.0/r1redirect.php{code}

4. Locate the line that contains the following text:
{code}$SBM_URL = "<URL>"{code}
Replace <URL> with the URL of your CDP server, such as _[http://127.0.0.1\_|http://127.0.0.1_] .


5. Locate the line that contains the following text:

{code}$CONTROL_PANEL_ID = "<ID>"{code}
Replace <ID> with the ID of your control panel instance, such as _c1568882-3597-4931-84bb-d591eceb63f8_.

6. Copy the file *r1soft-cpanel-plugin-2.0/r1redirect.php* into your cPanel Paper Lantern Theme folder.

For example:
{code}cp r1soft-cpanel-plugin-2.0/r1redirect.php /usr/local/cpanel/base/frontend/paper_lantern/{code}
7. Install the cPanel plugin into the Paper Lantern theme.
{code}/usr/local/cpanel/scripts/install_plugin r1soft-cpanel-plugin-2.0 --theme paper_lantern{code}
The *R1Soft Restore Backups* link should now appear in cPanel using the Paper Lantern theme.{excerpt:hidden=true}Instructions on how to use the cPanel plugin.{excerpt}