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

The instructions assume that you are using cPanel to upload files and manage database. However, you can use any other tool that you might be using currently like: FTP, SSH, File Manager, phpMyAdmin or any other software that helps you upload files to your server, and manage your database. 

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
If you use any other name for folder, you will need to make several file changes. Please check here. 

 

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 allows to unzip on the server, or if you are using FTP, you need to 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

If you face any issues, please check this article.

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: [e-mail]
Password: admin

 

Step 13: Creating a Manager

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

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

PS: Please note that "Manager" was earlier named as "User" and hence you might find both words used inter-changeably at some places. 

 

Step 14: License Settings

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

If you see an error, please make sure:
i. You are using the license key for GrassBlade LRS and not GrassBlade xAPI Companion
ii. cURL is installed and enabled for PHP.
iii. If, you are using the LRS on localhost, or on additional test site, please check this article. 

Step 15: Generating Basic AuthToken

On the Manager Edit page for this new manager. 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