https://github.com/michelderu/upgrade-in-situ
https://github.com/michelderu/upgrade-in-situ
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/michelderu/upgrade-in-situ
- Owner: michelderu
- Created: 2019-10-01T09:36:01.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2019-10-02T15:41:12.000Z (over 5 years ago)
- Last Synced: 2025-01-20T08:49:24.285Z (4 months ago)
- Language: Dockerfile
- Size: 6.84 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Upgrade process "in-situ" for MarkLogic running in Docker container
This upgrade process was documented and tested for a customer who wanted to upgrade from 8 to 9. First of all, make sure to log a ticket with [email protected] to get the latest information on specifics for the versions.
## Prepare a docker image based on 8.0-4.2
In this step we build an image that is comparable to the customer's image.
Download the previous version from https://wiki.marklogic.com/display/PS/Previous+MarkLogic+Versions.
```sh
docker build -t marklogic:8.0-4.2 .
docker run --name=initial-install -p 8001:8001 marklogic:8.0-4.2
```
Open http://localhost:8001 to self-install database (skip cluster, set-up admin creds). After that, save the installed image.
```sh
docker commit initial-install marklogic:8.0-4.2
```
## Start the newly created image
```sh
docker run -d --name=marklogic-cust -p 8000-8002:8000-8002 marklogic:8.0-4.2
```
## Backup the customer's Docker container
```sh
docker commit marklogic-cust marklogic-cust-backup
```
## Backup the MarkLogic Data directory
In case the Docker Container had mounted the MarkLogic Data directory to the host OS or somewhere else, make sure to also backup the full Data Directory. Actually, it is a good moment in time now to stop the MarkLogic server before making the backup.
## Copy the upgrade files into the container
Download the upgrade version from https://developer.marklogic.com/products/marklogic-server/9.0.
Be sure to include the Converters as they are not part of the main download anymore.
```sh
docker cp MarkLogic-9.0-10.3.x86_64.rpm marklogic-cust:/tmp
docker cp MarkLogicConverters-9.0-10.3.x86_64.rpm marklogic-cust:/tmp
```
## Shell into the docker container and upgrade MarkLogic
Start the shell:
```sh
docker exec -it marklogic-cust sh
```
Within the shell, run the following commands:
```sh
/sbin/service/MarkLogic stop
rpm -e MarkLogic
yum -y install libtool-ltdl libgcc.i686 libstdc++.i686
rpm -i /tmp/MarkLogic-9.0-10.3.x86_64.rpm
rpm -i /tmp/MarkLogicConverters-9.0-10.3.x86_64.rpm
/sbin/service/MarkLogic MarkLogic start
```
Open http://localhost:8001 to ugrade databases.
# Some helpful tools
## Install packages without an internet connection to the container
### Install the Download Only option
```sh
yum install yum-plugin-downloadonly
```
### Download the actual package you need
```sh
yum -y reinstall --downloadonly --downloaddir=/tmp libtool-ltdl
```
### Copy it and install manually
```sh
docker cp /tmp/libtool* marklogic-cust:/tmp
docker exec -it marklogic-cust sh
rpm -i /tmp/libtool*
```