{"id":2280,"date":"2017-05-16T22:52:09","date_gmt":"2017-05-16T20:52:09","guid":{"rendered":"http:\/\/www.oradba.ch\/?p=2280"},"modified":"2017-05-16T22:52:33","modified_gmt":"2017-05-16T20:52:33","slug":"start-oud-servers-on-boot-using-systemd","status":"publish","type":"post","link":"https:\/\/www.oradba.ch\/wordpress\/2017\/05\/start-oud-servers-on-boot-using-systemd\/","title":{"rendered":"Start OUD Servers on Boot using systemd"},"content":{"rendered":"

Starting Oracle Unified Directory on system boot is essential for production environment. Unfortunately OUD just provides a script to create the init.d script. But newer system in general use systemd<\/a> initialise and startup. Nevertheless, creating a custom unit file for OUD is simple and straightforward. First, let’s create a regular init.d script with the create-rc-script<\/em> from oud. The created custom script can be used as template for the systemd unit file.<\/p>\n

create-rc-script<\/em> does allow a couple of parameter to specify the script name, OS user for OUD and the JAVA_HOME. The following example of create-rc-script<\/em> does show how to create a regular start script for OUD instance oud_ad_proxy<\/em>.<\/p>\n

\r\nexport OUD_HOME=\/u00\/app\/oracle\/instances\/oud_ad_proxy\r\nexport JAVA_HOME=\/u00\/app\/oracle\/product\/jdk1.7.0_141\r\n\r\ncd $OUD_HOME\/OUD\/bin\r\ncreate-rc-script -f oud_ad_proxy.sh -u oracle -j $JAVA_HOME\r\n<\/pre>\n
This does create the following bornshell script for init.d.<\/p>\n
\r\n#!\/bin\/sh\r\n#\r\n# Copyright (c) 2012, Oracle and\/or its affiliates. All rights reserved.\r\n# \r\n#\r\n# chkconfig: 345 90 30\r\n# description: Oracle Unified Directory startup script\r\n#\r\n\r\n\r\n# Set the path to the Oracle Unified Directory instance to manage\r\nINSTALL_ROOT="\/u00\/app\/oracle\/instances\/oud_ad_proxy\/OUD"\r\nexport INSTALL_ROOT\r\n\r\n# Specify the path to the Java installation to use\r\nOPENDS_JAVA_HOME="\/u00\/app\/oracle\/product\/jdk1.7.0_141"\r\nexport OPENDS_JAVA_HOME\r\n\r\n# Determine what action should be performed on the server\r\ncase "${1}" in\r\nstart)\r\n  \/bin\/su - oracle -- "${INSTALL_ROOT}\/bin\/start-ds" --quiet\r\n  exit ${?}\r\n  ;;\r\nstop)\r\n  \/bin\/su - oracle -- "${INSTALL_ROOT}\/bin\/stop-ds" --quiet\r\n  exit ${?}\r\n  ;;\r\nrestart)\r\n  \/bin\/su - oracle -- "${INSTALL_ROOT}\/bin\/stop-ds" --restart --quiet\r\n  exit ${?}\r\n  ;;\r\n*)\r\n  echo "Usage:  $0 { start | stop | restart }"\r\n  exit 1\r\n  ;;\r\nesac\r\n<\/pre>\n
The same start \/ stop commands can now be used in the unit file. So let’s create a new custom unit file in \/etc\/systemd\/system<\/em>. The unit file is named according the old instance. <\/p>\n
\r\nsudo vi \/etc\/systemd\/system\/oud_ad_proxy.service\r\n<\/pre>\n
Add the following content to the new unit file.<\/p>\n
\r\n[Unit]\r\nDescription=OUD AD Proxy Instance oud_ad_proxy\r\nWants=network.target\r\nAfter=network.target\r\n\r\n[Service]\r\nType=forking\r\nUser=oracle\r\nGroup=osdba\r\nEnvironment=OPENDS_JAVA_HOME="\/u00\/app\/oracle\/product\/jdk1.7.0_141"\r\nExecStart=\/u00\/app\/oracle\/instances\/oud_ad_proxy\/OUD\/bin\/start-ds --quiet\r\nExecStop=\/u00\/app\/oracle\/instances\/oud_ad_proxy\/OUD\/bin\/stop-ds --quiet\r\nExecReload=\/u00\/app\/oracle\/instances\/oud_ad_proxy\/OUD\/bin\/stop-ds --restart --quiet\r\nStandardOutput=syslog\r\n\r\n[Install]\r\nWantedBy=multi-user.target\r\n<\/pre>\n
As soon as we have the new unit file we have to enable the service.<\/p>\n
\r\nsudo systemctl enable oud_ad_proxy.service\r\n<\/pre>\n
Start the OUD instance using systemctl<\/em>.<\/p>\n
\r\nsudo systemctl start oud_ad_proxy.service\r\n<\/pre>\n
Stop the OUD instance using systemctl<\/em>.<\/p>\n
\r\nsudo systemctl stop oud_ad_proxy.service\r\n<\/pre>\n
Display the status of the OUD service.<\/p>\n
\r\nsudo systemctl status oud_ad_proxy.service\r\n\r\n oud_ad_proxy.service - OUD AD Proxy Instance oud_ad_proxy\r\n   Loaded: loaded (\/etc\/systemd\/system\/oud_ad_proxy.service; enabled; vendor preset: disabled)\r\n   Active: active (running) since Tue 2017-05-16 22:41:09 CEST; 28s ago\r\n  Process: 18300 ExecStop=\/u00\/app\/oracle\/instances\/oud_ad_proxy\/OUD\/bin\/stop-ds --quiet (code=exited, status=0\/SUCCESS)\r\n  Process: 18397 ExecStart=\/u00\/app\/oracle\/instances\/oud_ad_proxy\/OUD\/bin\/start-ds --quiet (code=exited, status=0\/SUCCESS)\r\n Main PID: 18477 (java)\r\n   CGroup: \/system.slice\/oud_ad_proxy.service\r\n           \u2514\u250018477 \/u00\/app\/oracle\/product\/jdk1.7.0_141\/jre\/bin\/java -server -Dorg.opends.server.scriptName=start-ds org.opends.server.core.DirectoryServer --configClass org.opends.server.extensions.ConfigFileHandler -...\r\n\r\nMay 16 22:41:01 euterpe systemd[1]: Starting OUD AD Proxy Instance oud_ad_proxy...\r\nMay 16 22:41:09 euterpe systemd[1]: Started OUD AD Proxy Instance oud_ad_proxy.\r\n<\/pre>\n
Some references and links to MOS Notes:<\/p>\n