# Installation

This paragraph describes the installation.

## Prerequisites

This paragraph describes all necessary steps, which must be completed before you start the DMK\_DBBACKUP installation.

* a successful installation of DMK as it’s the root component of DMK\_DBBACKUP

## Software extraction

Based on the dbi services and OFA (Oracle Flexible Architecture) best practices extract the archive under ${ORACLE\_BASE}/local, as explained below:

```
unzip dmk_dbbackup-xx-xx.zip
```

Typically, ${ORACLE\_BASE} match:

* “/u01/app/oracle” on Linux/Unix
* “D:\oracle”on Microsoft Windows systems

## Install

To complete the installation you just need to re-source DMK. This can be either achieved by

* <img src="https://3382315087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPtQvF2ryopbZznR9blJe%2Fuploads%2Fgit-blob-dd45286cda15317dd6e129fcae9cc69c6fb97de7%2Fwindows_logo.png?alt=media" alt="" data-size="line">restarting the PowerShell Console
* <img src="https://3382315087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPtQvF2ryopbZznR9blJe%2Fuploads%2Fgit-blob-e73ef37ed7e1f831b1dd8adaf7f6e665a6c59537%2Flinux_logo.png?alt=media" alt="" data-size="line">sourcing DMK within your shell (alias dmk)

```
oracle@vmoraoel:/home/oracle/ [rdbms11202] dmk
oracle@vmoraoel:/home/oracle/ [rdbms11202] echo ${DMK_DBBACKUP}
/u01/app/oracle/local/dmk_dbbackup
```

:warning:**Copy the required RMAN rcv templates from the directory “${DMK\_DBBACKUP}/templates/rcv/oracle\[10|11|12]” into the appropriate (under the correct Oracle release) “${DMK\_DBBACKUP}/rcv/oracle\[10|11|12]”. For the Oracle RDBMS Version 18c and 19c we use the same templates as for version 12.**

:warning:**RMAN database backup configuration template, called rman.cfg, needs to be copied from the directory “${DMK\_DBBACKUP}/templates” and adapted for each database. The database backup configuration file can be stored in default directory (“${DMK\_ORA\_ADMIN\_SID}/etc”) or can also be called from any other directory if specified in the backup CLI. See later chapter on.**

*Enjoy!*

## Upgrade

dbi services recommend performing a backup of your DMK\_DBBACKUP package before upgrading.

The upgrade process is similar to the installation except that the prerequisites are already fulfilled:

* Extract the software as explained in chapter 3.1.2 Software extraction
* Install DMK as explained in chapter 3.1.3 Install
* Important, take care about the templates, there are some changes in the BCK\_PATH. If you have some trouble compare with the current templates, which are rolled out with the current release

:warning:**Upgrades of versions prior to the 12-10 require a reinstallation.**

That’s it!

## De-installation

This paragraph describes the de-installation of the DMK\_DBBACKUP toolkit.

<img src="https://3382315087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPtQvF2ryopbZznR9blJe%2Fuploads%2Fgit-blob-e73ef37ed7e1f831b1dd8adaf7f6e665a6c59537%2Flinux_logo.png?alt=media" alt="" data-size="line">For Linux:

```
rm -rf $DMK_DBBACKUP
```

<img src="https://3382315087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPtQvF2ryopbZznR9blJe%2Fuploads%2Fgit-blob-dd45286cda15317dd6e129fcae9cc69c6fb97de7%2Fwindows_logo.png?alt=media" alt="" data-size="line">For Windows:

```
Remove-Item $DMK_DBBACKUP
```