Installation
- Jan Klinke
This page describes the installation process of Dbvisit StandbyMP on Linux and Windows platforms.
You must review & complete all Installation Requirements prior to starting installation: Installation Requirements
There is no specific required sequence to install dbvagentmanagers and dbvcontrol. For example it doesn’t matter if you install first dbvcontrol on separate host, or if you first install primary dbvagentmanager.
You can choose any sequence for installing Dbvisit StandbyMP components which suits you best.
1. Linux
Never use root user for Installation of Dbvisit StandbyMP on Linux
This installation procedure is not valid for Oracle RAC and SEHA environments. Refer to <<TBD>> instead
1.1 Create a "Dbvisit Base" Directory
This step needs to be done on primary, standby and dbvcontrol server (if different from standby server).
This step is the only exception where we will need to use root privileges. The default location is /usr/dbvisit. You can specify any location you need as long as has enough free space (see Installation Requirements ). Following commands can be used to create installation directory:
sudo mkdir /usr/dbvisit
sudo chown oracle:oinstall /usr/dbvisitThe ownership of the directory needs to be changed to the user who will install and run Dbvisit (Oracle/SQLServer/Postgres Database software owner).
1.2 Download and Extract Latest Software
This step needs to be done on primary, standby and dbvcontrol server (if different from standby server).
The latest available version can be downloaded from the Dbvisit web site https://www.dbvisit.com
Once the software is downloaded, you can upload / copy it to a temporary location on your server, do not use Dbvisit Base location. Make sure the ownership of the file is set to the same user who owne Dbvisit Base:
mkdir /tmp/dbvisit
cd /tmp/dbvisit
# now upload files
chown oracle:oinstall /tmp/dbvisit/standby-v12.1.tar.gz
tar -xzf standby-v12.1.tar.gzVerify you can now see two installer files:
-rwxr-xr-x. 1 oracle oinstall 188106709 Jan 28 09:54 install-agent-v12.1
-rwxr-xr-x. 1 oracle oinstall 64448219 Jan 28 09:52 install-control-v12.11.3 Install Dbvisit StandbyMP dbvagentmanager
This step needs to be done on primary and standby server only
You can start the installation by running in install-agent file:
You 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 prepared earlier |
Agent File Transfer Port: (7890) |
| There’s usually no need to change the port, press enter to accept suggested value |
Fully Qualified Domain Name for this host: [? for help] (czlin0231) | czlin0231 | hostname (including domain name or not) of your primary server. Hostname must be resolvable into valid IPv4 address and such interface needs to be present on the host |
Fully Qualified Domain Name for the Control Center: | czlin0232 | hostname (including domain name or not) where you will install your dbvcontrol. Hostname must be resolvable into valid IPv4 address. It is not required for controlcenter to be installed / running at this point. |
Agent Communications Port:(5533) |
| There’s usually no need to change the port, press enter to accept suggested value |
Passphrase: | Admin123 | passphrase used for encrypting communication between dbvagentmanagers and dbvcontrol. Must match on all hosts. There is no complexity requirement. |
Example complete output of installation:
Directly after the installation of dbvagentmanager is finished, you have the option to create dbvagentmanager systemctl service by copying and running the last lines in the installer output:
Creating systemctl service for dbvagentmanager will ensure dbvagentmanager will automatically startup after server reboot.
1.4 Install Dbvisit StandbyMP dbvcontrol
This step needs to be done on server where you intend to install dbvcontrol (separate host or standby server).
You can start the installation by running in install-control file:
You 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 prepared earlier |
Control Center Web Server Port: (4433) |
| There’s usually no need to change the port, press enter to accept suggested value. |
Agent Communications Port: (5533) |
| There’s usually no need to change the port, press enter to accept suggested value. |
Passphrase: | Admin123 | passphrase used for encrypting communication between dbvagentmanagers and dbvcontrol. Must match on all hosts. There is no complexity requirement. |
Example complete output of installation:
Directly after the installation of dbvagentmanager is finished, you have the option to create dbvagentmanager systemctl service by copying and running the last lines in the installer output:
Creating systemctl service for dbvcontrol will ensure dbvcontrol will automatically startup after server reboot.
Once dbvcontrol is installed and started, you can verify accessibility by going to following URL:
2. Windows
3. Batch Installation
It is possible to perform fresh installation of Dbvisit components in batch mode if needed for automation. Upgrade in batch mode is not possible.
3.1 Linux
It is possible to run dbvagentmanager and dbvcontrol installer in batch mode using “-batch” switch. Each installer has different parameters and only non-default parameters (marked as “required to specify”) are needed.
Complete set of dbvagentmanager batch installation parameters for Linux:
Complete set of dbvcontrol parameters is:
Example batch installation commands:
You will need to create / start systemctl services same as when performing manual installation
3.2 Windows
Batch installation for Windows has different syntax than on Linux due to the fact that we’re using msi installer. The batch installation can be run by specifying /quiet switch together with parameters listed below:
Complete set of dbvagentmanager batch installation parameters for Windows:
Complete set of dbvcontrol batch installation parameters for Windows:
Example batch installation commands: