User Tools

Site Tools



Getting display but with no wording/text in the Client front end

If you are not using the default english language. Make sure you had make a copy of the lang/english.php to the language you are using. For example, if you are using Chinese then copy lang/english.php → lang/chinese.php

Things to check when the module is not connecting to the remote server

If your module is having trouble connecting to the remote server, here is a checklist for you to verify everything is setup correctly

  1. Click on the Connection Tester on the Server Listing in the Admin Backend. This will reveal whether your WHMCS server can make a http/https connection to your remote server's hostname. To test this on your browser, you should be able to goto http://yourhostname/CSFUnblockremote.php, if it display a white page. Then the remote files are installed properly. If you are getting a 404, then the files are missing in the document root. If you are getting 500 then the permission and ownership is most likely incorrect.
  2. Make sure the remote server module files are in the document root for the hostname of your remote server. For example, with cPanel/DA servers the default document root is /var/www/html. So perform a ls -lah /var/www/html and see if the remote server module files had been installed to that path correctly if using the auto installer.
  3. Check if there is any PHP error_log in the document root and the directory above it. In a cPanel/DA server, it would be /var/www/ or /var/www/html
  4. Check if the remote server have the proper ioncube loader installed for the PHP. For servers with multiple PHP installed check which PHP binary is being run when the remote server file is being run and during the cronjob
  5. Is the cronjob setup for on the remote server. The cronjob is essential as it will self heal any permission or ownership change. Also make sure the cronjob is running using root

Remote server passes the connection test but blank rules

If the remote server's Web Address is set to use https, try set it back to http.

Module stop connecting to remote server

There are numerous factors on why the connection stop working. Here are a few things to check.

  • The module allows for a 15 minutes padding between server's time. So make sure the time between servers are in sync to the actual time
  • The remote server isn't blocking the IP of the WHMCS server
  • The module files on the remote server is accessible. Check the httpd logs and see if CSFUnblockremote.php is being hit by the WHMCS module
  • The ioncube loader updated during a update. Make sure the loader is able to decode the remote server files

Dealing with Multiple PHP server environments

The module auto installer will install the cronjob using the native PHP (/usr/bin/php). There are few things you need to watch out for when you have multiple PHP installed on a system

  1. The PHP being run in the web root have ioncube 10 enabled
  2. The cronjob being run have ioncube 10 enabled

For the cronjob, you can make any necessary changes to the PHP binary you desire to run as long as ioncube 10 is included.

IP isnt being removed from IPtables even though the IP removal was success via module

Try running the following command on the remote server

perl /etc/csf/ -r

and if you get result similar to

Can't locate YAML/ in @INC (@INC contains: /usr/local/csf/lib /usr/local/cpanel /usr/local/lib64/perl5 /usr/local/share/perl5 /usr/lib64/perl5/vendor_perl /usr/share/perl5/vendor_perl /usr/lib64/perl5 /usr/share/perl5 .) at /usr/local/csf/lib/ConfigServer/ line 41.
Compilation failed in require at /etc/csf/ line 202.

then you just need to run the following command to fix the missing dependency.

cpan YAML::Tiny

If you don't get the error when running the first command, then make sure there is a CRONJOB installed on the remote server.

whmcs-csfunblockerv4troubleshooting.txt · Last modified: 2020/02/28 08:47 by wiki