Install GrassBlade LRS

Estimated reading time: 3 min

Follow these steps to install GrassBlade LRS on your own hosting platform.

Note: If you’re getting any error while installation, please read: GrassBlade Installation Error or you can alternatively order GrassBlade Installation service.

Requirements

This article assumes that you have:

  1. Downloaded the GrassBlade LRS zip file. Download Now
  2. Using hosting with cPanel (PHP/MySQL) or with some other File Manager.

You can use other tools for installation like FTP, SSH and FileZilla. Make sure your hosting meets the System Requirements

Uploading to your Server

Step 1:
Login to your cPanel account and open File Manager.

Step 2:
Go to the document/http root. The folder can be named public_htmlhtdocs/var/www or anything else depending on your server and configuration.

If you are not using cPanel, use your favourite method to upload the files to your server. If you are using cPanel, click on File Manager. Select your domain if you have multiple domains configured. 

Step 3:
In File Manager (public_html), create a new folder named grassblade-lrs

If you use any other name for the folder, you will need to make several file changes. Please check here.

Step 4:
Go to grassblade-lrs folder and click on Upload to start the upload process.

Step 5:
Click Browse and select the grassblade-lrs-vX.X.X.zip file you had downloaded in the first step to being uploaded.

Wait till the file is uploaded and then go back to your File Manager. Click on Reload if the file doesn’t show yet.

If you are using FTP, Filezilla, or any other tool that doesn’t support extraction of the zip file on the server, you will need to unzip the downloaded zip file and upload all the files here. Double-check that you are uploading the files inside “grassblade-lrs” folder. 

Extract File

Step 6:
Select your file and click Extract option.

Make sure the path points to the “grassblade-lrs” folder, and click Extract File(s) button.

When the process is completed, close the extraction window, and press the reload button to see the extracted files.

Database Configuration

If you’re facing any issues, please check this article.

Step 7:
In your browser, go to https://www.yourdomain.com/grassblade-lrs it will be redirected to https://www.yourdomain.com/grassblade-lrs/Configure/Database

On the database configuration page, enter the following information to connect GrassBlade LRS with the database.

  • Database Username
  • Database Password
  • Database Name
  • Database Table Prefix (Optional)

Enter your database details and click submit button to start the process.

Don’t have a database? Learn How to create new Database in cPanel?

It’s preferred that you use the same database login details and prefix if you are planning to use the LRS with WordPress and GrassBlade xAPI Companion plugin (see reference).

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

Step 8:
You will see a message showing, “Database configured and connected”.

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.

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

Your GrassBlade LRS is installed successfully.

Step 9:
Go to Dashboard or click the on the Logo, it will take to the login screen. Use default credentials to get started.

Email: admin@nextsoftwaresolutions.com
Password: admin

Step 10:
Go to Configure > License to verify your purchase. Enter your email (used for purchase) and LRS license key you recieved via email or check here.

If you see an error, please make sure:

  • You are using the license key for GrassBlade LRS and not GrassBlade xAPI Companion
  • cURL is installed and enabled for PHP.
  • Using on localhost, or on additional test site? See this.

Related Article: Where can I find my license key?

Creating a Manager

Step 11:
Make sure you change the default admin credentials by going to Managers > All Managers and clicking on Edit.

Create a new manager:

  1. Go to Managers > Add New.
  2. Enter the details and select the Role “user”.
  3. 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.

Generating xAPI Basic AuthToken

Step 13:
On the Manager edit page, click on “Add New Basic AuthToken” button.

Step 14:
You got the AuthToken credentials for your xAPI Program. You can use it in any application for xAPI.

  1. API User
  2. API Password
  3. Endpoint URL

Congratulations !! Your LRS is ready to record statements.

If you are using GrassBlade xAPI Companion for WordPress, you need to configure it in your GrassBlade Settings page on WordPress.

Note: If you’re getting any error while installation, please read: GrassBlade Installation Error or you can alternatively order GrassBlade Installation service.

We hope you got this information useful for this LRS configuration. For more latest product updates and information get in touch via Facebook and Twitter.

Was this article helpful?
Dislike 0 8 of 8 found this article helpful.

Leave a Reply

Your email address will not be published. Required fields are marked *