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 
' 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.