![\"\"](\"https:\/\/i0.wp.com\/www.oradba.ch\/wordpress\/wp-content\/uploads\/OUD_Moby.png?resize=213%2C148&ssl=1\")
<\/p>\n<\/p>\n
A bit a while ago I’ve started to use Docker for miscellaneous purposes. Not really an early adopter, but I still hope I caught the train just in time. \ud83d\ude42 In one of my customer project, I did have to set up a couple of OUD instance to develop and test the transition from Oracle Directory Server Enterprise Edition (ODSEE) to Oracle Unified Directory (OUD). This did include more engineering and troubleshooting work as initially planned. So I eventually got to set up my OUD instances in docker containers rather than in dedicated Virtualbox VM. Unfortunately Oracle does not provide any Docker images or build templates for Oracle Unified Directory. Indeed they do have a bunch of official Docker configurations, images, and examples on GitHub for a couple of Oracle products. But just not for Oracle unified Directory. Ok, there is a issue requesting such a Docker image see Issue #656<\/a>. Well… challenge accepted. I did build my own OUD GitHub Repository for OUD Docker deployments.<\/p>\n My GitHub repository oehrlis\/docker-oud<\/a> does contain the Docker build files to facilitate installation, configuration, and environment setup for Docker DevOps users. The project allows you to create two different types of docker images.<\/p>\n To setup my Docker OUD images, I’ve tried to follow a few best practice, rules (Oracle’s golden rules<\/a><\/em> for contributing to oracle\/docker-images<\/a>) as well hints by my workmates (Philipp Salvisberg<\/a> and others).<\/p>\n The Docker images have to be build manually based on oehrlis\/docker-oud<\/a> from GitHub. To assist in building the images, you can use the Due to license restrictions from Oracle, the Docker images containing Oracle software can not provided on a public Docker repository (see [OTN Developer License Terms](http:\/\/www.oracle.com\/technetwork\/licenses\/standard-license-152015.html)). This is the reason why you have to build the images yourself and downloaded the required software prior image build. Alternatively it is possible to specify MOS credentials in The software can either be downloaded from My Oracle Support<\/a>, Oracle Technology Network<\/a> (OTN) or Oracle Software Delivery Cloud<\/a> (OSDC). The following steps will refer to the MOS software download to simplify the build process.<\/p>\n The following software is required for the Oracle Unified Directory Docker image:<\/p>\n Simplest method to build the OUD or OUDSM image is to manually download the required software. However this will lead to bigger docker images, since the software is copied during build, which temporary blow up the container file-system. But its more safe because you do not have to store any MOS credentials. If you’ve enabled Docker experimental features, you could work around this and squash Squash newly built layers with docker build parameter The corresponding links and checksum can be found in Copy all files to the software<\/em> folder.<\/p>\n Build the docker image either by using The advantage of an automatic software download during build is the reduced image size. No additional image layers are created for the software and the final docker image is about 3GB smaller. But the setup script’s Create a .netrc<\/em> file with the credentials for login.oracle.com<\/em>.<\/p>\n Build the docker image either by using Although this method has some security issues.<\/strong> The credentials will always remains in the intermediate layer. It is recommended to use a different approach discussed in the new blog post Smaller Oracle Docker images<\/a>.<\/p>\n This method is similar to the automatic download with .netrc<\/em> file. Instead of manually creating a .netrc<\/em> file it will created based on build parameters. Also with this method the .netrc<\/em> file is deleted at the end.<\/p>\n Build the docker image with MOS credentials as arguments using The time taken to build the OUD or OUDSM image will depend on your internet speed. In any case it shouldn’t be more than a couple of minutes. Although this method has as well some security issues.<\/strong> The credentials will always remains in the intermediate layer. It is recommended to use a different approach discussed in the new blog post Smaller Oracle Docker images<\/a>.<\/p>\n You are now the happy owner of OUD Docker images with a standalone and \/ or collocated Oracle Directory Server installations. The next step is to start using these Docker images to run your OUD containers and deploy different kind of OUD and OUDSM configurations. I’ll provide how to build the containers as well some “behind the seance” information in my upcoming blog posts about OUD on Docker. Stay tuned.<\/p>\n Below you find a few references related to Oracle Unified Directory on Docker:<\/p>\n A bit a while ago I’ve started to use Docker for miscellaneous purposes. Not really an early adopter, but I still hope I caught the train just in time. \ud83d\ude42 In one of my customer project, I did have to set up a couple of OUD instance to develop and test the transition from Oracle […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_exactmetrics_skip_tracking":false,"_exactmetrics_sitenote_active":false,"_exactmetrics_sitenote_note":"","_exactmetrics_sitenote_category":0,"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"Oracle Unified Directory on Docker","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[177,142],"tags":[130,111],"class_list":["post-2456","post","type-post","status-publish","format-standard","hentry","category-docker","category-oud","tag-trivadis","tag-tvdsecexpert"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_shortlink":"https:\/\/wp.me\/p1aErb-DC","jetpack_sharing_enabled":true,"jetpack-related-posts":[{"id":2674,"url":"https:\/\/www.oradba.ch\/wordpress\/2018\/07\/doag-2018-sig-security-oracle-unified-directory-on-docker\/","url_meta":{"origin":2456,"position":0},"title":"DOAG 2018 SIG Security – Oracle Unified Directory on Docker","author":"Stefan","date":"4. July 2018","format":false,"excerpt":"A couple of days ago I did had the opportunity to give a presentation on Oracle Unified Directory on Docker at the DOAG SIG Security day in Stuttgart. It was a great opportunity to discuss how OUD engineering can be simplified using Docker. As proof how easy this can be,\u2026","rel":"","context":"In "DOAG"","block_context":{"text":"DOAG","link":"https:\/\/www.oradba.ch\/wordpress\/category\/doag\/"},"img":{"alt_text":"","src":"https:\/\/i0.wp.com\/www.oradba.ch\/wordpress\/wp-content\/uploads\/IMG_1575-300x225.jpg?resize=350%2C200&ssl=1","width":350,"height":200},"classes":[]},{"id":2761,"url":"https:\/\/www.oradba.ch\/wordpress\/2018\/08\/oracle-unified-directory-sslhandshakeexception-with-java-1-8-0_181\/","url_meta":{"origin":2456,"position":1},"title":"Oracle Unified Directory SSLHandshakeException with Java 1.8.0_181","author":"Stefan","date":"23. August 2018","format":false,"excerpt":"A couple of days ago I did update my Oracle Unified Directory Docker images with the latest bundle patch for OUD as well the latest java version. With the new Docker images I was about to reproduce a use case from a customer. Everything actually worked at first glance, but\u2026","rel":"","context":"In "Oracle Unified Directory"","block_context":{"text":"Oracle Unified Directory","link":"https:\/\/www.oradba.ch\/wordpress\/category\/oud\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":3065,"url":"https:\/\/www.oradba.ch\/wordpress\/2019\/05\/soug-day-2019-oracle-database-in-docker\/","url_meta":{"origin":2456,"position":2},"title":"SOUG Day 2019 – Oracle Database in Docker","author":"Stefan","date":"22. May 2019","format":false,"excerpt":"Today I did have the opportunity to give a presentation on Oracle Database in Docker at the SOUG day in Olten. It was a great opportunity to discuss how Oracle database engineering can be simplified using Docker. Besides the demo the following topics were discussed: Docker images, container and volumes\u2026","rel":"","context":"In "18c"","block_context":{"text":"18c","link":"https:\/\/www.oradba.ch\/wordpress\/category\/oracle-database\/18c\/"},"img":{"alt_text":"","src":"https:\/\/i0.wp.com\/www.oradba.ch\/wordpress\/wp-content\/uploads\/D7KVdlnXsAAg0aX-300x225.jpg?resize=350%2C200&ssl=1","width":350,"height":200},"classes":[]},{"id":2689,"url":"https:\/\/www.oradba.ch\/wordpress\/2019\/02\/doag-red-stack-magazin-oracle-unified-directory-in-docker\/","url_meta":{"origin":2456,"position":3},"title":"DOAG Red Stack Magazin – Oracle Unified Directory in Docker","author":"Stefan","date":"18. February 2019","format":false,"excerpt":"Mid June I wrote an article for the DOAG Red Stack magazin about my work on Oracle Unified Directory in Docker. Just about the same time I did my DOAG SIG Security presentation on the same topic. In the meantime the article has been published in the latest release of\u2026","rel":"","context":"In "DOAG"","block_context":{"text":"DOAG","link":"https:\/\/www.oradba.ch\/wordpress\/category\/doag\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":2525,"url":"https:\/\/www.oradba.ch\/wordpress\/2018\/03\/smaller-oracle-docker-images\/","url_meta":{"origin":2456,"position":4},"title":"Smaller Oracle Docker images","author":"Stefan","date":"28. March 2018","format":false,"excerpt":"One of the important challenges with Docker is to get used to the image layers and the layered file system. It quickly happens that you unintentionally have too much data in an intermediate layer. Either log files, installation software or login credentials. Whereby the first two \"only\" blow up the\u2026","rel":"","context":"In "Docker"","block_context":{"text":"Docker","link":"https:\/\/www.oradba.ch\/wordpress\/category\/docker\/"},"img":{"alt_text":"","src":"https:\/\/i0.wp.com\/www.oradba.ch\/wordpress\/wp-content\/uploads\/Bildschirmfoto-2018-03-28-um-09.07.56-300x178.png?resize=350%2C200&ssl=1","width":350,"height":200},"classes":[]},{"id":2693,"url":"https:\/\/www.oradba.ch\/wordpress\/2018\/07\/oudbase-environment-scripts-for-oracle-unified-directory-part-1\/","url_meta":{"origin":2456,"position":5},"title":"OUDbase environment scripts for Oracle Unified Directory Part 1","author":"Stefan","date":"16. July 2018","format":false,"excerpt":"Almost two years ago I started writing environment scripts for my Oracle Unified Directory installations. At the beginning there were only 2-3 scripts, from which at some point a small project on GitHub emerged. A lot has changed since my blog post Environment Scripts for OUD. The current version of\u2026","rel":"","context":"In "Oracle Unified Directory"","block_context":{"text":"Oracle Unified Directory","link":"https:\/\/www.oradba.ch\/wordpress\/category\/oud\/"},"img":{"alt_text":"","src":"https:\/\/i0.wp.com\/www.oradba.ch\/wordpress\/wp-content\/uploads\/Screen-Shot-2018-07-16-at-23.43.18-300x95.png?resize=350%2C200&ssl=1","width":350,"height":200,"srcset":"https:\/\/i0.wp.com\/www.oradba.ch\/wordpress\/wp-content\/uploads\/Screen-Shot-2018-07-16-at-23.43.18-300x95.png?resize=350%2C200&ssl=1 1x, https:\/\/i0.wp.com\/www.oradba.ch\/wordpress\/wp-content\/uploads\/Screen-Shot-2018-07-16-at-23.43.18-300x95.png?resize=525%2C300&ssl=1 1.5x"},"classes":[]}],"_links":{"self":[{"href":"https:\/\/www.oradba.ch\/wordpress\/wp-json\/wp\/v2\/posts\/2456","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.oradba.ch\/wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.oradba.ch\/wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.oradba.ch\/wordpress\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.oradba.ch\/wordpress\/wp-json\/wp\/v2\/comments?post=2456"}],"version-history":[{"count":10,"href":"https:\/\/www.oradba.ch\/wordpress\/wp-json\/wp\/v2\/posts\/2456\/revisions"}],"predecessor-version":[{"id":2527,"href":"https:\/\/www.oradba.ch\/wordpress\/wp-json\/wp\/v2\/posts\/2456\/revisions\/2527"}],"wp:attachment":[{"href":"https:\/\/www.oradba.ch\/wordpress\/wp-json\/wp\/v2\/media?parent=2456"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.oradba.ch\/wordpress\/wp-json\/wp\/v2\/categories?post=2456"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.oradba.ch\/wordpress\/wp-json\/wp\/v2\/tags?post=2456"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\n
dsconfig<\/code>, ldapmodify<\/code> or any other regular LDAP command line or GUI tools.<\/li>\n\n
Build Docker Images<\/h2>\n
scripts\/buildDockerImage.sh<\/code> script. See below for instructions and usage. The buildDockerImage.sh<\/code> script is just a utility shell script to setup the docker build<\/code> command and is an easy way for beginners to get started. Expert users are welcome to directly call docker build<\/code> with their preferred set of parameters.<\/p>\n\nUsage of buildDockerImage.sh:\n\nbuildDockerImage.sh [-hv] [-t TYPE] [-o DOCKER_BUILD_OPTION]\n-h Usage (this message)\n-v Enable verbose mode\n-t TYPE OUD image and installation type to build.\nPossible types are:\nOUD : Standalone Oracle Unified Directory Server\nOUDSM : Collocated Oracle Unified Directory Server.\nDefault is type is OUD.\n-o DOCKER_BUILD_OPTION Passes on Docker build option\n\nLogfile : buildDockerImage.log<\/pre>\n
scripts\/.netrc<\/code> or via build arguments. Using MOS download during image build will lead into smaller images, since the software will not be part of an intermediate container.<\/p>\nObtaining Product Distributions<\/h3>\n
\n
Manual Download Software<\/h3>\n
--squash<\/code>.<\/p>\n*.download<\/code> files in the software<\/em> folder. Alternatively the direct Oracle Support Download Links:<\/p>\n\n
\ncp p26595894_180152_Linux-x86-64.zip docker-oud\/software\ncp p26270957_122130_Generic.zip docker-oud\/software\ncp p26269885_122130_Generic.zip docker-oud\/software\n<\/pre>\n
docker build<\/code> or buildDockerImage.sh<\/code>.<\/p>\n\n\ndocker build -t oehrlis\/oud -f Dockerfile.oud .\ndocker build -t oehrlis\/oudsm -f Dockerfile.oudsm .\n\nscripts\/buildDockerImage.sh -v -t OUD\nscripts\/buildDockerImage.sh -v -t OUDSM\n<\/pre>\n
Automatic download with .netrc<\/h3>\n
setup_oud.sh<\/code>, setup_oud.sh<\/code> and setup_oudsm.sh<\/code> requires MOS credentials to download the software with using curl<\/a><\/em>. Curl does read the credentials from the .netrc<\/em> file in scripts<\/em> folder. The .netrc<\/em> file will be copied to \/opt\/docker\/bin\/.netrc<\/em>, but it will be removed at the end of the build.<\/p>\necho "machine login.oracle.com login $MOS_USER password $MOS_PASSWORD" >docker-oud\/scripts\/.netrc<\/pre>\n
docker build<\/code> or buildDockerImage.sh<\/code>.<\/p>\n\ndocker build -t oehrlis\/oud -f Dockerfile.oud .\ndocker build -t oehrlis\/oudsm -f Dockerfile.oudsm .\n\nscripts\/buildDockerImage.sh -v -t OUD\nscripts\/buildDockerImage.sh -v -t OUDSM\n<\/pre>\n
Automatic download with Build Arguments<\/h3>\n
docker build<\/code> or buildDockerImage.sh<\/code>.<\/p>\n\ndocker build --build-arg MOS_USER=$MOS_USER \\\n--build-arg MOS_PASSWORD=$MOS_PASSWORD \\\n-t oehrlis\/oud -f Dockerfile.oud .\n\nscripts\/buildDockerImage.sh -v -t OUD \\\n\n-o "--build-arg MOS_PASSWORD=$MOS_PASSWORD --build-arg MOS_USER=$MOS_USER"\n<\/pre>\n
Next Steps<\/h2>\n
Files and References<\/h2>\n
\n