|
 |
 |
|
|
|
The demonstration SDK downloaded at this site contains a virtual machine that shows a popup window at startup and that also has a time limit of 80 hours. When you plan to do the installation of your software at your customer, you will have to purchase the release version of the virtual machines and of Litebase. The whole process is very simple and was designed to reduce the chances of error.
After the purchase, when you will select the products (just TotalCross or TotalCross+Litebase) and the number of licenses, the company will receive a KEY. This key will have to be placed in the program, in a class that will be instantiated by the virtual machine in its initialization. The activation will occur the first time that your program runs: the company key and the device's serial number are sent to our server, and an activation file is returned to the device. This is a summary of the whole process:
- The customer purchase the products and the licenses, and receive a key for the company.
- The key is then passed as parameter (option
/r) to the deploy application, so it will be included in the TCZ file.
- The customer comes back to this site and downloads a new set of virtual machines, named TotalCross VMS and Litebase VMS. This virtual machine does not show popup messages neither have time limits for usage. There's no need to hard reset the device to install them, just overwrite the old vms with these ones.
- The first time that the customer's program is executed on the device, the virtual machine will read the company's key and the device's serial number, then contact our server to validate both and generate the activation file. The server will then subtract a license from the amount that the customer purchased. Attention: if you try to execute the activation vm in an EMULATOR, you will have a credit discounted! So, only execute DEMO vms on emulators.
Next we will answer some common questions:
- The activation process requires that the port 80 at url www.superwaba.net is open in the firewall, because is the port that we use to connect to the activation webservice.
- If the device is hard-reset, will I have to buy a new license? No. In this case, there are two possibilities:
- If a backup of the device was previously made, then the activation file was also copied. In this case, when the files are restored, the activation file will be copied back to the device, and a new activation will not be necessary.
- If the activation file was lost, when the virtual machine contact our server, the server will identify that this device was already activated, and will only send a new activation file to the device, and will not decrease the number of available licenses.
- Can the activation file be used in another device? No, the activation file, which can easily be located in the application's directory (tcsuc.pdb), is associated with a single device through the serial number or IMEI. Copying it to a different device will be useless.
- What are the ways to generate the activation file? There are three ways:
- Directly at the device, which requires that the device have a direct connection to the Internet.
- Uploading the TCREQ.PDB file. After the login at the site, you will see an option "Manual activation of the VM". Go to this page to see more instructions
- Using a bridge to request a new activation file. It is possible that the customer's server contact our server directly passing the TCREQ.PDB file, and receive as its response the activation file. This approach is especially useful for customers that have an inventory of devices and also a way to remotely deploy the application with the virtual machine and libraries. If you're interested in this approach, contact us for more information.
- How to activate devices that are not connected with the Internet? There are two ways:
- Your customer's desktop computer is connected to the Internet. In this case, you can use a conduit that will read the device's serial number, and will send it to our server and will create the activation file.
- Otherwise, if there are no Internet connections available, you will have to provide him the activation file generated using the process described in the previous item.
- The device has broken. Will I have to waste a new license for the device that will replace the old one? Yes. However, your company can adopt a different kind of activation process. The usual process only activates the virtual machine the first time it is used on the device. As an alternative, the virtual machine will do the activation once every week. If the activation is unable to complete, the virtual machine will halt immediately, and your program will exit. If the device breaks, you will be able to indicate that in our web interface and a new license will be added to the amount you have available. If the old device tries to activate again (after a week), it will be rejected and the program will not be executed. You can enable the device again at any time, and it will consume a new license if the device tries to activate again. Note: to use this alternative approach, your company will have to contact us in advance. And it only works on devices that have Internet connection all the time.
- I have thousands of devices and i'm not willing to use this activation process. Is there an alternative? If your company has another company that audits and controls the devices that are currently being used, it is possible to bypass the activation process. In this situation, your company will receive a virtual machine that will allow it to run without requiring the activation. This option is valid only for more than 10000 licenses, and we will sign a contract that will allow us to have access to the number of devices at any time we want, through the audit company.
- If the first activation fails, what happens? The virtual machine will indicate that a failure occurred and will exit. The customer's program will not be able to run unless the activation completes successfully.
|
|
|
