Competency and Skills Service -- Competency Management
Purpose of this Document
This document is intended to act as a technical guide to the installation of CaSS.
This installation of CaSS will provide several components that operate to provide a working system. It is composed of:
- The CaSS Repository, a Java application that runs in a Servlet Container, such as Tomcat.
- CaSS Embeddable Apps, a set of iframeable applications for branded web applications.
- CaSS Adapters, an adapter that interprets xAPI statements and asserts competence, and an adapter that synchronizes competencies and frameworks to and from Moodle.
wget https://raw.githubusercontent.com/cassproject/CaSS/master/scripts/cassInstall.sh chmod +x cassInstall.sh sudo ./cassInstall.sh
During the installation, you will be asked to select a version to install. Versions are listed at the top of this document.
Docker images for standalone instances (based on Ubuntu) and distributed/scalable instances (based on Alpine Linux) can be found at:
To support open linked data, it is important that the objects created in CaSS have public, reliable URLs. For this:
- Assign this server a domain name.
- Enable HTTPS.
- (Optional) Use a reverse proxy to control the endpoint closely.
After cloning this repository (ensure you use git clone with --recurse-submodules!), you can run CaSS locally.
Dependencies: Docker (will pull and run elasticsearch on port 9200)
Getting things up and running
git clone --recurse-submodules -b <branch> https://github.com/cassproject/CASS- Get the code.
npm i- Install dependencies.
npm run dev- Starts server, restarts server on-save.
In a separate command line, if you want unit tests:
npm run automocha- Runs both cass-npm and cass unit tests, runs them again on-save.
npm run automochafast- Runs cass unit tests, runs them again on-save.
npm run mocha- Runs cass-npm and cass unit tests.
npm run mochafast- Runs cass unit tests.
Will be deposited in
npm run docs
Running in myriad environments (requires Docker)
Where flavors are: ubuntu16, ubuntu18, ubuntu20, ubuntu18:13to15, standaloneWindows, standalone, testReplication
npm run buildRun:<flavor>- Wipes previous test container, builds and starts flavor container.
npm run buildRun:kill- Stops the running container.
Running it like it's in prod
npm run run:cassbase- Starts PM2 on localhost:8080/cass (used by cassInstall.sh)
npm run run:standalone- Starts PM2 on localhost/ (used by Docker installs)
npm run run- Starts PM2 on localhost:8080/
npm run logs- Tails logs.
npm run stop- Stops all PM2 services.
To get the process to restart when your linux machine restarts, run
npm run pm2startup, run the command the process tells you to, and run
npm run pm2save. For Windows, an additional library is needed to configure this.
A note on Elasticsearch and 1.5
Due to the performance improvements in the 1.5 version of CaSS, we highly recommend using Elasticsearch 7 with it as it's better configured to handle the load than previous versions.
- Review dependencies, autocomplete version numbers
- Increment version number in package.json
- Increment elasticsearch version number to latest minor/revision in docker/standalone/DockerFile (https://hub.docker.com/_/elasticsearch)
npm run testWithCoverage
- In another command window,
npm run test:mocha- Must not fail any tests.
- In the command window running testWithCoverage,
ctrl+c. Record the output of the code coverage for the tests in codeCoverage.md.
- Update src/main/webapp to point at the appropriate gh-pages commit.
- Update CHANGELOG.md
- Update README.md
- Commit with release notes.
- Tag commit with version number.