Error messages when running protected scripts

Top  Previous  Next

This section includes descriptions of the error messages that may appear when running protected scripts.  They are not in any particular order, but we would suggest that you take a look at this section before you contact us regarding any support matter.

 

 

Ruby script '...' is protected by RubyEncoder and requires the RubyEncoder loader. Please visit the http://www.rubyencoder.com/loaders/ RubyEncoder site to download the required loader and unpack it into '.../rgloader/' directory to run this protected script. (RuntimeError)

 

RubyEncoder Loaders are not installed or have been installed in the wrong directory or the script does not have enough permissions to access the rgloader/ directoryor files in it. To run protected scripts on the target machine you need to install the RubyEncoder Loaders to the rgloader/ directory within the protected script directory. If your project consists of multiple directories with protected scripts in them you may install the rgloader/ directory into the project's  root - protected scripts will be able to find the loaders there.

 

 

The RubyEncoder loader is not installed. Please visit the http://www.rubyencoder.com/loaders/ RubyEncoder site to download the required loader for '...your OS name...' and unpack it into '.../rgloader' directory to run this protected script.

in `require': no such file to load -- ... (LoadError)

 

The protected script was able to locate the rgloader/ directory and run the loader.rb helper script from it, however the loader required for your platform was not found. Please check if your platform is supported and install an appropriate loader file to the rgloader/ directory.

 

 

RubyEncoder Loader - This script is not licensed to run on this machine or it is running out of web server environment. Run this script in web server environment. Please contact the script author about this problem. Error code [01]

 

The protected script was encoded with the --ip locking option and was bound to some IP address(es). When the script is run on the web server from the other IP address the above error message appears. Check the IP address of the machine running the script. Check the script is running in a web server environment and the server IP address is available as an environment variable for the script. See script locking options section in this manual for details.

 

 

RubyEncoder Loader - This script is not licensed to run on this machine or it is running out of web server environment. Run this script in web server environment. Please contact the script author about this problem. Error code [02]

 

The protected script was encoded with a --domain locking option and was bound to some domain name(s). When the script is about run on the web server from the other domain the above error message appears. Check the domain name in the URL accessing the script. Check the script is running in a web server environment and that the server domain name is available as an environment variable for the script. See script locking options section in this manual for details.

 

 

RubyEncoder Loader - This script is not licensed to run on this machine. Please contact the script author about this problem. Error code  [03]

 

The protected script was encoded with a --mac locking option and was bound to some LAN hardware MAC address(es). When the script is about run on a machine running a different MAC address the above error message appears - MAC address(es) specified for the script during encoding do not match any of MAC addresses of the target machine. Check the MAC address(es) on the machine running the script. We suggest to use "ifconfig -a" command for it. Execute it in from the command line on the target machine to list all the available network interfaces. See script locking options section in this manual for details.

 

 

RubyEncoder Loader - This script is not licensed to run on this machine. Please contact the script author about this problem. Error code  [04]

 

The same as above but the problem is related to machine ID locking and running the script from the machine which is not allowed.

 

 

RubyEncoder Loader - This script is not licensed to run on this machine. Please contact the script author about this problem. Error code  [05]

 

The same as above but the problem is related to remote verification URL locking for CLI scripts.

 

 

RubyEncoder Loader - A license file required to run this protected script is invalid. Contact the script author for getting a license file. Error code [06]

 

The protected script was encoded with an --external locking option and is bound to the external license file. That license file is required to run the protected script. The license file has been found but it failed validation. Possibly it was accidentally changed. Install the correct license file for this project or generate a new license file with the same Project ID and Project Key values that were used for encoding the script. Refer to the script locking options section in this user manual for details.

 

 

RubyEncoder Loader - This script does not support version ... of Ruby. Please contact the script author about this problem. Error code [07]

 

RubyEncoder supports encoding for multiple versions of Ruby. You need to use the --ruby option for this in the rubyencoder command. The above message says that the script was not encoded for the version of Ruby currently running the script. This may happen, for example if you encode the script for Ruby 1.8 (--ruby 1.8 option) and try to run it under Ruby 1.9. Make sure the script is encoded for the version of Ruby on your target server and that it is compatible with that version of Ruby (otherwise you will get an error message during encoding). Please note, if you do not specify --ruby option in rubyencoder command, your scripts will be encoded only for Ruby 1.8.x (which is the latest stable version at the moment of writing this manual).

 

 

RubyEncoder Loader - This script has expired. Please contact the script author about this problem. Error code [09]

 

The protected script was encoded with an expiration date set for the script or within the external license file. The above message says that the period of using the script has expired and you cannot use this script anymore.

 

 

RubyEncoder Loader - Script ... header is broken. The encoded file has been modified. Install the original unmodified file or contact the script author for getting the original file. Error code [10]

 

RubyEncoder Loader - Script ... is broken. The encoded file has been modified. Install the original unmodified file or contact the script author for getting the original file. Error code [11]

 

RubyEncoder Loader - Script ... loader checksum error. The encoded file has been modified. Install the original unmodified file or contact the script author for getting the original file. Error code [17]

 

RubyEncoder Loader - Decompression error status .... The encoded file has been modified. Install the original unmodified file or contact the script author for getting the original file. Error code [18]

 

The RubyEncoder Loader performs a number of validation actions for the protected script before it runs the script. The above messages says that some validation has failed. It may happen because the script has been changed, possibly accidentally. Any changes to the protected script are restricted for security reasons. It is not allowed to make changes to the protected script. Do not change the protected script, install original file or re-encode the script again. Unprotected areas of the script (shell command, loader code, your custom header code or custom error code) are still protected with CRC and should not be changed either. Different messages above indicate different validation stages that the loader performs before running the protected script.

 

If you need to change or update a protected Ruby script, change it and re-encode.

 

 

RubyEncoder Loader - Script ... checksum error. The encoded file has been modified. If this script requires a license file to run this error may be caused by an invalid license file. Install the original unmodified file or contact the script author for getting the original file or license file. Error code [12]

 

This error message may be caused by the same reasons as the error messages above. Additionally this error may happen when the protected script had been locked to an external license file but the wrong license file was installed on the target machine. I.e. the license file was found by name but it is incorrect, generated for a different project or is broken. Therefore decryption of the protected script bytecode has failed. It is important to use the same Project ID and Project Key values for the license file that were used for encoding the script. Refer to the script locking options section in this user manual for details. Do not change the protected script or a license file - install the original file or re-encode the script again. If an external license file is used - install correct license file for this project or generate a new license file with the same Project ID and Project Key values that were used for encoding the script.  

 

 

RubyEncoder Loader - This script requires ... license file to run. Contact the script author for getting a license file. Error code [13]

 

Protected script was encoded with --external locking option and is bound to an external license file. That license file is required to run the protected script on the target machine. Name of the license file should match the name specified during encoding. Use RubyEncoder License Generator to create a license file and Install it on a target machine into the script's directory or any parent directory. If the license file is already there - check if the script has enough permissions to read the license file.  It is important to use the same Project ID and Project Key values for the license file that were used for encoding the script. Refer to using  scriptlicense generator section in this user manual for details.

 

 

RubyEncoder Loader - Evaluation loader has expired. This file has been encoded with evaluation version of RubyEncoder.  Please download and install http://www.rubyencoder.com/loaders/ latest loaders. Error code [14]

 

The RubyEncoder Loader you installed on a target machine is expired. This may happen only with the scripts encoded by the demo version of RubyEncoder.

Download and install updated loaders from http://www.rubyencoder.com/loaders/

 

 

RubyEncoder Loader - Incompatible loader version. The file has been encoded with a newer version of RubyEncoder. Please download and install http://www.rubyencoder.com/loaders/  latest loaders. Error code [19]

 

Your protected script was encoded with a newer version of RubyEncoder than the installed loader. Download and install updated loaders from http://www.rubyencoder.com/loaders/

 

 

RubyEncoder Loader - This script requires an internet connection to run. The file has been encoded to run only when an internet connection is available. Setup an internet connection. Error code [20]

 

The protected script was encoded with --time-server option or this option was specified for the external license file the script is bound to. The RubyEncoder Loader is trying to connect to the specified time server(s) using TIME or NTP protocols. If it is not possible to connect, for any reason (connection lost, error etc) the above error message will appear. Check that the time servers specified for the protected script or script license file exist. Use the RubyEncoder Information tool to know what time servers (or any other options) were specified during encoding. We suggest that you specify a number of available time servers so your script can run even if some time servers are temporary offline. See the script locking options section in this user manual for details.  

 

 

RubyEncoder Loader - Insufficient memory. Error code [FF]

 

This may happen if the RubyEncoder Loader failed to allocate some memory (RAM) using standard library functions. Check your system has enough free memory for running the protected script. RubyEncoder Loader does not need much free memory available, so this error usually never appears. Otherwise your system cannot work anyway without free memory available.

 

 

RubyEncoder Loader - Internal error: ...

 

Something wrong happens during the protected script execution. If you see this error please contact support to let us know about it support@rubyencoder.com.

 

 

Based on our experience in supporting RubyEncoder we must say that most protected scripts errors are caused by three factors: absence of loaders, modifications in the protected script or a script license or locking options used during encoding. We suggest that you use RubyEncoder Information Tool to know details about locking options for your scripts and script license files. See using information tool section in this user manual for details.