case 4690 - report browser downloads under the data path, not beside the app; manual updated

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-22 20:25:00 -07:00
parent e8e7a2ec40
commit a34e012eee
7 changed files with 32 additions and 34 deletions

View File

@@ -2,7 +2,9 @@
This optional setting sets the _full_ path to the Chrome web browser executable that is used by AyaNova to render reports.
If not set, AyaNova will attempt to automatically download a copy of Chrome to a `Chrome` and `ChromeHeadlessShell` folders under the AyaNova executable folder on first report rendering.
If not set, AyaNova will attempt to automatically download a copy of Chrome to `Chrome` and `ChromeHeadlessShell` folders inside a `report-browser` folder under the [data path](ops-config-data-path.md) on first report rendering. The data folder must allow programs to run from it (on Linux it must not be on a `noexec` mount).
Versions before 8.3.0 downloaded Chrome to the AyaNova program folder instead. Those `Chrome` and `ChromeHeadlessShell` folders in the program folder are no longer used and can be deleted.
This setting is typically not required to be set.

View File

@@ -154,15 +154,7 @@ Create the data directory. AyaNova will automatically create subfolders under th
sudo mkdir /var/ayanova/data
```
Create the Chrome binary directories:
```bash
sudo mkdir /var/ayanova/Chrome
```
```bash
sudo mkdir /var/ayanova/ChromeHeadlessShell
```
The Chrome report rendering engine is downloaded automatically into a `report-browser` folder under this data directory the first time a report is rendered, so the data directory must not be on a `noexec` mount.
### 7\. Download and unzip the AyaNova binaries archive
@@ -234,18 +226,6 @@ Set permissions to read / write for the AyaNova data directory:
sudo chmod -R g+rw /var/ayanova/data
```
Set permissions to read / write / execute for the .Chrome directory:
```bash
chmod -R g+rwx /var/ayanova/Chrome
```
Set permissions to read / write / execute for the .ChromeHeadlessShell directory:
```bash
chmod -R g+rwx /var/ayanova/ChromeHeadlessShell
```
Set permissions for the AyaNova folder
```bash

View File

@@ -31,11 +31,7 @@ From a terminal window run the following commands:
```bash
sudo apt-get update && apt-get upgrade && \
sudo apt-get install -y aspnetcore-runtime-8.0 && \
sudo mkdir /var/ayanova/Chrome && \
sudo mkdir /var/ayanova/ChromeHeadlessShell && \
sudo chown -vR :www-data /var/ayanova && \
sudo chmod -R g+rwx /var/ayanova/Chrome && \
sudo chmod -R g+rwx /var/ayanova/ChromeHeadlessShell && \
sudo chmod g+rw /var/ayanova/
```
@@ -64,6 +60,8 @@ sudo ./AyaNova
If there is an issue or error break apart the commands and execute each one individually to find the error.
From 8.3.0 the Chrome report rendering engine is downloaded into a `report-browser` folder under the data directory instead of the program folder. After upgrading from an earlier version any old `Chrome` and `ChromeHeadlessShell` folders in the AyaNova program folder are no longer used and can be removed.
AyaNova should restart on it's own and perform any database schema updates if required automatically.
Open the login form in your browser and after a short delay you should see the new version number at the bottom of the login form.

View File

@@ -25,11 +25,7 @@ From a terminal window run the following commands:
```bash
sudo apt-get update && apt-get upgrade && \
sudo apt-get install -y aspnetcore-runtime-8.0 && \
sudo mkdir /var/ayanova/Chrome && \
sudo mkdir /var/ayanova/ChromeHeadlessShell && \
sudo chown -vR :www-data /var/ayanova && \
sudo chmod -R g+rwx /var/ayanova/Chrome && \
sudo chmod -R g+rwx /var/ayanova/ChromeHeadlessShell && \
sudo chmod g+rw /var/ayanova/
```
@@ -58,6 +54,12 @@ sudo systemctl start ayanova.service
If there is an issue or error break apart the commands and execute each one individually to find the error.
From 8.3.0 the Chrome report rendering engine is downloaded into a `report-browser` folder under the data directory instead of the program folder. After upgrading from an earlier version the old folders are no longer used and can be removed:
```bash
sudo rm -r /var/ayanova/Chrome /var/ayanova/ChromeHeadlessShell
```
AyaNova should restart on it's own and perform any database schema updates if required automatically.
Open the login form in your browser and after a short delay you should see the new version number at the bottom of the login form.