Modernbill Licensing - SoftDRM License Error

As we all know, as far as Modernbill is concerned from a support standpoint, we simply provide the Modernbill license token. That is the extent of our support. The customer is responsible for installing/maintaining their Modernbill installation.

<however>

I recently encountered an error in which a Modernbill installation complained that the license was expired. Here is the error:

Quote:
SoftDRM License Error [1x000195]
The license has expired. Please contact support.

1. Make sure that there is no firewall running that would be blocking www.modernsupport.com:80 traffic both to and from the server.

2. Generate the key, install it manually.

One thing to note is that the string that we provide customers with is actually called a License Token. It looks like:

Code:
69335a6245ee7906ef174fb99db163d0a35636bb

The actual License Key is much longer, it looks like:

Code:
-----BEGIN MBAPI LICENSE-----
oTuRMx7N/f7MmbMVebdSBkm5uodZvsAopXqHFGdQKKqc4TE3XOmjUxIGRkE3UgMblXVyDOm9+b3zExMc
5GAuz9IEYTqBO4nV9lf6kiue6RZWeZVY02FiqboRZmcf52bMmNI2eNgWbWqqcr2ysc0nqardSewdy8m7
ciSk7I1cfUoMOD%%aQwMzWlPL4v1LIQc9prLlr+CVeZffTzvJ4jTsYdQGg3ojlM/LIgcE9cJEhtbrwzG
2AX6z46JutdiQUhq/zQRDkiCYPrtqZ4Ty5+hQ+8SxVZHWmmEJ1oW3I/TpkFIN3FouogkcRkPwzH5OCtD
FbyAXAJVamOS4bn+IykWc6xifW/0KZwgk+eUK6WQ3MpCoHIsJGugW3J6C+eL+qz0wT+x8TbcYi8jM+0n
Lb4Xgw0J8vE5ZgFT1Kh6iNRQdc9NSOed4JGbYaCq0PjfKm/4FzK36kjM5zczVgiCymw5tnLNFxSLERoc
A+hVk4sO99adyLnTbmmUPZoIFElGmCau6/OVE/LfsX+uE5U6yiKeE93kkTH80dDcSqh+IGcq6VNEFh+6
y6Gs7MZh56k82jk+OGOwJCyZF4cZAPCgMhRXD4itJZmVAn6nMBD/neub2ATWoI343Sl3jAYz7d096L+1
JPdKyCVQVdCTRi4cWKMpgls3WDkgQXrpzzPWY6Vq
-----END MBAPI LICENSE-----
-----BEGIN MBAPI REGISTRY-----
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
wYMer2NziYMQnNRFakwphtwu4Zbo8y6tdtNNFUm%%aoch0Q==
-----END MBAPI REGISTRY-----

The key is normally stored in lib-modernbill/include/config/key.php

Here's one way to generate the key. Open a browser to https://domain.com/modernbill/app-modernbill-admin/install/. If the install directory does not exist (the installation tells you to delete it after its installed), you will need to grab the install files from the Modernbill site.

http://www.modernbill.com/billing-software/downloads.php

Extract only the install directory from that archive, modernbill/app-modernbill-admin/install/ into the site's modernbill/app-modernbill-admin directory.

Example:
Assuming that this is a cPanel server with Zend installed, and the modernbill install is in the site's public_html directory, this will extract just the install directory:

Code:
tar zxvf modernbill-5-zend-demo.tar.gz -C /home/<username>/public_html/ ./modernbill/app-modernbill-admin/install

Now, visit the modernbill install directory in a browser http://domain.com/modernbill/app-modernbill-admin/install

If its a previous installation, it should open up a license agreement, and at the bottom it will state:

Quote:
You appear to have an existing installation configured in this fileset.

The installer will take you through the upgrade process:

If you do not want to upgrade, but want to delete and overwrite your existing installation with a fresh, clean, new, non-upgrade installation, select the following checkboxes:

You probably do not want to select these checkboxes.

Don't put a check in either of the boxes. Make sure the 'Yes' radio button to agree to the license terms is selected, and hit 'Continue >>'. It should bring you to a screen in which it validates the license, and at the bottom it will display the license in light gray text.

Go ahead and copy that entire license key. You may need it if the next step fails to license the install. Hit 'Continue >>'. The next page will show Modernbill actually processing the upgrade. Hopefully, if all goes well you get the 'UPGRADE SUCCESSFUL Very Happy' message.

You will then need to remove (or simply rename) the install directory. Once that is done, visit the domain's Modernbill URL that will be listed at the bottom of the final page of the install. Again, it should be something like http://domain.com/modernbill/app-modernbill-admin/.

If you get the same 'SoftDRM License Error' error message instead of a login screen, then you will need to manually install the license key (not the token from the hardware object).

Here are the instructions, taken off the Modernbill KB:

1. Copy and paste the entire key into a new file called "newkey.php"

2. Place this file into the ModernBill directory in "lib-modernbill/include/config/" The full path (on a cPanel server) should look something like this: /home/<username>/public_html/modernbill/lib-modernbill/include/config/

3. Go to to the ModernBill admin login page (http://domain.com/modernbill/app-modernbill-admin). You should see an orange screen with instructions telling you to rename the file you uploaded from "newkey.php" to "key.php"

4. Rename the file you uploaded (newkey.php) to "key.php"

5. Refresh the page, you should see the login prompt.