Skip to content

Commit 6359d7e

Browse files
committed
Added update instructions
1 parent b31b064 commit 6359d7e

File tree

2 files changed

+124
-1
lines changed

2 files changed

+124
-1
lines changed

docs/update_and_migration/from_3.3/update_from_3.3.md

Lines changed: 62 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -440,7 +440,68 @@ Run the following scripts:
440440

441441
### v3.3.40
442442

443-
A command to deal with duplicated database entries, as reported in [IBX-8562](https://issues.ibexa.co/browse/IBX-8562), will be available soon.
443+
No additional steps needed.
444+
445+
## v3.3.41
446+
447+
### Security
448+
449+
This release contains security changes.
450+
For each of following advisories evaluate the vulnerability to determine whether you might have been affected.
451+
If so, take appropriate action, for example by [revoking passwords](https://doc.ibexa.co/en/latest/users/passwords/#revoking-passwords) for all affected users.
452+
453+
You can find the two advisories below:
454+
455+
#### BREACH attack
456+
457+
If you're using Varnish, update the VCL configuration to stop compressing both the [[= product_name =]]'s REST API and JSON responses from your backend.
458+
Fastly users are not affected.
459+
460+
=== Varnish on [[= product_name_cloud =]]
461+
462+
Update the Varnish configuration.
463+
464+
Generate new configuration with the following command:
465+
466+
```bash
467+
composer ibexa:setup --platformsh
468+
```
469+
470+
Review the changes, merge with your custom settings if needed, and commit them to Git before deployment.
471+
472+
=== Varnish 6
473+
474+
Update your Varnish VCL file to align it with the [`vendor/ezsystems/ezplatform-http-cache/docs/varnish/vcl/varnish5.vcl`](https://github.com/ezsystems/ezplatform-http-cache/blob/2.3/docs/varnish/vcl/varnish5.vcl) file.
475+
476+
=== Varnish 7
477+
478+
Update your Varnish VCL file to align it with the [`vendor/ezsystems/ezplatform-http-cache/docs/varnish/vcl/varnish7.vcl`](https://github.com/ezsystems/ezplatform-http-cache/blob/2.3/docs/varnish/vcl/varnish7.vcl) file.
479+
```
480+
481+
For more information, see the security advisory[TODO: insert link].
482+
483+
#### Outdated version of jQuery in ibexa/ezcommerce-shop package
484+
485+
There are no code changes to execute.
486+
For more information, see the security advisory[TODO: insert link].
487+
488+
### Remove duplicated entries in `ezcontentobject_attribute` table
489+
This release comes with a command to clean up the duplicated entries in the `ezcontentobject_attribute` table, caused by the issue described in [IBX-8562](https://issues.ibexa.co/browse/IBX-8562).
490+
491+
If you're affected you can remove the duplicated entries by running the following command:
492+
``` bash
493+
php bin/console ibexa:content:remove-duplicate-fields
494+
```
495+
496+
!!! caution
497+
498+
Remember about [**proper database backup**](backup.md) before running the command in the production environment.
499+
500+
You can customize the behavior of the command with the following options:
501+
502+
- `batch-size` or `b` - number of attributes affected per iteration. Default value = 10000.
503+
- `max-iterations` or `i` - max. iterations count (default or -1: unlimited). Default value = -1.
504+
- `sleep` or `s` - wait time between iterations, in milliseconds. Default value = 0.
444505

445506
## Finish the update
446507

docs/update_and_migration/from_4.6/update_from_4.6.md

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -163,3 +163,65 @@ You can customize the behavior of the command with the following options:
163163
- `batch-size` or `b` - number of attributes affected per iteration. Default value = 10000.
164164
- `max-iterations` or `i` - max. iterations count (default or -1: unlimited). Default value = -1.
165165
- `sleep` or `s` - wait time between iterations, in milliseconds. Default value = 0.
166+
167+
## v4.6.14
168+
169+
### Security
170+
171+
This release contains security changes.
172+
For each of following advisories evaluate the vulnerability to determine whether you might have been affected.
173+
If so, take appropriate action promptly, for example by [revoking passwords](https://doc.ibexa.co/en/latest/users/passwords/#revoking-passwords) for all affected users.
174+
175+
You can find the three advisories below:
176+
177+
#### BREACH attack
178+
179+
If you're using Varnish, update the VCL configuration to stop compressing both the [[= product_name =]]'s REST API and JSON responses from your backend.
180+
Fastly users are not affected.
181+
182+
=== Varnish on [[= product_name_cloud =]]
183+
184+
Update Platform.sh configuration and scripts.
185+
186+
Generate new configuration with the following command:
187+
188+
```bash
189+
composer ibexa:setup --platformsh
190+
```
191+
192+
Review the changes, merge with your custom settings if needed, and commit them to Git before deployment.
193+
194+
=== Varnish 6
195+
196+
Update your Varnish VCL file to align it with the [`vendor/ibexa/http-cache/docs/varnish/vcl/varnish5.vcl`](https://github.com/ibexa/http-cache/blob/4.6/docs/varnish/vcl/varnish6.vcl) file.
197+
198+
=== Varnish 7
199+
200+
Update your Varnish VCL file to align it with the [`vendor/ibexa/http-cache/docs/varnish/vcl/varnish7.vcl`](https://github.com/ibexa/http-cache//blob/4.6/docs/varnish/vcl/varnish7.vcl) file.
201+
```
202+
203+
For more information, see the security advisory[TODO: insert link].
204+
205+
#### XSS in Content name pattern
206+
207+
There are no code changes to apply.
208+
209+
For more information, see the security advisory[TODO: insert link].
210+
211+
#### Outdated version of jQuery in ibexa/ezcommerce-shop package
212+
213+
Only users of the [old Commerce solution](update_from_4.3_old_commerce.md) are affected.
214+
There are no code changes to apply.
215+
216+
For more information, see the security advisory[TODO: insert link].
217+
218+
### Disable translations of identifiers in Product Catalog's categories
219+
220+
The possibility of translating identifiers and parent information for the Categories in Product Catalog might lead to data consistency issues.
221+
222+
Disable it by running the following migration:
223+
224+
``` bash
225+
php bin/console ibexa:migrations:import vendor/ibexa/product-catalog/src/bundle/Resources/migrations/2024_07_25_07_00_non_translatable_product_categories.yaml --name=2024_07_25_07_00_non_translatable_product_categories.yaml
226+
php bin/console ibexa:migrations:migrate --file=2024_07_25_07_00_non_translatable_product_categories.yaml
227+
```

0 commit comments

Comments
 (0)