Lab quick card
One card with the commands of a training lab, in the order a course uses them. Run them in the installation root, as the user who owns the files. Each line names the page that explains it. Print it for yourself and your helpers.
The card
EXPONENTIAL TRAINING LAB run in the installation root, not as root
CHECK THE MACHINE
php -v ; php -m PHP 8.0+ (Velocity included); intl, xsl, sqlite3, mbstring ...
composer --version ; git --version
GET THE CODE (a fixed release)
git tag -l 'v6.*' --sort=version:refname | tail -3
composer create-project se7enxweb/exponential:<tag> <dir> editor and admin courses
git clone https://github.com/se7enxweb/exponential.git <dir> developer courses
git switch -c training <tag> ; composer install
INSTALL (SQLite, one command)
php bin/php/console exp:install --print --url=http://127.0.0.1:8087
php bin/php/console exp:install --dry-run --url=http://127.0.0.1:8087
php bin/php/console exp:install --apply --url=http://127.0.0.1:8087 [--package=sevenx_multisite_clean]
cat var/log/initial-admin-password then sign in, change it, and: rm var/log/initial-admin-password
SERVE
php bin/php/console exp:velocity start | status | stop
php bin/php/console exp:velocity config set --apply PHPServerSettings Port 8091 a second site on one machine
WHEN SOMETHING BREAKS
tail -n 50 var/log/error.log the reference ERR-... of an error page is in here
php bin/php/maintenance.php status | off
php bin/php/ezcache.php --clear-tag=template | --clear-tag=ini | --clear-all
php bin/php/resetuserpassword.php -u admin -g --allow-root-user (as root)
RESET FOR THE NEXT GROUP
exp:velocity stop ; cp -a <golden>/storage/. var/storage/ ; php bin/php/ezcache.php --clear-all
or: pwd (check!) ; exp:install --dry-run ... ; exp:install --force ...
AFTER THE COURSE
stop servers; remove learner accounts on shared sites; delete lab directories you createdWhere each command is explained
| Commands | Page |
|---|---|
| Checking a machine | Lesson 2.1: Requirements for a training machine, Requirements |
| Getting the code | Lesson 2.2: Getting the code for a class, Getting the code |
| Installing | Lesson 2.3: One installation per learner, The console install |
| Serving | Lesson 2.4: Serving the lab sites, Serving the site |
| Fixing | Lesson 4.4: Troubleshooting in class, Troubleshooting |
| Resetting | Lesson 2.6: Resetting the lab |
| Cleaning up | Lesson 4.5: Security and privacy in class |
Warning
exp:install --force replaces the database and the settings of the installation it runs in. Run it only in a
directory you created for training, and check pwd first.
Related pages
- Trainers: start here
- Trainer toolkit
- Free documentation: this page is free to copy, translate and improve under the GNU FDL 1.3.
Become an Exponential Partner
Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster.