Adapt Learning Community: Authoring tool update requires new configs (16th March 2015)

Hi everybody,

We've just pushed out some major changes to the develop branch of the authoring tool. This contains numerous improvements which I'll detail below, but I'd like to draw attention to some essential configuration changes required if you wish to update an existing installation.

How to upgrade an existing installation

Open /config/config.json and add the following new keys:

Key	Value	Comments
outputPlugin	adapt	Leave this as 'adapt'
masterTenantID		Set the value to the _id value for the record in the MongoDB tenants collection
masterTenantName		Set this to the name value for the record in the MongoDB tenants collection

Personally I've found Robomongo to be a very useful application for working with MongoDB.

Here is the full change log:

Fixes for the following tickets:
AB-292 - Extensions against 'config' do not seem to save
AB-160 - Add poster images to projects
AB-302 - Inform user that required field is missing when adding new asset
AB-316 - Search does not work
AB-314 - Double scroll bar
AB-334 - Video asset thumbnails should be animated gifs
AB-318 - Display issue with tiles when there are many characters used for
the Course title

Also includes the following:
- Minor IE 9 fixes
- Added support for client-side configs
- Corrected 'Back to courses' button
- Added missing language strings
- Fixes around drag and drop, copy and paste
- Role permissions synced on a server restart
- Fix for asset manager filters
- General UI fixes
- Proper support for shared courses
- Poster images now available on courses
- Progress indicator on preview
- Re-factoring of build process
- Fixes with theme and menu selection to persist selection after new
  versions are installed
- Added support for _trackingId values
- Install updated
- Context menu issues fixed

Have just followed these instructions, and got up and running with no issues.

One thing to note: I also needed to run npm install as the package.json's changed slightly.

(I also did a grunt build to be safe - not sure if the front-end needs a rebuild or not).

Show parent | Reply

Thanks Tom. The grunt build also makes sense.

Show parent | Reply

Hi Brian,

So there are no changes required to be made the MongoDB when upgrading?

Cheers

Greg

Show parent | Reply

Hi Greg,

No, you can leave MongoDB alone. Any changes to the collections will be handled via schema updates which will automatically take effect when you restart the server.

Regards,

Brian

Show parent | Reply

Hi Brain,

I'm currently trying to use Robomongo remotely but I can't figure out how to connect to the mongodb. When I have Adapt installed with default settings what are the credentials for Robomongo to login with?

Database name is probably "adapt-tenant-master" or is it "test"?

The username and password I have no clue what they could/should be.

I have commented out the bind-ip in the mongod.conf file so I do see a green check mark at the first test "connected to...", but the second check in the test fails.

Hope you can help me out.

Thanks!

Joannes A. Rommers

Show parent | Reply

Got it working,

When following the basic explanation of installing the mongodb there is no user or admin created.
By creating an administrator in the admin database I was able to connect and see the adapt-tenant-master database.

This was rather a mongodb issue than an Adapt Authoring one.

Nice tool Robomongo btw Brain!

Sorry for misplacing this question.

Show parent | Reply

Glad you got it working, Joannes.

RoboMongo has been a huge time saver for the development team. I'd recommend it to any early adopters.

Show parent | Reply

outputPlugin	adapt	Leave this as 'adapt'
masterTenantID		Set the value to the _id value for the record in the MongoDB tenants collection
masterTenantName		Set this to the name value for the record in the MongoDB tenants collection

Hi all can someone help?

I have gone into config.json and typed :

"outputPlugin": adapt

"masterTenantID":

"masterTenantName":

but I have no idea what to put next to those last two?

Thank you

Helen

Show parent | Reply

Hi Helen,

To get the values for these fields, you need to query the mongo database. You can do this either using the mongo shell, or via a helper application such as Robomongo. I'd recommend the latter unless you're comortable using the mongo shell.

Using Robomongo, you need to navigate to the record for the master tenant using the left nav bar. It will be something like:

adapt-tenant-master -> Collections -> tenants -> [record] (it will likely be the only document there)

Once you have this, you can get the name, and the _id by right-clicking and selecting 'View Document'.

Note: for the id, you need to take the value between the double-quotes, not the whole thing (i.e. don't include ObjectId(....))

Show parent | Reply

Thank you so much Tom I have it now!!!

Show parent | Reply