Copying configuration and database files
To preserve data from your previous System Console, copy configuration and database files from your previous System Console to System Console 3.1.1. This operation consists of the following tasks:
*Shutting down System Console 3.1.1 and your previous System Console
*Backing up and deleting PostgreSQL database files from the System Console 3.1.1 installation
*Copying the files
Shutting down System Console 3.1.1
Before you can copy files from your previous System Console to System Console 3.1.1, you must shut down System Console 3.1.1. The script that performs this operation stops the System Console process and the System Console PostgreSQL process.
How to shut down System Console 3.1.1
1 Navigate to the System Console 3.1.1 home folder. For example:
cd /opt/actuate3/SystemConsole/modules/SystemConsole
2 Execute stopSystemConsole.sh.
Shutting down and disabling your previous System Console
If you have not already done so, you must disable your previous System Console before copying files into System Console 3.1.1. See Disabling your existing System Console.
Deleting PostgreSQL database files
Before you can copy files from your previous System Console to System Console 3.1.1, you must delete PostgreSQL database files that the System Console 3.1.1 installation created. These files are contained in the database/data folder in the home folder of System Console 3.1.1.
How to delete PostgreSQL database files
1 Navigate to the database folder within the System Console 3.1.1 home folder, for example:
cd /opt/actuate3/SystemConsole/modules/SystemConsole/database
2 Create a backup copy of the data folder and move that folder out of the database folder.
3 Use the rm command to delete the data folder:
rm –rf data
Copying the files
To complete the System Console upgrade, you copy the configuration and database files from your previous System Console to System Console 3.1.1.
If you installed System Console 3.1.1 onto the same machine where your previous System Console is installed, perform the tasks in How to copy files.
If you installed System Console 3.1.1 onto a different machine than where your previous System Console is installed, perform the tasks in How to copy files, using the scp or ftp commands instead of the cp command. Additionally, change:
System Console_OLD
to:
System Console
in the System Console pathnames, since it is not necessary to rename the previous System Console installation root folder when installing System Console 3.1.1 onto a different machine than where your previous System Console is installed.
How to copy files
1 Navigate to the database folder within the System Console 3.1.1 home folder. For example:
cd /opt/actuate3/SystemConsole/modules/SystemConsole/database
2 Use the cp command to copy database files from your previous System Console to System Console 3.1.1. Use the –p option to preserve ownership and permissions. For example:
cp -rp /opt/actuate3/SystemConsole_OLD/modules/SystemConsole/database/data .
3 Navigate to the /tomcat/webapps/sysconsole/WEB-INF folder within the System Console 3.1.1 home folder. For example:
cd /opt/actuate3/SystemConsole/modules/SystemConsole/tomcat/webapps/sysconsole/WEB-INF
4 As a best practice, make backup copies of the following files:
*.configured
*umcconfig.xml
*web.xml
5 Use the cp command to copy configuration files from your previous System Console to System Console 3.1.1. Use the –p option to preserve ownership and permissions. For example:
cp -p /opt/actuate3/SystemConsole_OLD/modules/SystemConsole/tomcat/webapps/sysconsole/WEB-INF/.configured .
cp -p /opt/actuate3/SystemConsole_OLD/modules/SystemConsole/tomcat/webapps/sysconsole/WEB-INF/umcconfig.xml .
cp -p /opt/actuate3/SystemConsole_OLD/modules/SystemConsole/tomcat/webapps/sysconsole/WEB-INF/web.xml .