Unit activation codes

Unit activation codes are a subscription-based system for managing your units. Units remain available in Wialon only while they have a valid activation code. This system provides better control over creating, deleting and deactivating units in your service accounts and simplifies billing sub-dealers and end users.

On this page you will find information on how to manage unit activation codes, covering the following topics:

• How to start using unit activation codes
• Code validity period
• Activating units with codes
• Sharing a code with a subordinate account
• Bulk sharing of unit activation codes with a subordinate account
• Unsharing a code from a subordinate account
• Reassigning a code to another unit
• Tracking code expiration
• Exporting activation codes
• Searching and filtering activation codes
• Sorting activation codes

To enable the activation of units by codes for your service, send a request to your Partner Success Manager and purchase the required number of codes. After this, the Activation codes item becomes available on the navigation panel in CMS Manager.

The feature of activating units by codes applies to all accounts within the service.

To manage codes in the Activation codes section (for example, to view, share, or unshare them), you must be the creator of the top account or of an account with dealer rights.

To assign a code to a specific unit, you must have the Manage activation codes access right to this unit.

The validity period of a code starts counting down after this code is assigned to a unit for the first time. The countdown continues even if the code is reassigned to another unit or is temporarily not in use. After the validity period expires, the unit with the assigned code is automatically deactivated. The validity period in days is displayed in the Activation codes section.

To keep the unit active, you must purchase and assign a new code when the previous one expires. The activation time is displayed in the Activation codes section. See Tracking code expiration.

If the feature of unit activation codes is enabled in the service, units can only be available in the monitoring system while a valid code is assigned to them. If a unit is created without a code or if its code has expired, the unit is automatically deactivated.

If a unit is deactivated in a service that uses the unit activation code system, the unit can’t be used in the monitoring system, but its properties can still be edited in CMS Manager.

You can assign unit activation codes in one of the following ways:

• from the “Activation codes” section
• from the unit properties

This method can be used by users that are creators of top accounts and accounts with dealer rights.

To assign a code to a unit from the Activation codes section, follow these steps:

1. In the CMS Manager navigation panel, select Activation codes. If this item is not available, see the requirements above.
   

2. In the row with the code you want to assign, start typing the unit name in the Unit column or select it from the list. If you are not a top account user, the list shows only the units to which you have the Manage activation codes access right.
   

If a valid code is successfully assigned to the unit, the unit becomes active and can be used in the system.

This method allows a user to activate a single unit by pasting a code directly into its properties. It is useful for users who don’t have dealer rights but need to activate a specific unit.

To assign an activation code from the unit properties, follow these steps:

1. Select Activation codes in the navigation panel in CMS Manager and copy the code you want to assign to a unit.
   

   If you are a user without dealer rights, obtain a valid code from your administrator or service provider.

2. In the monitoring system or CMS Manager, open the properties of the unit you want to activate.

3. Paste the code into the Activation code field. After that, the system checks if the code is valid and unassigned. If the check fails, you will see an error message.
   

4. Save the change.

If the code is successfully assigned to the unit, the unit becomes active and can be used in the system.

By default, unit activation codes are available only to users that are creators of top accounts. To allow users that are creators of other accounts to manage codes (for example, to view, share, or unshare them), follow these steps:

1. Make sure that the account to which you want to transfer the codes has dealer rights.
   

2. On the navigation panel of the top account, select Activation codes.

3. In the Shared with column, select the account whose user should manage the code. You can only select one account.

   You can share unit activation codes with any account below yours in the hierarchy, not just those directly beneath your account.

   

After this, the Activation codes item becomes available on the account navigation panel in CMS Manager. Now they can manage the shared code in the Activation code section: view it, assign it to a unit, reassign it to another unit, share the code with other subordinate accounts with dealer rights, and cancel these actions.

To share several activation codes with an account at once, follow these steps:

1. Follow steps 1–2 from the instructions above.
2. Select the codes you want to share. To select all codes, check the box in the top row.
   
3. Select the account for which the codes should be available. You can only select one account.

After that, the account creator can view and manage the shared codes in the Activation codes section in CMS Manager.

You can unshare a unit activation code that you have previously shared with a subordinate account.

To unshare a code manually, follow these steps:

1. In the navigation panel, select Activation codes.
2. Find the code you want to unshare and click on the name of the account it is currently shared with.
3. Click the icon .
   

After that, the code is removed from that account’s Activation codes section. However, if the user of that account has saved the code elsewhere (for example, copied it into a text file), they can still use it to activate a unit.

If a shared activation code has never been assigned to a unit, its validity period hasn’t started.

An activation code is automatically unshared from a subordinate account when it is shared with another account. One code can’t be shared with two accounts at the same time.

If, after assigning a code to a unit, this unit is no longer in use and should be deactivated, you can use its code for another unit. Keep in mind that in this case, the code validity period continues to count down. To reassign the code, follow these steps:

1. On the navigation panel, select Activation codes.

2. Find the code you want to reassign and click on the icon in its row.

   You can also access the unit properties directly from the monitoring system or CMS Manager.

   

3. In the unit properties, clear the Activation code field.
   

4. Save the changes.

5. Assign the free code to another unit you want to activate. You can do it from the other unit properties or from the “Activation codes” section.

As a result, the unit from which the code was removed is deactivated. The unit to which the code is assigned is activated and can be used in the system.

To prevent units from deactivation, you should replace the activation code with a new one when its validity period expires. To do this, track the expiration date in the following places of the interface:

• in the Expiration time column of the Activation codes section in CMS Manager;
  
• next to the Activation code field of the General tab in the unit properties;
  
• in the unit tooltip or worklist in the monitoring system (requires the Deactivation date option to be enabled in the user settings).
  

If the validity period of a code has expired, it continues to be displayed in the unit properties along with its expiration date. Deactivated units are available only for viewing in CMS Manager.

You can export the activation codes displayed in the Activation codes section to an Excel file for further analysis, record-keeping, or sharing with other users.

To export activation codes to Excel, follow these steps:

1. In the CMS Manager navigation panel, select Activation codes.
2. (Optional) Apply sorting or filters to display only the codes you want to export. The export will include only the rows currently visible in the table.
3. Click the button in the toolbar.
   

After clicking the button, an Excel file with activation codes is downloaded to your computer. The default file name follows the format: export_file_yyyy-mm-dd_hh-mm.xlsx, where yyyy-mm-dd_hh-mm is the current date and time.

The Activation codes section provides search and filter features to help you quickly find specific codes.

1. Use the Type dropdown to select which codes to display:
   • All: All activation codes available for your account.
   • Assigned: Codes currently assigned to units.
   • Not assigned: Codes not assigned to any unit.
     
2. In the Filter dropdown, select a field to search by:
   • Code: Activation code value.
   • Unit name: Unit to which the code is assigned.
   • Shared with: Account the code is shared with.
3. In the Text field, enter your search request related to the selected filter. For example, if you selected Unit name, enter the unit name or part of it.

The table updates automatically to show only the codes matching your criteria.

The search doesn’t support wildcard characters (such as * or ?). The system finds all entries containing the text you enter.

You can sort the Activation codes table by any column to organize the data according to your needs.

To sort the table, click on any column header.

The icon next to the column header indicates the sort order:

• Ascending (from A to Z or from 0 to 9).
• Descending (from Z to A or from 9 to 0).