Table of contents

Foreword

It is now time to create the local Docker containers

Installation

SAMDistImages

Go to the SAMDistImages directory and run the following commands:

make images
make pushtorepository

SAMDeployment

Go to the SAMDeployment directory and run the following commands:

make initstorage
make initdatabase
make images

Run

Still in the SAMDeployment directory, simple run the followoing command:

make run

2. Create the images

   make images 

3. Launch the SAM backend by issuing the following command.

   make run

4. Optionally, install phpmyadmin for debugging purposes. It is not recommended. Customize the files fullchain.pem, passwd and privkey.pem in the resources directory. passwd is created with htpasswd. It contains the Apache2 passwords. Launch it by issuing the following commands:

   cd PhpMyAdmin 
   make images
   make run

Update of an existing Production installation

1. Preserve the file Configuration.conf from the previous SAMDeployment package.

2. Preserve APP_KEY value from the .env file in the Server Docker. If needed, update SAMDeployment/Server/templates/laravel_env. The value of APP_KEY must be preserved. If lost, you SAM backend environment will have many issues.

3. Stop the containers samserver_xx.yy.zz, samphpmyadmin_xx.yy.zz and samdatabase_xx.yy.zz

4. Make a backup of your storage structure set using the Configuration.conf variable STORAGE_BASE_DIRECTORY

5. Make sure you use the latest version of SAMDeployment

6. Bump up the version number in the Configuration.conf file

7. Update Configuration.conf matching the corresponding parameters from your previous one.

8. Fill in any new configuration parameters.

9. run make images

10. run make run

11. The container databaseupdate has a very short life span. It terminates as soon as the database is updated.