# 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
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dbi-services.gitbook.io/dmk-oracle-manual/extension/dmk_dbbackup/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.