GrassBlade LRS Installation

Please check and confirm that the server meets the system requirements at:

System Requirements 

NOTE: Important things to be careful of in case you get blank screen, or any errors during installation.

 

 

 

 

 

Some of the screenshots are for an older version of GrassBlade LRS, but the difference is only cosmetic.  

Step 1

Login to your cPanel account. And open the File Manager. If you are not using cPanel, use your favourite method to upload the files to your server.

 

Step 2

Go to the document/http root. The folder can be named public_html, htdocs, /var/www or anything else depending on your server and configuration.

 

 

Step 3

Create a folder named grassblade-lrs

 

 

Step 4

Go inside the grassblade-lrs folder and click on Upload to start the upload process.

 

Step 5

Click on Choose File and select the zipped grassblade-lrs-vX.X.X.zip file to upload. If your server download allow to unzip on the server, or if you are using FTP. Unzip the file on your desktop, and upload all the files.

 

Step 6

Wait till the file is uploaded and then go back to your File Manager.

 

Step 7

Click on Reload if the file doesn’t show yet.

 

Step 8

Click on the file name, and click on Extract to unzip the file.

 

Step 9

Make sure the folder is correct and click on Extract File(s).

Close the window after extraction is complete.

Press reload to see extracted files.

 

 

Step 10: Database Configuration


In your browser, go to: http://www.yourdomain.com/grassblade-lrs you will be redirected to http://www.yourdomain.com/grassblade-lrs/Configure/Database 

Enter your database details and click submit. Its preferred that you use the same database login details and prefix if you are planning to use the LRS with WordPress and GrassbBlade xAPI Companion plugin for Articulate. (see reference)

Using same database currently has only one advantage: If you are using Articulate, you can use the feature to import Translation which helps you see content name, slide name, questions and answers instead of odd url ids that Articulate sends. 

If you do not have a database, create a MySQL database by following these steps

1- Go to MySQL Data base wizard in your cpanel

2- Enter a name for your database

3- Create a username and password for database.

Choose all permissions in next step.

4- MySQL Database is created

Enter the details of your existing database or newly created MySQL database.

Click on Submit. (Please ignore if you see a bunch of error messages once) 

 

Step 11

Your database configuration file will be created automatically if php has write permission, or you will get a piece of code. Copy it and create a file with the content as instructed.

 

Step 12

You will see that several database tables are created. If you see a bunch of messages and errors, refresh the page and see if it disappears.

Installation is done, click on Login to continue logging in with default admin login:

Email: admin@nextsoftwaresolutions.com
Password: admin

 

 

Step 13: Creating a User

Change the admin credentials by going to Users > All Users and clicking on Edit.

Create a new user by going to Users > Add New. Enter the details and select the Role “user”. Click Submit to save.

 

Step 14: License Settings

You will see the License settings page, configure the license email and key from the email you have received.


 

Step 15: Generating Basic AuthToken

On the User Edit page for this new user. Click on “Add New Basic Auth

Step 16: Auth details for your xAPI Program

Copy the API User, API Password, and Endpoint URL and use it in your xAPI Program, LMS or Content. If you are using GrassBlade xAPI Companion for WordPress, you need to configure it in your GrassBlade Settings page on WordPress.

 

NOTE: Important things to be careful of in case you get blank screen, or any errors during installation.

 

 

 

 

 

Home | GrassBlade xAPI Companion | GrassBlade LRS

Have more questions? Submit a request

5 Comments

  • 0
    Avatar
    Kevin Walsh

    Step 12 failed for me with no error message. The page just refreshes and I do not get logged in with the default login credentials.

  • 0
    Avatar
    Pankaj Agrawal

    This happens if you use a host like WPEngine which uses caching. You will need to ask them to disable caching on grassblade-lrs folder. 

     

  • 0
    Avatar
    Kevin Walsh

    My server admin had turned off PHP session cookies because it interfered with Varnish's ability to serve pages. It works now but with Varnish disabled. I will try another caching method like W3 Total Cache plugin.

  • 0
    Avatar
    Wojtek

    I would suggest to document all of the required indexes that need to be applied to the tables in the DB.  The lack of these indexes becomes a problem when there are lots of statements. 

  • 0
    Avatar
    balayn stephane

    can anyone explain me what we have to put in

    configure --> integrations --> wordpress xAPI 

    i have put the adress of my wordpress site , the admin user of my wordpress site and its password but it says i have an error .

    Thank you for help

     

    Stephane

Please sign in to leave a comment.
Powered by Zendesk