From 08559ea9566bd842f2e0940d348fd8392342ce31 Mon Sep 17 00:00:00 2001 From: John Cardinal Date: Fri, 11 Mar 2022 19:05:48 +0000 Subject: [PATCH] case 4142 --- docs/8.0/ayanova/docs/ops-restore.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/8.0/ayanova/docs/ops-restore.md b/docs/8.0/ayanova/docs/ops-restore.md index aec74d6c..79cb979a 100644 --- a/docs/8.0/ayanova/docs/ops-restore.md +++ b/docs/8.0/ayanova/docs/ops-restore.md @@ -62,21 +62,21 @@ The location of these folders is also logged on server startup in the [server lo 1. Identify the attachments data folder location - Check the [server configuration](ops-config-environment-variables.md) and identify the location of the attachment files. There are two ways this can be specified, either directly through the [AYANOVA_ATTACHMENT_FILES_PATH](ops-config-folder-user-files.md) setting or indirectly through the [AYANOVA_DATA_PATH](ops-config-data-path.md) setting in which case the attachments folder will be found in a folder called `attachments` inside the folder specified by the AYANOVA_DATA_PATH setting. + Check the [server configuration](ops-config-environment-variables.md) and identify the location of the attachment files. There are two ways this can be specified, either directly through the [AYANOVA_ATTACHMENT_FILES_PATH](ops-config-folder-user-files.md) setting or indirectly through the [AYANOVA_DATA_PATH](ops-config-data-path.md) setting in which case the attachments folder will be found in a folder called `attachments` inside the folder specified by the AYANOVA_DATA_PATH setting. 2. Erase the current contents of the attachments folder identifed above, it must be completely empty before the next step - Note: you do not need to erase any other folders that may also be in the data folder such as logs, backup or temp, only the attachments folder contents need to be erased + Note: you do not need to erase any other folders that may also be in the data folder such as logs, backup or temp, only the attachments folder contents need to be erased -3. Unzip the contents of the attachements zip file into the attachments folder. +3. Unzip the contents of the attachments zip file into the attachments folder. - There will be a lot of folders with single letter of digit names contained within each other, this is normal, you will not see recognizable file names here. + There will be a lot of folders with single letter of digit names contained within each other, this is normal, you will not see recognizable file names here. Be careful to ensure you are unzipping _into_ the attachments folder and not a sub folder, it's easy to accidentally unzip a higher level directory into the intended directory in which case you won't see any of your attachments in AyaNova until this is resolved. ### Restore the database -Use the PostgreSQL pg_restore utility to restore the backup file to an **existing** AyaNova database. +Use the PostgreSQL pg_restore utility to restore the database backup file to an **existing** AyaNova database. -If you do not have an existing AyaNova database to restore to, the AyaNova server will create one for you; start the server, allow it to create an empty db then shut it down again to restore. +If you do not have an existing AyaNova database to restore to, the AyaNova server will create one for you; start the AyaNova server, allow it to create an empty db then shut it down again to restore. The PostgreSQL utility pg_restore is used to restore the `.backup` file containing the database backup from AyaNova. @@ -110,7 +110,7 @@ AyaNova can be re-started at this point, for server type installations restart t ### Verify the data -- Verify database: login to AyaNova, check that the most recent data that should be in the database backup is present -- Verify attachments: First examine the list of attachments that AyaNova knows about in the database by opening the Adminstration -> Attached files. This list shows the attachments that AyaNova _expects_ not necessarily what is physically present so select an attachment listed to open the record that attachment is connected to and confirm the physical file is actually present by opening the file in the attachments area of the form. If the file won't open verify that the attachment files are restored to the attachments folder where AyaNova expects to find them and not in another folder or sub folder and check again and also verify it's not just an issue with that one attachment by checking or more other attachment files in the same way. +1. Verify database: login to AyaNova, check that the most recent data that should be in the database backup is present +2. Verify attachments: First examine the list of attachments that AyaNova knows about in the database by opening the Adminstration -> Attached files. This list shows the attachments that AyaNova _expects_ not necessarily what is physically present so select an attachment listed to open the record that attachment is connected to and confirm the physical file is actually present by opening the file in the attachments area of the form. If the file won't open verify that the attachment files are restored to the attachments folder where AyaNova expects to find them and not in another folder or sub folder and check again and also verify it's not just an issue with that one attachment by checking or more other attachment files in the same way. There is no need to shut down the server if the attachment files need to be moved to the correct folder.