...

1. Log in to the server from which you want to take backup.

2. Open context.xml file from $TOMCAT_HOME/conf/context.xml to get a Username and Password of that database.

   Code Block
   language xml title Username and Password from the context.xml file
   <!-- <Resource name="jdbc/openspecimen" auth="Container" type="javax.sql.DataSource" maxActive="100" maxIdle="30" maxWait="10000" username="root" password="<password>" driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://localhost:3306/<database name>" validationInterval="3600" testOnBorrow="true" validationQuery="Select 1 from dual" /> -->

   
   

3. Access the database using mysql -u<username> -p command

4. Take the backup of the database using db_export_script.sh script. (Fill the appropriate values in the script for DB name, user, root password, hostname etc..)

5. Take the backup of the data folder of OpenSpecimen.

...

1. Log in to the server where you need to import the backup file.

2. Shutdown the OpenSpecimen tomcat service.

   Code Block
   language bash title Shutdown tomcat
   ./catalina.sh stop

   
   

3.  Drop the existing database.

   Warning
   title Note
   Confirm the database before dropping.

   
   

   Code Block
   language sql title Drop Existing Database
   DROP DATABASE database_name;

   
   

4. First, uncompress the file using the below command.

   Code Block
   language bash title Uncompress the file
   gunzip <file_name>.sql.gz

   
   

5.  Open the dump(.sql) file in text editor.
   1. Change the DEFINER value relevant to the database you are using.
      1. To find the current database user hostname('current hostname'), enter the following query:

         1. 
            

            Code Block
            language sql
            SHOW GRANTS FOR current_user();

            
            

      2. Find and replace every occurrence of  DEFINER = `<other user>`@`<other hostname>` with DEFINER = `<current user>`@`<current hostname>`. 
      3. For example, while importing the backup of a dump taken from the prod server, every entry of DEFINER = `prod_user`@`prod_host`
         should become DEFINER = `test_user`@`localhost`
   2. Save the file as .sql

6. Create the Database of the same name (Use dropped database name).

   Code Block
   language sql title Create Database
   CREATE DATABASE database_name;

   
   

7.    Import the dump file into the database using the following command.

   Code Block
   language sql title Restore Database Backup
   mysql -u <new_user> -p <database_name> < <file_name>.SQL;

   
   

8. Exit from the database and take the backup of the existing data folder. and after taking backup clear all the data directory.
9. Unzip the copied data folder zip. and copy all data from the unzipped data folder and paste it into the current cleared data directory.

10. Start the stopped tomcat.

    Code Block
    language bash title Start tomcat
    ./catalina.sh start

    
    

Errors may occur after taking the database backup from one server to another server.

Error 1: "couldn't create the directory for storing de file data."

Reason: While taking database backup from the server1 all OpenSpecimen related configuration setting comes with the database dump. so the data directory path of server 1 also comes with the database dump file. so when we take this dump to another server say server 2 and import that dump file to MySQL. (Remember data directory path is same as Server 1. which is not valid).& when we Start the server we get above error because server 2 don't have permission to create the directory which is an actually wrong path.

Solution: Update the path of data directory in the database and restart the server.

Connect to the MySQL. get into the database.

Step 1: Get the Identifier value for the property data_dir.

select * from os_cfg_props where name = 'data_dir';

...

update os_cfg_settings set activity_Status = 'Active' where identifier = <Identifieer value of Step 2>;

Error 2:  "Invalid label print output directory."

Reason: The reason for this error is also the same as previous Error 1, i.e the value for the label print directory comes from the server 1 from where we took the database dump. so we need to edit path of the label print output directory with the server 2 path.

Connect to the MySQL. get into the database.

 Run the following query query.

select RULE_DEF from os_print_rules where ACTIVITY_STATUS = 'Active';

...