Check that your PHP version and configuration is valid both for PHP Web & CLI.
In order to upgrade TRAX LRS from version 2.0.x, you need to install the last release of TRAX LRS
with a copy the
.env file from your previous installation.
The database schema must then be updated with the
php artisan migrate command.
Upgrading from versions older than 2.0.0 is not directly supported. However, you can install TRAX LRS 2.0.x as a new LRS and then migrate your xAPI statements with the LRS connector.
Assuming that you want to install TRAX LRS in a folder named traxlrs:
git clone https://github.com/trax-project/trax2-extended-lrs traxlrs cd traxlrs composer install
bootstrap/cache must be writable both by the webserver and the console user.
Assuming that the ownership has been properly set, you should be able to assign a
to the folders and subfolders and a
644 permission to the files.
Check this post for further details: https://laracasts.com/discuss/channels/laravel/proper-folder-permissions.
If you are not sure how to configure this, you can use the following commands FOR TESTING PURPOSE ONLY.
chmod -R 777 bootstrap/cache chmod -R 777 storage
For security reasons, only the
public folder should be accessible by the web server.
Create a virtual host and configure the document root to
Create an empty database with the
Then, at the root of the application folder, make a copy of the
.env and enter your database settings.
DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=traxlrs DB_USERNAME=root DB_PASSWORD=
DB_CONNECTION=pgsql DB_HOST=127.0.0.1 DB_PORT=5432 DB_DATABASE=traxlrs DB_USERNAME=postgres DB_PASSWORD=aaaaaa DB_SCHEMA=public
.env file, you must set the public URL of your TRAX LRS application :
php artisan key:generate php artisan migrate
You can now create an admin account with the following command. This will give your credentials to log into the application.
php artisan admin:create
Additional commands and options are documented in Users & Roles.
You should review all the configuration options of TRAX LRS before starting to use it. Please, refer to the configuration page to get more details.
TRAX LRS needs to perform some tasks on a regular basis. Please, refer to the CRON jobs page to get more details.
.env file, change settings from:
If you get this error during the
php artisan migrate command, check your version of MySQL or MariaDB.
Since TRAX LRS 2.0.2, MySQL versions older than 5.7.7 are not supported anymore.
MariaDB versions older than 10.3 are not supported.
TRAX LRS has a
/public/.htaccess file with some Apache directives.
When these directives are ignored by Apache, this leads to a 404 error.
In this case, check the
httpd.conf file of Apache and try to set the
AllowOverride option to
<Directory "path/to/laravel/project/public"> Allowoverride All </Directory>