The swpanel-rpc software

The swpanel-rpc software package is the API responsible for communicating and synchronizing the actions performed in SWPanel with your Cloud server.

When you perform an action in SWPanel, it will make a remote procedure call (RPC) to your Cloud, requesting the swpanel-rpc program to execute the action.

Installation

To proceed with the installation of swpanel-rpc, we will first add the repository by executing the following commands:

cat >> /etc/apt/sources.list <<EOF
# SWPanel XML RPC
deb http://packages.swhosting.com/serveisweb stable non-free
EOF

We download the public key:

wget -O - http://packages.swhosting.com/serveisweb/swhosting.gpg.key|apt-key add -

Finally, we install:

apt-get install swpanel-rpc

It will show the list of packages to install; press the letter 'y' and 'Enter'.

All servers with an SWPanel license deployed by SWHosting already have this package installed by default.

Update

If at any point we need to update this package, we will execute the following commands:

apt-get update
apt-get install swpanel-rpc

Or if you prefer, you can update all packages:

apt-get update
apt-get upgrade

Caution, this operation will update all packages on your system. Proceed only if you know what you are doing...

Structure

The package generates two directories:

• Executables: /usr/local/SWPanelRPC/
• Log and RPC configuration: /etc/swpanel-rpc/

Configuration and verification

The following configuration files are available:

• RPC Service: /etc/swpanel-rpc/swpanelrpc.yml

  • In this same directory, you will find a sample configuration file: swpanelrpc.yml.sample

• Log configuration: /etc/swpanel-rpc/log4perl.conf

• You can verify that everything is correct by running the script

/usr/local/SWPanelRPC/sbin/test.pl

If there were any error, it would appear.

IMPORTANT: To edit the configuration files, use spaces and not tabs.

Troubleshooting

• I have modified the configuration, but it is not applied.

  • If the configuration made in the file /etc/swpanel-rpc/swpanelrpc.yml is not applied, check that there is no other swpanelrpc.yml file in /usr/local/SWPanelRPC/. If so, delete it.

• I run the test and errors appear.

  • Check that the MySQL / MariaDB database engine is not stopped

  /etc/init.d/mysql status
  

  • It is possible that you have changed the password for the 'root' or 'debian-sys-maint' user at some point and this change has not been reflected in the 'swpanelrpc.yml' configuration file.

  Remember that you can request the intervention of the Systems Engineering Area by opening a ticket for technical action.