Skip to content

Commit

Permalink
fix #27 and create new release v1.3.6
Browse files Browse the repository at this point in the history
  • Loading branch information
Stefan Oehrli committed Apr 10, 2018
1 parent 6e94543 commit 9d2d310
Show file tree
Hide file tree
Showing 3 changed files with 47 additions and 2 deletions.
3 changes: 2 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -18,4 +18,5 @@ build/oudbase_install.tgz
/.pydevproject
/.project
/Build tar and shell.launch
/org.python.pydev.PyDevBuilder.launch
/org.python.pydev.PyDevBuilder.launch
/.externalToolBuilders/
44 changes: 44 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@ Trivadis does have the TVD-BasEnv™ to standardizes and simplifies the handling
*OUD Base* is basically just the **oudenv.sh** script, some configuration files and a bunch of aliases. The directory structure for the OUD binaries, scripts and configuration files is similar to what is use in TVD-BasEnv™ and based on OFA. It is written in bash and tested on Oracle Linux VM’s, OUD Docker container and Raspberry Pi’s with Raspbian Jessy/Stretch. It should also run on any other bash environment.

## Setup

### Automatic Setup using shell script
*OUD Base* is available as TAR file or as Bash installation file *oudbase_install.sh*. Wherein *oudbase_install.sh* is a TAR file with a wrappped Bash script.

```bash
Expand Down Expand Up @@ -144,6 +146,48 @@ alias oud=". $(find $OUD_BASE -name oudenv.sh)"
. $(find $OUD_BASE -name oudenv.sh)
```

### Manual setup TAR file

Extract the TAR to your favorite folder.

```
tar -zxcd oudbase_install.tgz -C $ORACLE_BASE/local
```

Update the oudenv_core.conf and add some mandatory parameter eg. ORACLE_BASE, OUD_BASE, OUD_DATA, OUD_INSTANCE_BASE, OUD_BACKUP_BASE, ORACLE_HOME, ORACLE_FMW_HOME, JAVA_HOME, LOG_BASE or ETC_BASE. Where ORACLE_BASE is the minimal required parameter.

```
echo "ORACLE_BASE=$ORACLE_BASE" >> $ORACLE_BASE/local/etc/oudenv_core.conf
```

Add a .OUD_BASE file to the user home

```
echo echo "OUD_BASE=$OUD_BASE" >> $HOME/.OUD_BASE
```

Update .profile or .bash_profile to source the OUD environment

```
PROFILE=$HOME/.bash_profile
echo "# Check OUD_BASE and load if necessary" >>"${PROFILE}"
echo "if [ \"\${OUD_BASE}\" = \"\" ]; then" >>"${PROFILE}"
echo " if [ -f \"\${HOME}/.OUD_BASE\" ]; then" >>"${PROFILE}"
echo " . \"\${HOME}/.OUD_BASE\"" >>"${PROFILE}"
echo " else" >>"${PROFILE}"
echo " echo \"ERROR: Could not load \${HOME}/.OUD_BASE\"" >>"${PROFILE}"
echo " fi" >>"${PROFILE}"
echo "fi" >>"${PROFILE}"
echo "" >>"${PROFILE}"
echo "# define an oudenv alias" >>"${PROFILE}"
echo "alias oud='. \${OUD_BASE}/bin/oudenv.sh'" >>"${PROFILE}"
echo "" >>"${PROFILE}"
echo "# source oud environment" >>"${PROFILE}"
echo ". \${OUD_BASE}/bin/oudenv.sh" >>"${PROFILE}"
```

Open a new terminal to test OUDBase.

## Configuration and Architecture

By default **oudbase** does work from its base folder **OUD_BASE** which is usually the same as **ORACLE_BASE**. In certain cases it make sense to separate persistent data like configuration files, log files and OUD instances. If OUD does run in a docker container it's crucial, that you OUD instance is on a separate volume. Otherwise the instance will not survive. **OUD_DATA** variable allows to specify an alternative base directory for persistent data like OUD instance home, backups, exports as well configuration and log files.
Expand Down
2 changes: 1 addition & 1 deletion local/oudbase/doc/.oudbase.sha
Original file line number Diff line number Diff line change
Expand Up @@ -40,5 +40,5 @@ abe0a18757b04ca99c155b6018984bb26db496be ?./templates/create/10_enable_replicati
994f75086c57e4b0ecfb1b975cc04d53f37b31a4 ?./templates/create/04_create_root_user.conf
39ddc950916cb748e9f042978a93a85272602221 ?./templates/create/02_configure_instance.conf
8624bcdae55baeef00cd11d5dfcfa60f68710a02 ?./doc/LICENSE
3db97bdaacfb1fc28c27f93bceda238135caed1b ?./doc/README.md
e7c9d528e7902c20fbd5b2545db2d539db7d499f ?./doc/README.md
42f56ae05e078dac0a85de87fc8e72e971d62db4 ?./doc/.version

0 comments on commit 9d2d310

Please sign in to comment.