- This line was added.
- This line was removed.
- Formatting was changed.
From January 2018 all sites upgrading to Totara Learn v2.2 or greater will need to enter a registration code. Registering a site makes a connection between the site registration data and a specific invoiced subscription. This allows us to reconcile site registrations against valid Totara subscriptions which has several benefits:
- Allows us to look up code version and system information when providing support via the helpdesk, saving time.
- Allows us to validate genuine registrations so we can accurately identify all production sites.
This helpful so we can focus our time on developing for versions that are being actively used and offer better help.
Any sites that are upgraded to the January 2018 release or any subsequent release will include a registration form and be redirected to register immediately following the upgrade.
Registering your software is not an End User Licensing Agreement. Registration establishes the subscriber's right to receive Totara’s software update service, technical support of your product and access to associated customer services such as access to the Totara Academy and Community.
If you do not have your registration code or are experiencing problems, your Totara Partner will be able to help, or please contact [email protected].
Registering your site
Subscription registration codes are made available for a subscription as soon as the subscription is 'awaiting activation'. To obtain the registration code:
- Firstly you will need to obtain your registration code, this can be done in the following ways:
- By contacting your Totara Partner and requesting the code from them.
- If you are a direct subscriber then you will be given the code directly from Totara Learning.
- Next, as a site administratorSite Administrator, login to the site you want to register and click Site administration > Totara Registration.
- Select Type of site as Production and paste the registration code from into the text box (you should not need to adjust other settings).
- Click Save to finish and submit the form.
|Type of site|
The options are:
You will need to select Production as this indicates the site is live and currently being used by real users.
|The Production site type is the only one that needs a registration code.|
This is where you will need to paste the registration code obtained from your partner.
|This is entered only once.|
|Data last sent||This will display the date you last sent registration information, it will either be Never or the time of your last registration.||-|
|Registration information to be sent||This allows you to see a full list of data transmitted.||-|
Registering via config.php
Partners wishing to automate the registration process can register programmatically by specifying the following fields in the site's config.php file:
$CFG->sitetype = 'production'; // Options are 'production', 'qa', 'demo' or 'development'.
$CFG->registrationcode = 'xxxxxxxxxxxxxxxx'; // Unique 16 character long alphanumeric code.
Note the registration code must be provided for production sites and each site must have its own unique code.
We recommend developers working for partners include $CFG->sitetype = 'development'; in their default config.php file and any automated deployment code be updated to set the correct value for staging and test sites.
Frequently asked questions
What do I do if the site is not a live customer site?
For non-production sites such as development, QA or testing sites you can choose a different site type from the pulldown menu. Only the production site option requires the registration code to be entered. If you are a developer or managing deployments automatically we recommend you enter the appropriate $CFG->sitetype configuration setting in your config.php file.
What happens if a production site moves to a new URL?
If the URL changes you will need to repeat the registration process and re-enter the same code on the site. This is because it is common practice to clone sites by copying the database, and we don’t want the registration status of the cloned site being repeated for all copies.
How do I ensure registration can complete successfully?
Ensure that the cron is running on your site, and that your outgoing firewall rules allow the following requests:
- POST requests to https://register.totaralms.com/register/report.php
- POST requests to https://subscriptions.totara.community/register/report.php
You can also see Site registration troubleshooting advice in our policy documents section.
Is a new code generated at any stage (annually or with each upgrade deployment) or is the code only issued once?
The code doesn't change annually, it's one code per subscription, no matter how long the subscription lasts. However currently you do need a new registration code if you upgrade your subscription (e.g. change to a different level, including level change for the 1st Oct pricing change).
How is the number of users on a site calculated?
For the purposes of calculating a site's subscription level we calculate the number of users as the number of users who have logged in at least once in the last 12 months. This number is displayed on the Site Administration administration > Notifications page.
It is important to note that this value includes suspended or deleted users who logged in within the last year, even though they are no longer active. For that reason, if you have recently deleted lots of users it is possible that the value could exceed the current count of active users.
This method of calculating the user count reflects the number of users who have received value from the site - user's who have an account but have not logged in are not counted towards the total.
What data is sent during the registration process?
You can see what information is captured on the Registration data collected from Totara products page in this help documentation.
I've been asked to download registration details, what does that mean?
If you are having problems with using the automatic site registration then your Totara Partner might ask you to download the registration data as a file (in .ttr format).
If requested to do this then follow these steps:
- As a Site Administrator, login to the site you want to register and click Site administration > Totara registration.
- Click the Download button.
If you cannot see the Download button please contact your Partner to check that the Site type has been set.
Once downloaded you will have an encrypted file that can be sent to your Totara Partner and passed onto Totara Learning. The file will be encrypted with a key that only Totara Learning has access to. No one will be able to read the contents of the file without the key. The file produced contains the same data generated for automatic registration, which is the same as what's listed under Registration data to be sent (see the Registration data collected from Totara products page for more information on the information contained in the file).