Hi there! If you're reading this blog post, you are in the process of installing the new Oracle Enterprise Manager (EM) app into Oracle Cloud Infrastructure (OCI),and you've already completed Phase 1 (OCI setup pre-requisites) and are ready to start on Phase 2: Installing the EM App Into Your OCI Compartment.
STOP. IF YOU ARE NOT SURE IF YOUR OCI ADMINISTRATOR HAS COMPLETED THE PHASE 1 PREREQUISITES, CHECK WITH THEM BEFORE PROCEEDING. The prerequisite steps only take a few minutes, but THEY MUST BE COMPLETED BEFORE STARTING THE EM APP INSTALLATION OR YOUR EM INSTALLATION WILL FAIL.
OK, now that we've gotten that out of the way, we can proceed with the installation. You will need to use the the name of the OCI Compartment as into which you should be installing your EM app. In the example steps below, we are assuming the OCI administrator created a compartment called...
Image 1: A view of the OCI home page for your compartment
Image 2: Searching for Enterprise Manager in the OCI Marketplace
Image 3: Enterprise Manager app overview
Image 4: Selecting the Enterprise Manager version and specifying your OCI compartment
Image 5: Naming your EM app Instance, Selecting the Availability Domain and Shape
Image 6: Selecting the OCI Compute Shape for your EM image instance
Image 7: Entering the SSH key, selecting the VCN.
$ ssh –i <private_ssh_key> opc@<public IP Address>
Image 8: Homepage of your OCI instance
$ sudo su – oracle
$ /u01/app/em13c/middleware/bin/emctl status oms
Image 9: Sample output from the status oms command
$ cat /root/.oem/.sysman.pwd
Change the sysman password by executing the below command
$ /u01/app/em13c/middleware/bin/emctl config oms -change_repos_pwd
$ https://<public ip address>:7803/em
emcc.marketplace.com <public IP address of the EM VM>
(if you do this, you can also start using this URL to log in to your new EM)
This installation is mostly automated, so we don’t expect you’ll need to do much troubleshooting. It’s important to note that once your EM is installed and running, ongoing lifecycle management/maintenance/patching/upgrade of your Enterprise Manager is your responsibility, just as if you had installed it on-premises. Similarly, if you are planning on using some of the larger OCI shapes, some configuration of the OMS and OMR may be required for your EM to fully take advantage of the increased CPU and Memory footprint…also just as if you had installed it on-premises. Refer to the Cloud Control Administrator's Guide in our Enterprise Manager documentation for best practices.
But if you do need to troubleshoot a failed installation, the installation log is located at /var/log/emgc_install.log .
Make sure your OCI dynamic group and policies set properly if you find any authentication related errors in log file, and then rerun the below script after fixing the dynamic group and policies mentioned in prerequisites
$ sudo -s
$ cd /root/bootstrap
$ . ./configure_db_and_oms.sh
Image 10: Sample EM on OCI deployment log
In upcoming blog posts, we'll discuss how to get started with monitoring and managing targets, agent installation and agent lifecycle best practices for OCI-hosted Oracle Enterprise Manager instances. You can also attend these free upcoming webinars to learn how to use your EM against specific targets such as Database, Exadata and others.
Two last reminders: Once your EM is installed and running, ongoing lifecycle management/maintenance/patching/upgrade of your Enterprise Manager is your responsibility, just as if you had installed it on-premises. Refer to the Cloud Control Upgrade Guide and Cloud Control Administrator's Guide for best practices in these areas.
Similarly, if you are planning on using some of the larger OCI IaaS Compute Options, some configuration of the OMS and OMR may be required for your EM to fully take advantage of the increased CPU and Memory footprint…also just as if you had installed it on-premises. Refer to the Cloud Control Advanced Installation and Configuration Guide for more details.
If you've gone through the experience, we'd like to hear from you. How did it go? Suggestions for things we can make simpler? Are you using it for dev/test, production or both? What are you monitoring? Join the conversation in the Oracle Enterprise Manager Forum.
Finally, here's the link to the Oracle Cloud Marketplace again. Good luck and keep us posted on your progress.
Image 16: Enjoy your new Oracle Enterprise Manager instance!