english português


search
     
Downloads
  Documentation
  Changelogs
  Support
  Compatibility









Products / Activation Process

The SDK downloaded at this site contains a demo virtual machine that shows a popup window whenever it starts and has also a execution time limit of 80 hours. Before you deploy your software in a customer, you will have to purchase a license of the virtual machine and Litebase. The whole process is online (can be offline too) and very simple.

After the purchase confirmation, you will have to log in at our website click in the option "Check activation keys and credits" and get the activation KEY generated for your company. You must use this key every time you generate a deploy package. The VM activation will occur at the first time your program runs: the company key and the device's serial number are sent to our server, after that an activation file is returned to the device. Below a summary of the whole process:
  1. The customer purchase the products and the licenses, and receive a key for the company.
  2. The key is then passed as parameter (option /r) to the deploy application (tc.deploy), so it will be included in the TCZ file.
  3. The customer comes back to this website 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.
  4. 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" (SCREEN SHOT - if you don't see this screen, its because you're logged as contact and not as administrator). 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.
  • 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.


Copyright© 2002-2012 SuperWaba11 userssite map