Upgrade From Previous Version 12 Release
The upgrade steps to latest version 12 release are very similar to upgrade steps from version 11. In general, the upgrade consists of three main steps. These steps must be done on all servers in one go.
Stop all Dbvisit StandbyMP components on all servers
Upgrade: run version 12 Installer choosing the existing installation directory on each server (order doesn’t matter)
Start all Dbvisit StandbyMP components on all servers
Upgrade must be performed on dbvcontrol and all dbvagentmanagers connected to that specific dbvcontrol. It is not supported to mix versions.
There is no specific required sequence to upgrade dbvagentmanagers and dbvcontrol. For example it doesn’t matter if you upgrade first dbvcontrol, or if you first upgrade primary dbvagentmanager.
You can choose any sequence which suits you best. We recommend to start with dbvcontrol upgrade, continue to standby dbvagentmanager upgrade and as final step primary dbvagentmanager upgrade.
1. Prerequisites
If you are currently already running version 12, then there only a few prerequisites to be fulfilled for upgrading to the latest version 12 release:
download version 12 installer files to all servers where you want to upgrade Dbvisit. The latest available version can be downloaded from the Dbvisit web site https://www.dbvisit.com. Create temporary directory on the server to which you download the version 12 installer files
Determine existing DBVISIT_BASE and user running dbvisit components.
On Linux you can do this by checking existing dbvagentmanager and dbvcontrol process:
$ ps -ef | grep dbv
oracle 895913 1 0 09:25 pts/0 00:00:05 /usr/dbvisit/standbymp/bin/dbvcontrol service run
oracle 895914 1 0 09:25 pts/0 00:00:01 /usr/dbvisit/standbymp/bin/dbvagentmanager service runIn this example the DBVISIT_BASE is “/usr/dbvisit” and user is “oracle”.
On Windows, right click on dbvagentmanager service and choose properties. Refer to “Path to executable”:
In this example the DBVISIT_BASE is C:\Program Files\Dbvisit. On the “Log On” tab view and remember the user which runs the service:
In this example oracle user.
2. Linux Upgrade
2.1 Prepare Installer files
Go to the temporary directory to which you downloaded the newerst version 12 installer files. Make sure the ownership of the file is set to the same user who owns Dbvisit Base and extract the file:
chown oracle:oinstall standby-v12.2.0.tar.gz
tar -xzf standby-v12.2.0.tar.gzVerify you can now see two installer files:
-rwxr-xr-x. 1 oracle oinstall 198116527 Sep 4 00:42 install-agent-v12.2.0
-rwxr-xr-x. 1 oracle oinstall 67009013 Sep 4 00:40 install-control-v12.2.0The upgrade consists of three main steps: stop v12 processes, run v12 installer and startup v12. You must perform all upgrade steps as user who run dbvisit components. Do not use root user except for stopping and starting dbvisit components.
You will need to upgrade all dbvagentmanagers and also dbvcontrol to complete the upgrade.
2.2 Stop dbvisit components
Stop all dbvagentmanagers and dbvcontrol following steps here: Starting and Stopping Dbvisit StandbyMP The sequence of stopping doesn’t matter and we recommend to stop all dbvisit components on all servers which will be part of the upgrade at this point as well.
It is not necessary to create a backup of existing version 12 installation, but you can of course do so by following steps here: Upgrade from Version 11 | 2.2 Stop dbvisit components and backup existing DBVISIT_BASE directory
2.3 Run latest version 12 release installer to upgrade the dbvagentmanager
Perform this step on all primary and standby servers. Run the version 12 installer from the temporary directory:
$ ./install-agent-v12.2.0You will need to respond to following prompts during installation:
Prompt | Example Value | Comment |
|---|---|---|
Please carefully read the end-user license agreement at https://dbvisit.com/eula. Do you agree to the terms of this agreement? | Yes | Installation will proceed only with response “Yes” |
Which directory should the software be installed into? | /usr/dbvisit | Dbvisit Base directory you have identified during Prerequisites step |
Upgrade Dbvisit StandbyMP Agent Manager from: v12.1.0 to v12.2.0? | Yes | Press enter, default is “Yes” |
Agent File Transfer Port: (7890) |
| Press enter, value is automatically determined |
Fully Qualified Domain Name for this host: [? for help] (czlin0231) | czlin0231 | Press enter, value is automatically determined |
Fully Qualified Domain Name for the Control Center: | czlin0232 | Press enter, value is automatically determined |
Agent Communications Port:(5533) |
| Press enter, value is automatically determined |
Do you wish to proceed with the setup using the supplied configuration options? Proceed with setup | Proceed with setup | Select “Proceed with setup” to start the installation |
Example complete output of dbvagentmanager upgrade:
2.4 Run latest version 12 release installer to upgrade the dbvcontrol
Perform this step only on host where dbvcontrol is installed. Run the version 12 installer from the temporary directory:
$ ./install-control-v12.2.0You will need to respond to following prompts during installation:
Prompt | Example Value | Comment |
|---|---|---|
Please carefully read the end-user license agreement at https://dbvisit.com/eula. Do you agree to the terms of this agreement? | Yes | Installation will proceed only with response “Yes” |
Which directory should the software be installed into? | /usr/dbvisit | Dbvisit Base directory you have identified during Prerequisites step |
Upgrade Dbvisit StandbyMP Control Center from: v12.1.0 to v12.2.0? | Yes | Press enter, default is “Yes” |
Control Center Web Server Port: (4433) |
| Press enter, value is automatically determined |
Agent Communications Port: (5533) |
| Press enter, value is automatically determined |
Do you wish to proceed with the setup using the supplied configuration options? Proceed with setup | Proceed with setup | Select “Proceed with setup” to start the installation |
Example complete output of dbvcontrol upgrade:
2.5 Start dbvisit components
Once all dbvagentmanagers and dbvcontrol components are upgraded, you can start all components on all servers as per: Starting and Stopping Dbvisit StandbyMP
3. Windows Upgrade
Similar to Linux, the upgrade consists of three main steps: stop v12 processes, run v12 installer and startup v12. During upgrade on Windows, the product is first deinstalled (preserving some files) and then installed again.
It is not necessary to create a backup of existing version 12 installation, but you can of course do so by following steps here: Upgrade from Version 11 | 3.1 Stop dbvisit components and backup existing DBVISIT_BASE directory
3.1 Stop dbvisit components
Stop all components running on the server by stopping individual services as per: Starting and Stopping Standby Multiplatform . We recommend to stop all dbvisit components on other servers which will be part of the upgrade at this point as well.
3.2 Run latest version 12 release installer to upgrade the dbvagentmanager
Perform this step on all primary and standby servers. Run the version 12 agent installer from the temporary directory:
Click Next in the very first step:
You must accept EULA (1) in order for upgrade to proceed (2):
On the next screen, click the Upgrade button (1):
The next screen will show you existing configuration of v12 dbvagentmanager. Dbvagentmanager hostname (in this example czwin0192.dbvisit.cz), control center hostname (in this example czwin0193.dbvisit.cz) and ports are taken from existing v12 DBVISIT BASE and you’re not required to change those. You must take care only to change the dbvagentmanager service username password and domain (1) according to the user who runs the dbvagentmanager service - which you obtained during prerequisite steps:
Click on next to advance to next step where you should click again Next to confirm current hostname (do not change the hostname):
Confirm DBVISIT BASE folder on next screen, do not change it and click next:
On the final screen click on Install to start the upgrade, or go back to review your settings:
After the upgrade is finished, you will be able to close the installer(1):
You will also see the installer log file location (2).
3.3 Run latest version 12 release installer to upgrade the dbvcontrol
Perform this step only on host where dbvcontrol is installed. Run the version 12 dbvcontrol installer from the temporary directory:
On the frist screen click on Next:
You must accept EULA (1) in order for installation to proceed (2):
On the next screen, click the Upgrade button (1):
All port information on the next screen are pulled from existing v12 installation, you need only to click on Next:
Confirm DBVISIT BASE folder on next screen, do not change it and click next:
On the final screen click on Install to start the upgrade, or go back to review your settings:
Once the upgrade completes, you will be able to close the installer(1):
You will also see the installer log file location (2).
3.4 Start dbvisit components
Dbvisit v12 components are automatically started during the installation, you will not have to start them manually after the upgrade.
4. Rollback Upgrade
Rollback is possible ony if you have created backup of your DBVISIT_BASE prior to the upgrade
If for any reason the upgrade wasn’t successful, you can easily revert to previously installed version by following the steps here: Upgrade from Version 11 | 4. Rollback Upgrade