27.8 Upgrading REST Services for OpenText eDirectory

When a new version of REST Image is available, the administrator can perform an upgrade procedure to deploy container with the latest version of REST services. Ensure to store all necessary application related data persistently in Docker volumes before performing an upgrade. Perform the following steps to upgrade REST services using Docker container:

Download and load the latest version of the Docker image from the Software License and Download portal and perform the steps to install the latest version of OpenText eDirectory.
Once the latest docker image is loaded, stop your current docker container using the following command:
```
docker stop <edirapi-container-name>
```
For example,
```
docker stop edirapi-container-1
```
Delete the existing OpenText eDirectory container by running the following command:
```
docker rm < edirapi -container-name>
```
For example,
```
docker rm edirapi -container-1
```
(Optional) Delete the obsolete OpenText eDirectory Docker image by running the following command:
```
docker rmi <edirapi-image ID>
```
For example,
```
docker rmi edirapi: 1.4.1.0000
```

Create a new container using the new REST Docker image using the following command:

docker create --name < edirapi -container-name> --env ACCEPT_EULA=Y --network=<network-type> --volume <volume-name>:/config/ edirapi:<version>

For example,

docker create --name edirapi -container-2 --env ACCEPT_EULA=Y --network=host --volume edirapi -volume:/config/ edirapi: 1.4.1.0000

Copy the configuration file (edirapi.conf) from your local file system to the newly created container as /etc/opt/novell/eDirAPI/conf/edirapi.conf using the following command:
```
docker cp <absolute path of configuration file> edirapi- containername:/etc/opt/novell/eDirAPI/conf/edirapi.conf 
```
For example,
```
docker cp /home/user/edirapi.conf edirapi-container-2:/etc/opt/novell/eDirAPI/conf/edirapi.conf
```
A sample configuration file is shown below:
```
listen = ":9000" 

pfxpassword = "novell" 

bcert = "/etc/opt/novell/eDirAPI/cert/" 

ospmode=false 

edir-hosts = "<ip_address-1>:636,<ip_address-2>:636"
```
NOTE:
- While upgrading to OpenText eDirectory 1.7.2 and above, it is required to add OpenText eDirectory server IP to edirapi.conf file before copying it to the container.
- If you want OpenText eDirectory to connect to multiple OpenText eDirectory trees, enter their IP addresses or domain names separated by commas.

Start the second container using the following command:

docker start <edirapi-container-name>

For example,

docker start edirapi -container-2

To check status of the running container, run the following command:
```
docker ps -a
```

NOTE:REST Services 1.4 is the next release after REST 1.3. There was no interim release for REST services in between these two releases. Post 1.4, OpenText eDirectory released REST 1.4.0.0100 which adds support for OpenSSL 1.0.2zd. This OpenSSL version includes a fix for a potential security vulnerability. For more information about the issue, see this page.