12 Stop and Start Identity Management Related Servers

This section describes how to start, stop, and restart the various components of the Oracle Enterprise Deployment for Identity Management. The following topics are discussed:

12.1 Start, Stop, and Restart Oracle HTTP Server

Prior to starting or stopping the Oracle HTTP server, perform the following steps:

  • Set ORACLE_INSTANCE to WEB_ORACLE_INSTANCE.

  • Set ORACLE_HOME to WEB_ORACLE_HOME.

  • Ensure that the ORACLE_HOME/opmn/bin appears in the PATH.

12.1.1 Start Oracle HTTP Server

Start the Oracle Web Tier by issuing the following command:

opmnctl startall

12.1.2 Stop Oracle HTTP Server

Stop the Web Tier by issuing the following command. This command is to stop the entire Web Tier:
opmnctl stopall 
Or issue the following command to stop Oracle HTTP Server only:
opmnctl stoproc process-type=OHS

12.1.3 Restart Oracle HTTP Server

It is possible to restart the Web Tier by issuing a Stop followed by a Start command as described in the previous sections.

To restart the Oracle HTTP server only, use the following command:

opmnctl restartproc process-type=OHS

12.2 Start, Stop, and Restart Oracle Identity Manager

Start and stop Oracle Identity Manager and Oracle SOA Suite servers as described in the following sections:

12.2.1 Start Oracle Identity Manager

To start the Oracle Identity Manager Managed Server(s), log in to the WebLogic console at: http://ADMIN.mycompany.com/console, then proceed as follows:

  1. Select Environment - Servers from the Domain Structure menu.
  2. Click the Control tab.
  3. Select SOA Servers (WLS_SOA1 and/or WLS_SOA2).

    It is possible to start the Oracle Identity Manager and Oracle SOA Suite servers independently of each other. There is no dependency in their start order. However, the SOA server must be up and running for all of the Oracle Identity Manager functionality to be available.

  4. Click the Start button.
  5. Click Yes when asked to confirm that you want to start the server(s).
  6. After WLS_SOA1 and/or WLS_SOA2 have started, select WLS_OIM1 and/or WLS_OIM2
  7. Click Start.
  8. Click Yes when asked to confirm the start of the server(s).

12.2.2 Stop Oracle Identity Manager

To stop the Oracle Identity Manager Managed Server(s), log in to the WebLogic console at: http://ADMIN.mycompany.com/oamconsole, and then proceed as follows:

  1. Select Environment - Servers from the Domain Structure menu.
  2. Click the Control tab.
  3. Select OIM Servers (WLS_OIM1 and/or WLS_OIM2) and (WLS_SOA1 and/or WLS_SOA2).
  4. Click the Shutdown button and select Force Shutdown now.
  5. Click Yes when asked to confirm that you want to shutdown the server(s).

12.2.3 Restart Oracle Identity Manager

Restart the server by following the Stop and Start procedures in the previous sections.

12.2.4 Start and Stop All IDM Components on a Host

To start and stop all IDM components on a particular host in IDM provisioned environments, you can use the start/stop scripts as described in Starting and Stopping Servers in the Oracle Fusion Applications Installation Guide. Ensure the order is maintained when starting/stopping the servers in distributed nodes.

An IDM provisioned environment refers to the Type 1 environment and to the Type 2 only after migration or upgrade are run on it. For more information, see Upgrade Type I IDM Environments and Upgrade Type II IDM Environments.

12.3 Start and Stop Oracle Identity Federation Managed Servers

Start and stop Oracle Identity Federation Managed Servers as described in the following sections:

12.3.1 Start Oracle Identity Federation

To start the Oracle Identity Federation Managed Server(s), log in to the WebLogic console at: http://ADMIN.mycompany.com/oamconsole, and then proceed as follows:

  1. Select Environment - Servers from the Domain Structure menu.
  2. Click the Control tab.
  3. Select OIF Servers (WLS_OIF1 and/or WLS_OIF2).
  4. Click Start.
  5. Click Yes when asked to confirm the start of the server(s).

12.3.2 Stop Oracle Identity Federation

To stop the Oracle Identity Federation Managed Server(s), log in to the WebLogic console at: http://ADMIN.mycompany.com/oamconsole, and then proceed as follows:

  1. Select Environment - Servers from the Domain Structure menu.
  2. Click the Control tab.
  3. Select OIF Servers (WLS_OIF1 and/or WLS_OIF2).
  4. Click Shutdown and select Force Shutdown now.
  5. Click Yes when asked to confirm the shutdown of the server(s).

12.3.3 Restart Oracle Identity Federation

Restart the server by following the previous Stop and Start procedures.

12.3.4 Start and Stop the EMAgent

To start and stop the EMAgent, perform the following steps:

  • Start the EMAgent by executing the following command:

    ORACLE_INSTANCE/bin/emctl start all
    

    It is possible to verify that the instance started successfully by executing the following command:

    ORACLE_INSTANCE/bin/emctl status -l
    
  • Stop the EMAgent by executing the following command:

    ORACLE_INSTANCE/bin/emctl stop all
    

12.3.5 Stop the Oracle Identity Federation Instances and EMAgent

Stop the Oracle Identity Federation Instance and EMAgent by executing the following command:

OIF_ORACLE_INSTANCE/bin/opmnctl stopall 

12.4 Start, Stop, and Restart Oracle Access Manager Managed Servers

Start and stop Oracle Access Manager Managed Servers as described in the following sections:

12.4.1 Start an Access Manager Managed Server When None is Running

Normally, Access Manager managed servers are started by using the WebLogic console. After enabling Single Sign-On for the administration consoles. However, there must be at least one Access Manager Server running in order to access a console. If no Access Manager server is running, the only way to start one is from the command line.

To start WLS_OAM1 manually, use the following command:

MSERVER_HOME/bin/startManagedWeblogic.sh WLS_OAM1 t3://ADMINVHN:7001

where 7001 is WLS_ADMIN_PORT in Section 8.3.

12.4.2 Start an Oracle Access Manager Managed Server When Another is Running

To start an Oracle Access Manager Managed Server when there is another already one running, log in to the WebLogic console at: http://ADMIN.mycompany.com/oamconsole

Then proceed as follows:

  1. Select Environment - Servers from the Domain Structure menu.

  2. Click the Control tab.

  3. Select OAM Servers (WLS_OAM1 and/or WLS_OAM2).

  4. Click the Start button.

  5. Click Yes when asked to confirm the start of the server(s).

    After enabling single sign-on for the administration consoles, ensure that at least one Oracle Access Manager Server is running to enable console access.

    If the Oracle WebLogic console was used to shut down all of the Oracle Access Manager Managed Servers, then restart one of those Managed Servers manually before using the console again.

    To start WLS_OAM1 manually, use the command:

    MSERVER_HOME/bin/startManagedWeblogic.sh WLS_OAM1 t3://ADMINVHN:7001
    

12.4.3 Stop Oracle Access Manager Managed Servers

To stop the Oracle Access Manager Managed Server(s), log in to the WebLogic console at: http://ADMIN.mycompany.com/oamconsole

Then proceed as follows:

  1. Select Environment - Servers from the Domain Structure menu.

  2. Click the Control tab.

  3. Select OAM Servers (WLS_OAM1 and/or WLS_OAM2).

  4. Click the Shutdown button and select Force Shutdown now.

  5. Click Yes when asked to confirm the shutdown of the server(s).

12.4.4 Restart Oracle Access Manager Managed Servers

Restart the server by following the Stop and Start procedures in the previous sections.

12.5 Start, Stop, and Restart WebLogic Administration Server

Start and stop the WebLogic Administration Server as described in the following sections:

Admin_user and Admin_Password are only used to authenticate connections between Node Manager and clients. These are independent from the server administration ID and password and are stored in the ASERVER_HOME/config/nodemanager/nm_password.properties file.

12.5.1 Start WebLogic Administration Server

The recommended way to start the Administration server is to use WLST and connect to Node Manager:

cd ORACLE_COMMON_HOME/common/bin 
./wlst.sh

Once in the WLST shell, execute

nmConnect('Admin_User','Admin_Password','ADMINHOST1','5556', 'IDMDomain','ASERVER_HOME')
nmStart('AdminServer')

Alternatively, it is possible to start the Administration server by using the command:

DOMAIN_HOME/bin/startWeblogic.sh

12.5.2 Stop WebLogic Administration Server

To stop the Administration Server, log in to the WebLogic console at: http://ADMIN.mycompany.com/oamconsole, and then proceed as follows:

  1. Select Environment - Servers from the Domain Structure menu.
  2. Click the Control tab.
  3. Select AdminServer(admin).
  4. Click Shutdown and select Force Shutdown now.
  5. Click Yes when asked to confirm the shutdown of the Administration Server.

12.5.3 Restart WebLogic Administration Server

Restart the server by following the Stop and Start procedures in the previous sections.

12.6 Start and Stop Oracle Internet Directory

Start and stop Oracle Internet Directory as described in the following sections:

12.6.1 Start Oracle Internet Directory

Start system components such as Oracle Internet Directory by executing the following command:

ORACLE_INSTANCE/bin/opmnctl startall

To verify that the system components have started, execute the following command:

ORACLE_INSTANCE/bin/opmnctl status -l

12.6.2 Stop Oracle Internet Directory

Stop system components such as Oracle Internet Directory by executing the following command:

ORACLE_INSTANCE/bin/opmnctl stopall 

12.7 Start and Stop Node Manager

Start and stop the Node Manager as described in the following sections:

12.7.1 Start Node Manager

If the Node Manager being started is the one that controls the Administration Server (IDMHOST1 or IDMHOST2), then prior to starting the Node Manager, set JAVA_OPTIONS to -DDomainRegistrationEnabled=true and issue the following commands:

cd IAM_MW_HOME/wlserver_10.3/server/bin
./startNodeManager.sh

12.7.2 Stop Node Manager

To stop Node Manager, kill the process started in the previous section.

12.7.3 Start Node Manager for an Administration Server

Set the environment variable JAVA_OPTIONS to -DDomainRegistrationEnabled=true and issue the following commands:

cd IAM_MW_HOME/wlserver_10.3/server/bin
./startNodeManager.sh

It is important to set -DDomainRegistrationEnabled=true whenever starting a Node Manager that manages the Administration Server.