This section is useful if you already have the HiPay Marketplace cash-out integration for Mirakl installed on your server and want to update it.
Please remember that the HiPay Marketplace cash-out integration for Mirakl project relies on a core library which is named HiPay Marketplace cash-out library for Mirakl. You can either update the full project or the core library only. In most cases, you will only need to update the core library. Only update the full project if new versions contain features you need or on the recommendation of HiPay’s Business IT Services.
Both procedures are documented below.
Core library update procedure
Go to the root directory of the project (where composer.json is) and run the following command:
$ composer update hipay/hipay-wallet-cashout-mirakl-library
This will install the new version of the HiPay Marketplace cash-out integration for Mirakl and its core library.
The output should look like:
Loading composer repositories with package information
Updating dependencies (including require-dev)
– Updating hipay/hipay-wallet-cashout-mirakl-library
Checking out 2f7f50131839e6c568b9a903ba7e31c6c5fc8847
Full project update procedure
For more safety, it is highly recommended to make a daily backup of your database.
There are 3 different ways to perform a full project update.
Update through the GUI project
Please see the dashboard article.
Please note: update through GUI requires that the “Github token” setting has been set. Please refer to this section to set your GitHub token.
Update through command line
You can update your application by running the following command:
$ php bin/console app:update
The command will perform the following actions:
- Back up current project files,
- Back up database (schema & data),
- Update project files with the latest source,
- Update dependencies,
- Update database schema.
Please note: update through command line requires that the “Github token” setting has been set. Please refer to this section to set your GitHub token.
1. Make a backup
Make sure you have a backup before updating the full project. You may copy the full project directory if you’re not sure. For example, if your project directory is named hipay_mirakl:
$ cp -R hipay_mirakl hipay_mirakl_backup
2. Check if Git is initialized
Go to the root directory of the project (where composer.json is) and check if there is a .git directory by running the following command:
$ ls -al .git
The output should look like:
drwxr-xr-x 8 root root 4096 May 4 08:16 .
drwxr-xr-x 10 root root 4096 May 4 08:13 ..
-rw-r–r– 1 root root 41 May 4 08:13 HEAD
drwxr-xr-x 2 root root 4096 May 4 08:13 branches
-rw-r–r– 1 root root 227 May 4 08:16 config
-rw-r–r– 1 root root 73 May 4 08:13 description
drwxr-xr-x 2 root root 4096 May 4 08:13 hooks
If you get an output like this, go to the next section (“Update the project”).
If you get an error message like ls: cannot access .git: No such file or directory, run the following commands to initialize Git:
$ git init
$ git remote add origin https://github.com/hipay/hipay-wallet-cashout-mirakl-integration
3. Update the project
First, fetch the new tags available:
$ git fetch
Then, determine the version number to which you want to upgrade. Check out the releases page for more information.
When upgrading to a major version (example: from v1.x.x to v2.x.x), make sure that you know the upgrading details. Do not hesitate to contact HiPay’s Business IT Services on our Support Center if you need more information. You can check the version of your installation by typing cat composer.json | grep version. You should get an output similar to:
When you have determined the version number to which you want to upgrade, run the following command, replacing xxx by the version number:
$ git checkout tags/xxx –force
For example, if you want to update to version 2.1.0, you will have tags/2.1.0.
4. Install the dependencies
Install the dependencies using Composer:
$ composer install
If new parameters were added to the project, you will be asked to provide values for them.
5. Update the database
Go to the project directory:
$ cd hipay_mirakl
Run the following command:
$ php bin/console orm:schema-tool:update –dump-sql –force
6. Change permissions
Run the following commands:
$ chmod 777 /var/log/hipay.log
$ chmod 777 -R var/
7. Recover vendor logs (optional)
If there are existing vendors in the database but no logs linked to them, you can generate logs by running the following command:
$ php bin/console logs:vendors:recover
You may check if the upgrade was successful by trying a simple command, for example:
$ php bin/console vendor:process “7 days ago”