Node restore fails with "Directory D:\Clearwell Packages creation was not successful for an unknown reason"

book

Article ID: 100013599

calendar_today

Updated On:

Description

Error Message

 BUILD FAILED

E:\CW\SeqRestTestOne\build.xml:2024: The following error occurred while executing this line:
E:\CW\SeqRestTestOne\build\build-schema.xml:1481: The following error occurred while executing this line:
E:\CW\SeqRestTestOne\build\build-schema.xml:1544: The following error occurred while executing this line:
E:\CW\SeqRestTestOne\build\build-schema.xml:1737: The following error occurred while executing this line:
E:\CW\SeqRestTestOne\build\build-schema.xml:1793: The following error occurred while executing this line:
E:\CW\SeqRestTestOne\build\build.xml:103: Directory D:\Clearwell Packages creation was not successful for an unknown reason
 
Total time: 55 seconds
ANT COMMAND DONE
E:\CW\SeqRestTestOne>
 
 

Cause

1. A node backup was created from a Clearwell server where Clearwell was installed on the D:\ drive. The intent is to restore this node backup to another Clearwell server.

2. A restore was attempted from the above backup data, but the Clearwell installation is on a drive other than D:\ on the target server.

Resolution

A manual process must be followed to restore the backup. The approach is to make a copy of the original backup, modify its few property files, and then restore the edited copy. Here are the steps:

 
Note:
        or   represents source drive where backup of appliance is created. Actual name of the source drive must be     
        substituted when applying the steps.                                                                    
         or   represents destination drive where the appliance backup is restored.  Actual name of the destination drive 
         must be substituted when applying the steps.
        represents backup of appliance created on source drive .Actual name of the original backup must 
        be substituted while applying the steps.
        represents copy of , modified and restored on destination drive .Actual    
        name of the modified backup must be substituted while applying the steps. 
        represents current CW product version installed. Actual name of the product version must  
       be substituted while applying the steps.
        For example V714 implies that CW version 7.1.4 is installed, where path to home directory is \CW\V714
       Symbols “<” and “>” define template replacement rather than actual text
 
.      
  
      1). Make a copy of node backup in \CW\\backups folder. 
 
           a). Save locally to Clearwell appliance at
                   \CW\\backups folder. 
                   This location is configured by “auto.backup.dir” property in CW, where backups is default location.
 
           b). Copy folder (including all subfolders and their content)        
                       \CW\\backups\   to
                       \CW\\backups\   
 
           
     2). Modify properties in following file:
           \CW\\backups\\ config.properties       
                                                                                                                                                                        
            a). Modify drive name, by replacing occurrence of < D:> or with or < X\:> in  
                 config.properties file. Make sure that updated path to the resources, in modified property    
                file, are available and are in sync with Current appliance. 
                These are few examples of the properties to be modified:-
                            esa.packages.defaultDrive=          # where Clearwell package is installed
                            esa.mysql.dbmsHome=/mysql     # where MySQL is installed   
       
 
    3). Validate the changes in files:
         \CW\\backups\\ changes_esa.properties
           and
          \CW\\backups\\ esa.properties
       
 
        a). Modify drive name, by updating occurrence of or with or < X\:>  in property file  
           changes_esa.properties. Make sure that updated path to the resources, in modified property file, 
           are available and are in sync with current appliance. 
 
        b). Property file changes_esa.properties dynamically records the changes set by “property browser” 
            using support feature before making a backup. Make sure changes recorded in   
            changes_esa.properties   should be in sync with esa.properties in .
           For example changes_esa.properties  file may contain…
                       esa.case.backupDir=\\\\qanas02\\QAData\\Ragini\\testBackupLocation
                       was=caseBackups
           Validate that esa.properties file has the latest property value e.g.
                         esa.case.backupDir=\\\\qanas02\\QAData\\Ragini\\testBackupLocation
           If there is any update in property from or to or in changes_esa.properties,   
           It should also reflect in esa.properties in .
 
          Note: Never update any property file in \CW\\scratch\esa of current 
                          appliance. Only property files in is updated
 
 
   4). Finally modify properties in files:     
      \CW\\backups\\scratch\esa\ esa.properties
       And 
       \CW\\backups\\scratch\esa\ original_esa.properties   
 
         a). Modify drive name, by replacing occurrence of or with or , in above property files. Make sure that updated paths to the resources are available and are in sync with Current appliance. Some of the possible references to the resources include       following directories\subdirectories:
 
 \\pdftools                                   # location of pdf tools
                                                      # location of base drive or CW packages
 /mysql                                         #location of MySql installation
 \\\\customerScript                   # Location of customer script
 /CW//exe               # Location of exe file 
 /CW//logs                # Location of logs
 /CW//test               # Location of test
 /CW//config           # Location of configuration file
 /CW//3rdparty      # Location of 3rpardy download
 /CW//web/app/WEB-INF     # Web related resources
 /CW//data                              # Location of data
 /CW//scratch                         # Location of scratch file
 /CW/                                        # Home directory 

 
 
     5). Run Clearwell Utility and execute command Option # 2  “Restore Appliance”, after 
          modifying property files in folder.
 
a). Stop all Clearwell services. e.g.
                  [input]  This will STOP all Clearwell services. Are you sure? (y/n): 
                      Y      // these should be already stopped in previous run
 
b). Enter backup name of updated copy   
                   [input] Enter backup name to restore:
                          
c). Restore configuration properties from backup.
                    [input] Do you also want to restore the configuration properties?  (y, n)
                         Y     
d). Depending on if key to be restored
                   [input] Would you like to restore the license key?  (y, n)
                   Y or N  
e). Confirm to continue restore
                    [input] This will drop all the data and restore from 
                           /CW//backups/.    
                            ……..
                            ……..
                   Are you sure you want to proceed?  (y, n)
                   Y
                  Restore should be successful.
f). Finally start all CW services.
                [input] Finally Start Clearwell services? (y/n):
                  Y 
 
 
 
 
   6).    Login to Clearwell, and wait for upgrade job to finish if you receive following message.
 
 

 

Issue/Introduction

As of V713, the Clearwell product may be installed on a drive other than D:. However, node restorations do not work when restored to a target drive having a drive letter different that then the original drive letter.

Additional Information

JIRA: ESA-31495
Powered by Wolken Software