Visit the following link to install LL on CentOS, Fedora, Ubuntu, and Debian OS
http://docs.learninglocker.net/guides-installing/
Mac OS is not supported in the installation process specified above.
You can install Learning Locker in Mac OSX by custom installation.
Steps to Install LL in Mac OSX:
1. Clone the repo from learning locker git repo
$ git clone https://github.com/LearningLocker/learninglocker.git
Enter into the directory and install the requirements:
$ yarn install
You can be built 5 distinct services with this codebase.
2. Install services
If you want to install all services on the same machine, you can use the following one command:
$ yarn build-all
Install Services separately if you want to install each service in different servers
Install the UI Server
$ yarn build-ui-server
Install the UI Client
$ yarn build-ui-client
Install the API Server
$ yarn build-api-server
Install the Worker
$ yarn build-worker-server
Install CLI
$ yarn build-cli-server
Note: Copy the .env.example into a new .env file and edit as required
RUNNING THE SERVICES VIA PM2
Install pm2 , if you have not yet installed
$ npm i -g pm2
To start API, Scheduler, UI, Worker services, navigate to the LL working directory and run:
$ pm2 start pm2/all.json
INSTALLING THE XAPI SERVICE
Step 1: Clone the repo
$ git clone https://github.com/LearningLocker/xapi-service.git
Step 2: Enter into the directory and install the requirements and build
$ yarn install
$ yarn build
Note: Copy the .env.example into a new .env file and edit as required
To start the xAPI service, navigate to the xAPI Service working directory and run:
$ pm2 start pm2/xapi.json
You can check the service status:
$ pm2 status
$ pm2 restart all # restart all services
$ pm2 logs # view logs
Launch the UI:
http://localhost:3310/login, note that I have change the UI port in .env to 3310, as other services running in default port
Now you have to create User for logging in. Lets create an Admin User by the following command.
$ node cli/dist/server createSiteAdmin [email] [organisation] [password]
In order to use this command you have to install the CLI server for LL, that I already mentioned in the installation steps.
An Admin Example
$ node cli/dist/server createSiteAdmin "abhilash.a@comakeit.com" "CoMakeIT" “myPassword”
You can run the migrations by the following command if any pending migrations exists
$ node cli/dist/server migrateMongo
Now try to Login with the credentials.
Ooops… there is an issue, and we can’t login
After doing some research I found the issue. We need to add a secret key base to our Application to work with JWT tokens.
Open .env file and find:
# Unique string used for hashing
# Recommended length, 256 bits
APP_SECRET=
Create a 256 bit length hash key and give as a value. As I am a Rails developer, It is easy for me to create one by going into any my Rails project and type
$ rake secret
I get One! 🙂
Or you can use some online applications like: https://randomkeygen.com/
And do:
$ pm2 restart all
from LL project folder
Try to sign in again
Wohh, Its done. Great. Now you can try some bit of dashboard items like Graphs etc. Go on.
