Table of contents
Foreword
Before running the installation sequence, one needs to update the installation scripts to:
Adjust some of the paths
Set personnal administor credentials and default database content
Docker repository access
SAMDistImages/Configuration.conf
Make sure IMAGE_SOURCE_REPOSITORY points to “localhost” and to a directory of your choice. For example:
IMAGE_SOURCE_REPOSITORY=localhost:5000/sambackend/distimages
If you started Docker on a different port than 5000 (see Local Docker repository paragraph) then you will need to change the port number targeted in IMAGE_SOURCE_REPOSITORY.
SAMDeployment/Configuration.conf
Make sure IMAGE_SOURCE_REPOSITORY and IMAGE_DEPLOYMENT_REPOSITORY point to “localhost” and to a directory of your choice. For example:
IMAGE_SOURCE_REPOSITORY=localhost:5000/sambackend/distimages IMAGE_DEPLOYMENT_REPOSITORY=localhost:5000/sambackend/demoimages
If you started Docker on a different port than 5000 (see Local Docker repository paragraph) then you will need to change the port number targeted in IMAGE_SOURCE_REPOSITORY.
Then, customize your actual repository location by modifying STORAGE_BASE_DIRECTORY. For example:
STORAGE_BASE_DIRECTORY=/home/<username>/Downloads/backend/v01.00.06b/Storage
Database access
All the parameters from SAMDeployment/Configuration.conf file can be changed to your liking, especially the DATABASE_USER, DATABASE_PASSWORD and ROOT_DATABASE_PASSWORD fields which should absolutely NOT de the default values in production.
Certificates
Replace the certificate (fullchain.pem) and the private key (privkey.pem) in SAMDeployment/Server/resources/ by your own.
Application key
You must replace the APP_KEY in the SAMDeployment/Server/templates/laravel_env file. You can generate a new one using the following command:
echo "base64:`dd if=/dev/random bs=32 count=1 | base64`"
Default database content
When built, the backend database is pre-filled with SQL requests contained in SAMDistImages/Database/resources/004_SAMBackendData.sql. You can modify that file to have your own Users, Devices, etc…