18 Recovering Your Environment
- Overview of Recovery Strategies
Recovery strategies enable you to recover from critical failures that involve actual data loss. - Recovering After Data Loss, Corruption, Media Failure, or Application Malfunction
You need to recover some or all of your environment in cases of outages that involve actual data loss or corruption or media failure where the disk cannot be restored. You may also need to recover applications that are no longer functioning properly. This type of failure requires some type of data restoration before the Oracle Fusion Middleware environment can be restarted and continue with normal processing. - Recovering After Loss of Host
You need to recover your Oracle Fusion Middleware environment if you lose the original operating environment. For example, you could have a serious system malfunction or loss of media.
Parent topic: Advanced Administration: Backup and Recovery
Overview of Recovery Strategies
-
Oracle software files
-
Configuration files
-
Oracle system files
-
Windows Registry keys
-
Application artifacts
You can recover your Oracle Fusion Middleware environment while Oracle Fusion Middleware is offline.
The following topics describe recovery strategies:
Types of Recovery
You can recover your Oracle Fusion Middleware environment in part or in full. You can recover the following:
-
The Oracle home
-
WebLogic Server domains
-
Standalone domains
-
The Administration Server
-
Managed Servers
-
A component, such as Oracle SOA Suite or Oracle HTTP Server
-
WebLogic Server cluster
-
Deployed applications
-
The database
Parent topic: Overview of Recovery Strategies
Recommended Recovery Strategies
You should follow these recovery strategies for outages that involve actual data loss or corruption, host failure, or media failure where the host or disk cannot be restarted and they are permanently lost. This type of failure requires some type of data restoration before the Oracle Fusion Middleware environment can be restarted and continue with normal processing.
Note:
The procedures in this chapter assume that no administrative changes were made since the last backup. If administrative changes were made since the last backup, they must be reapplied after recovery is complete.
Note the following key points about recovery:
-
Your Oracle Fusion Middleware environment must be offline while you are performing recovery.
-
Rename important existing files and directories before you begin restoring the files from backup so that you do not unintentionally override necessary files.
-
Although, in some cases, it may appear that only one or two files are lost or corrupted, you should restore the directory structure for the entire element, such as a domain, rather than just restoring one or two files. In this way, you are more likely to guarantee a successful recovery.
-
Recover the database to the most current state, using point-in-time recovery (if the database is configured in Archive Log Mode). This is typically a time right before the database failure occurred.
-
When you restore the files, use your preferred tool to extract the compressed files, as described in Tools to Use for Backup and Recovery.
Ensure that the tool you are using preserves the permissions and timestamps of the files.
When you recover your environment, it is important to recover the entities in the correct order:
-
The database, if it needs to be recovered. See Recovering a Database and Recovering After Loss of Database Host.
-
The Oracle Home, if it needs to be recovered. See Recovering the Oracle Home.
-
The entire domain, if it needs to be recovered. See Recovering an Oracle WebLogic Server Domain and Recovering After Loss of Oracle WebLogic Server Domain Host for recovering a WebLogic Server managed domain. See Recovering a Standalone Domain for recovering a standalone domain.
-
The Administration Server, if you do not need to recover the domain. See Recovering the Administration Server Configuration and Recovering After Loss of Administration Server Host.
-
The Managed Servers, if they are not in the Administration Server domain directory and they need to be recovered. See Recovering a Managed Server and Recovering After Loss of Managed Server Host.
Java components are recovered when you recover the Managed Server. System components are recovered when you recover the domain. In some circumstances, you may need to take certain steps as described in Recovering a Component and Recovering After Loss of Component Host.
-
Some components require additional actions, which are described in the sections listed in Table 18-1.
Table 18-1 Additional Recovery Procedures for Particular Components
Component For Data Loss, Corruption, Media Failure For Loss of Host Oracle B2B
Oracle Data Integrator
NA
Oracle Forms Services
NA
No additional steps needed if recovering to the same host. To recover to a different host, see Recovering Oracle Forms Services to a Different Host.
Oracle HTTP Server
NA
Oracle Platform Security Services
Oracle Reports
NA
Oracle SOA Suite
NA
No additional steps needed if recovering to the same host. To recover to a different host, see Recovering Oracle SOA Suite After Loss of Host.
Oracle WebCenter Content
Oracle WebCenter Content: Records
Recover Oracle WebCenter Content. See Recovering Oracle WebCenter Content.
Recover Oracle WebCenter Content. See Recovering Oracle WebCenter Content to a Different Host.
Oracle WebCenter Portal Analytics
Oracle WebLogic Server
For Oracle WebLogic Server with whole server migration, see Recovering Oracle WebLogic Server with Whole Server Migration.
For Oracle WebLogic Server with whole server migration, see Recovering Oracle WebLogic Server with Whole Server Migration.
-
Applications, if they need to be recovered. See Recovering Applications.
Parent topic: Overview of Recovery Strategies
Recovering After Data Loss, Corruption, Media Failure, or Application Malfunction
Note:
You can only restore an entity to the same path as the original entity. That path can be on the same host or a different host.
- Recovering the Oracle Home
- Recovering an Oracle WebLogic Server Domain
- Recovering a Standalone Domain
- Recovering the Administration Server Configuration
- Recovering a Managed Server
- Recovering a Component
- Recovering a Cluster
- Recovering Applications
- Recovering a Database
Parent topic: Recovering Your Environment
Recovering the Oracle Home
You can recover the Oracle home that was corrupted or from which files were deleted.
To recover the Oracle home:
Recovering an Oracle WebLogic Server Domain
You can recover an Oracle WebLogic Server domain that was corrupted or deleted from the file system, or when the host containing the domain was lost.
Caution:
Performing a domain-level recovery can impact other aspects of a running system and all of the configuration changes performed after the backup was taken will be lost.
To recover an Oracle WebLogic Server domain that was corrupted or deleted from the file system:
Recovering Oracle WebLogic Server with Whole Server Migration
When using database leasing (for example, with whole server migration), if you recover Oracle WebLogic Server, you should discard the information in the leasing table. You can simply drop and recreate the leasing table by running the leasing table creation script. (For more information about Whole Server Migration, see Whole Server Migration in Administering Clusters for Oracle WebLogic Server.)
Parent topic: Recovering an Oracle WebLogic Server Domain
Recovering a Standalone Domain
You can recover a standalone domain that contains system components, such as Oracle HTTP Server, that was corrupted or deleted from the file system or if the host was lost and you want to recover to the same host.
To recover a standalone domain:
Recovering the Administration Server Configuration
If the Administration Server configuration has been lost because of file deletion or file system corruption, the Remote Console continues to function if it was already started when the problem occurred. To prevent the Administration Server from prompting for a user name and password, see Enabling Servers to Start Without Supplying Credentials.
Caution:
Performing a domain-level recovery can impact other aspects of a running system and all of the configuration changes performed after the backup was taken will be lost.
To recover the Administration Server configuration:
On the next configuration change, the configuration from the Administration Server is pushed to the Managed Servers. On each Managed Server restart, the configuration is retrieved from the Administration Server.
Recovering a Managed Server
You can recover a Managed Server's files, including its configuration files if they are deleted or corrupted.
In this scenario, the Managed Server is not on the same host as the Administration Server, and it does not operate properly or cannot be started because the configuration has been deleted or corrupted or the configuration was mistakenly changed and you cannot ascertain what was changed.
To recover a Managed Server:
Recovering a Component
You can recover a component if the component's files have been deleted or corrupted or if the component cannot be started or is not functioning properly because the component's configuration was changed and committed. You may not be able to ascertain what change is causing the problem and you want to revert to an earlier version.
-
For Java components, you recover the Managed Server, as described in Recovering a Managed Server.
-
For system components, such as Oracle HTTP Server, in a standalone domain, you recover the domain, as described in Recovering a Standalone Domain.
-
For system components, such as Oracle HTTP Server, in an Oracle WebLogic Server domain, you recover the domain as described in Recovering an Oracle WebLogic Server Domain.
The following topics describes additional steps you must take for certain components:
Recovering Oracle Platform Security Services
For Oracle Platform Security Services, restore the following files:
DOMAIN_HOME/config/fmwconfig/jps-config.xml DOMAIN_HOME/config/fmwconfig/jps-config-jse.xml DOMAIN_HOME/config/fmwconfig/cwallet.sso DOMAIN_HOME/config/fmwconfig/bootstrap/cwallet.sso DOMAIN_HOME/config/fmwconfig/keystores.xml DOMAIN_HOME/config/config.xml DOMAIN_HOME/config/fmwconfig/ids_config.xml DOMAIN_HOME/config/fmwconfig/system-jazn-data.xml (if present) DOMAIN_HOME/config/fmwconfig/jps_mbeans.xml
Parent topic: Recovering a Component
Recovering Oracle WebCenter Portal's Analytics
To recover Oracle WebCenter Portal's Analytics:
- Restore the domain, as described in Recovering an Oracle WebLogic Server Domain.
- Restore the Oracle home, as described in Recovering the Oracle Home.
- Restore the database containing the ACTIVITIES and MDS schemas, if necessary.
Parent topic: Recovering a Component
Recovering Oracle WebCenter Content
To recover Oracle WebCenter Content:
Note that you should restore the database and the shared file system at the same time. If you cannot do that, you can use the IDCAnalyse utility to determine if there are any inconsistencies between the database and the shared file system. If there are, you can perform a manual recovery using IDCAnalyse.
Parent topic: Recovering a Component
Recovering a Cluster
You may need to recover a cluster in the following situations:
-
The cluster has been erroneously deleted or a cluster member was erroneously deleted.
-
The cluster-level configuration, such as the JMS configuration or container-level data sources, was mistakenly changed and committed. The component or server cannot be started or does not operate properly or the services running inside the server are not starting. You may not be able to ascertain what change is causing the problem and you want to revert to an earlier version.
Caution:
Performing a domain-level recovery can impact other aspects of a running system and all of the configuration changes performed after the backup was taken will be lost.
If the configuration changes are few, then the easiest way is to redo the configuration changes. If that is not feasible, use the following procedure to recover the configuration:
Recovering Applications
Note the following about recovering applications:
-
If the application is staged, the Administration server copies the application bits to the staged directories on the Managed Server hosts.
-
If the deployment mode is nostage or external_stage, ensure that additional application artifacts are available. For example, applications may reside in directories outside of the domain directory. Make your application files available to the new Administration Server by copying them from backups or by using a shared disk. Your application files should be available in the same relative location on the new file system as on the file system of the original Administration Server.
See Deploying Applications to Oracle WebLogic Server for information about deploying applications.
The following topics describe how to recover an application:
Recovering Application Artifacts
If an application's artifacts, such as the .ear file, have been lost or corrupted, you can recover the application.
To recover the application:
Parent topic: Recovering Applications
Recovering a Jakarta EE Application
You can recover a Jakarta EE application:
-
If a Jakarta EE application was redeployed to a Managed Server (whether or not the Managed Server is part of a cluster) and the application is no longer functional.
-
If a deployed application was undeployed from Oracle WebLogic Server.
-
A new version of a composite application was redeployed to a Managed Server or cluster. The application is no longer functional.
To recover the application:
Parent topic: Recovering Applications
Recovering a Database
If your database that contains your metadata repository, including the MDS Repository, is corrupted, you can recover it using RMAN. You can recover the database at the desired granularity, either a full recovery or a tablespace recovery.
For best results, recover the database to the most current state, using point-in-time recovery (if the database is configured in Archive Log Mode.) This ensures that the latest data is recovered. For example:
rman> restore database; rman> recover database;
See Creating Schemas with the Repository Creation Utility for the schemas used by each component.
For detailed steps for recovering a database, see the Oracle Database Backup and Recovery User's Guide.
Recovering After Loss of Host
You need to recover your Oracle Fusion Middleware environment if you lose the original operating environment. For example, you could have a serious system malfunction or loss of media.
- Recovering After Loss of Oracle WebLogic Server Domain Host
- Recovering After Loss of Standalone Domain Host
- Recovering After Loss of Administration Server Host
- Recovering After Loss of Managed Server Host
- Recovering After Loss of Component Host
- Additional Actions for Recovering Entities After Loss of Host
- Recovering After Loss of Database Host
Parent topic: Recovering Your Environment
Recovering After Loss of Oracle WebLogic Server Domain Host
To recover an Oracle WebLogic Server domain after loss of host, follow the steps in Recovering an Oracle WebLogic Server Domain.
Parent topic: Recovering After Loss of Host
Recovering After Loss of Standalone Domain Host
If you lose a host that contains a standalone domain, you can recover it to the same host or a different host, as described in the following topics:
Parent topic: Recovering After Loss of Host
Recovering a Standalone Domain to the Same Host
To recover the standalone domain to the same host after the operating system has been reinstalled, follow the procedures in Recovering a Standalone Domain.
Parent topic: Recovering After Loss of Standalone Domain Host
Recovering a Standalone Domain to a Different Host
In this scenario, you recover the standalone domain to a different host.
To recover the standalone domain to a different host:
Parent topic: Recovering After Loss of Standalone Domain Host
Recovering After Loss of Administration Server Host
If you lose a host that contains the Administration Server, you can recover it to the same host or a different host, as described in the following topics:
- Recovering the Administration Server to the Same Host
- Recovering the Administration Server to a Different Host
Parent topic: Recovering After Loss of Host
Recovering the Administration Server to the Same Host
In this scenario, you recover the Administration Server either to the same host after the operating system has been reinstalled or to a new host that has the same host name. For example, the Administration Server is running on Host A and the Managed Server is running on Host B. Host A has failed for some reason and the Administration Server must be recovered.
To recover the Administration Server to the same host:
-
Recover the file system. For example, recover the domain containing the Administration Server, as described in Recovering After Loss of Oracle WebLogic Server Domain Host.
-
Start the Administration Server. For example:
DOMAIN_HOME/bin/startWebLogic.sh
If the Administration Server starts, you do not need to take any further steps.
-
If the Administration Server fails to start, take the following steps on Host A:
-
Stop all relevant processes. That is, stop all processes that are related to the domain, such as the Managed Servers.
-
Recover the Oracle home, if needed:
tar -xf oracle_home_backup_06052017.tar
-
If the domain directory does not reside in the Oracle home, recover the domain directory from backup. First, change to the directory that you want to be the parent of the Domain home, then:
tar -xf domain_backup_06052017.tar
-
Start the Administration Server. For example:
DOMAIN_HOME/bin/startWebLogic.sh
-
Start the Managed Servers, specifying the Administration URL for the host:
DOMAIN_HOME/bin/startManagedWebLogic.sh managed_server_name admin_url
-
Start Node Manager:
DOMAIN_HOME/bin/startNodeManager.sh
-
Parent topic: Recovering After Loss of Administration Server Host
Recovering the Administration Server to a Different Host
In this scenario, the Administration Server is running on Host A and the Managed Server is running on Host B. Host A has failed for some reason and the Administration Server must be moved to Host C.
To recover the Administration Server to a different host:
Now you can start and stop the Managed Server on Host B using the Remote Console running on Host C.
If you are recovering the Administration Server for a Web Tier installation, see Additional Actions for Recovering Entities After Loss of Host for information about additional actions you must take.
Parent topic: Recovering After Loss of Administration Server Host
Recovering After Loss of Managed Server Host
If you lose a host that contains a Managed Server, you can recover it to the same host or a different host, as described in the following topics:
Parent topic: Recovering After Loss of Host
Recovering a Managed Server to the Same Host
In this scenario, you recover a Managed Server to the same host after the operating system has been reinstalled or to a new host that has the same host name. The Administration Server is running on Host A and the Managed Server is running on Host B. Host B failed for some reason and the Managed Server must be recovered to Host B.
To recover a Managed Server to the same host:
-
Start Node Manager on Host B:
cd DOMAIN_HOME/bin ./startNodeManager.sh
-
Start the Managed Server. For example:
DOMAIN_HOME/bin/startManagedWebLogic.sh managed_server_name admin_url
If the Managed Server starts, it connects to the Administration Server and updates its configuration changes. You do not need to take any further steps.
-
If the Managed Server fails to start or if the file system is lost, take the following steps:
-
Recover the Oracle home to Host B from the backup, if required:
tar -xf oracle_home_backup_06052017.tar
-
Stop Node Manager as described in Starting and Stopping Node Manager.
-
If the Managed Server contains Oracle Reports or Oracle Forms Services, and the Managed Server domain directories reside outside of the Oracle home, restore the domain, in addition to the Oracle home. For example:
cd Domain_Home tar -xf domain_home_backup_06052017.tar
Go to Step 3.e.
-
If the Managed Server does not contain Oracle Forms Services or Oracle Reports, take the following steps:
-
Create a domain template jar file for the Administration Server running in Host A, using the pack utility. For example:
pack.sh -domain=/scratch/oracle/config/domains/domain_name -template=/scratch/temp.jar -template_name=test_install -template_author=myname -log=/scratch/logs/my.log -managed=true
Specifying the -managed=true option packs up only the Managed Servers. If you want to pack the entire domain, omit this option.
-
Unpack the domain template jar file in Host B, using the unpack utility:
unpack.sh -template=/scratch/temp.jar -domain=/scratch/oracle/config/domains/domain_name -log=/scratch/logs/new.log -log_priority=info
-
-
Ensure that the application artifacts are accessible from the Managed Server host. That is, if the application artifacts are not on the same server as the Managed Server, they must be in a location accessible by the Managed Server.
Note:
-
For applications that are deployed in nostage and external_stage mode, copy the application artifacts from the Administration Server host directory.
-
For applications that are deployed in stage mode, the Administration server copies the application bits to the staged directories on the Managed Server hosts.
See Deploying Applications to Oracle WebLogic Server for information about deploying applications.
-
-
Update the Node Manager property ListenAddress by using the following WLST commands:
readDomain('Domain_Home') cd('/') cd('NMProperties') set('ListenAddress','localhost') set('ListenPort',9001) updateDomain()
-
If Node Manager is not started, start it:
cd DOMAIN_HOME/bin ./startNodeManager.sh
-
Start the Managed Server. For example:
DOMAIN_HOME/bin/startManagedWebLogic.sh managed_server_name admin_url
The Managed Server connects to the Administration Server and updates its configuration changes.
-
Parent topic: Recovering After Loss of Managed Server Host
Recovering a Managed Server to a Different Host
In this scenario, the Administration Server is running on Host A and the Managed Server is running on Host B. Host B failed for some reason and the Managed Server must be recovered to Host C. There are two machines, which are logical representations of the computer that hosts one or more WebLogic Servers, machine_1 on Host A and machine_2 on Host B.
Note:
Recover the Oracle home to the same location as the original.
To recover a Managed Server to a different host:
-
Recover the Oracle home for the Managed Server to Host C.
tar -xf oracle_home_backup_06052014.tar
-
Reconfigure the topology to point to the new host:
-
To avoid an inconsistent backup, do not make any configuration changes until the backup is completed. To ensure that no changes are made in the WebLogic Server domain, lock the WebLogic Server configuration, as described in Locking the WebLogic Server Configuration.
-
In Fusion Middleware Control, change the configuration of machine_2, to point it to the new host:
From the WebLogic Domain menu, expand Environment and then select Machines. On the Machine page, select machine_2 and select the Configuration tab. Then select the Node Manager tab. Change the Listen Address to the address for Host C. Click Save.
If you identify the Listen Address by IP address, you must disable Host Name Verification on the Administration Servers that access Node Manager. For more information and instructions, see Using Hostname Verification in Administering Security for Oracle WebLogic Server.
-
Change the Managed Server configuration to point to the new host:
From the left pane of the Remote Console, expand Environment and then select Servers. The, select the name of the server. Select the Configuration tab, then the General tab.
Change the Machine to machine_2.
Change Listen Address to the new host. (If the listening address was set to blank, you do not need to change it.)
Click Save, then click Activate Changes.
-
Unlock the Oracle WebLogic Server configuration by clicking Release Configuration on the Edit Session menu.
-
-
Take any additional steps needed for components as described in Table 18-1.
-
Stop Node Manager as described in Starting and Stopping Node Manager.
-
If the Managed Server contains Oracle Reports or Oracle Forms Services, and the Managed Server domain directories reside outside of the Oracle home, restore the domain, in addition to the Oracle home. For example:
cd Domain_Home tar -xf domain_home_backup_042012.tar
Go to Step 7.
-
If the Managed Server does not contain the components listed in Step 5, take the following steps:
-
Create a domain template jar file from the Administration Server running in Host A, using the pack utility. For example:
pack.sh -domain=/scratch/oracle/config/domains/domain_name -template=/scratch/temp.jar -template_name=test_install -template_author=myname -log=/scratch/logs/my.log -managed=true
Specifying the -managed=true option packs up only the Managed Servers. If you want to pack the entire domain, omit this option.
-
Unpack the domain template jar file on Host C, using the unpack utility:
unpack.sh -template=/scratch/temp.jar -domain=/scratch/oracle/config/domains/domain_name -log=/scratch/logs/new.log -log_priority=info
If you are recovering to a different domain home, use the -app_dir switch in the unpack command.
-
-
Ensure that the application artifacts are accessible from the Managed Server host. That is, if the application artifacts are not on the same server as the Managed Server, they must be in a location accessible by the Managed Server.
Note:
-
For applications that are deployed in nostage and external_stage mode, copy the application artifacts from the Administration Server host directory.
-
For applications that are deployed in stage mode, the Administration server copies the application bits to the staged directories on the Managed Server hosts.
See Deploying Applications to Oracle WebLogic Server for information about deploying applications.
-
-
Update the ListenAddress by using the following WLST commands:
readDomain('Domain_Home') cd('/') cd('NMProperties') set('ListenAddress','localhost') set('ListenPort',9001) updateDomain()
-
Start Node Manager on Host C, if it is not started:
cd DOMAIN_HOME/bin ./startNodeManager.sh
-
Start the Managed Server. For example:
DOMAIN_HOME/bin/startManagedWebLogic.sh managed_server_name admin_url
The Managed Server connects to the Administration Server and updates its configuration changes.
-
Update Oracle Inventory, as described in Updating Oracle Inventory.
-
On Windows, recover the Windows Registry, as described in Recovering the Windows Registry
-
If your environment contains Oracle HTTP Server, modify the mod_wl_ohs.conf file, as described in Modifying the mod_wl_ohs.conf File.
Now you can start and stop the Managed Server on Host C using the Administration Server running on Host A.
Parent topic: Recovering After Loss of Managed Server Host
Recovering After Loss of Component Host
If you lose a host that contains a component (and its Managed Server, if applicable), you can recover most components to the same host or a different host using the procedures described in the following topics:
Some components require additional actions, which are described in the sections listed in Table 18-1.
- Recovering a Java Component to the Same or Different Host
- Recovering a Java Component to a Different Host
- Recovering a System Component to the Same or Different Host
- Recovering Oracle SOA Suite After Loss of Host
- Recovering Web Tier Components to a Different Host
- Recovering Oracle Forms Services to a Different Host
- Recovering Oracle Reports to a Different Host
- Recovering Oracle Data Integrator to a Different Host
- Recovering Oracle WebCenter Content to a Different Host
Parent topic: Recovering After Loss of Host
Recovering a Java Component to the Same or Different Host
To recover a Java component to the same host:
- Recover the Managed Server, as described in Recovering a Managed Server to the Same Host.
- If the component requires additional steps, as noted in Table 18-1, take those steps.
Parent topic: Recovering After Loss of Component Host
Recovering a Java Component to a Different Host
To recover a Java component to a different host:
- Recover the Managed Server, as described in Recovering a Managed Server to a Different Host.
- If the component requires additional steps, as noted in Table 18-1, take those steps.
Parent topic: Recovering After Loss of Component Host
Recovering a System Component to the Same or Different Host
To recover a system component, such as Oracle HTTP Server, to the same host or a different host:
-
For system components, such as Oracle HTTP Server, in a standalone domain, you recover the domain, as described in Recovering After Loss of Standalone Domain Host.
-
For system components, such as Oracle HTTP Server, in an Oracle WebLogic Server domain, you recover the domain, as described in Recovering After Loss of Oracle WebLogic Server Domain Host.
However, some components require additional steps, as noted in Table 18-1.
Parent topic: Recovering After Loss of Component Host
Recovering Oracle SOA Suite After Loss of Host
To recover the Oracle SOA Suite Managed Server to the same host, recover the Managed Server, as described in Recovering a Managed Server to the Same Host.
To recover the Oracle SOA Suite Managed Server to a different host after loss of host:
-
Before you recover, update the WSDL file to point to the new host name and port.
-
Recover the Managed Server, as described in Recovering a Managed Server to a Different Host.
-
After you recover the Oracle SOA Suite Managed Server, take the following actions:
-
Change the host name in the soa-infra MBean:
-
In Fusion Middleware Control, navigate to the Managed Server.
-
From the WebLogic Server menu, choose System MBean Browser.
-
Expand Application Defined MBeans, then oracle.as.soainfra.config, then Server: server_name and then SoaInfraConfig. Select soa-infra.
-
In the Attributes tab, click ServerURL. If the ServerURL attribute contains a value, change the host name to the new host name.
-
Click Apply.
-
-
Redeploy all applications which have the WSDL files updated to the new host name.
Note:
If there is no Load Balancer configured with the environment and Oracle SOA Suite must be recovered to a different host, then in-flight instances that are pending a response from task flow and asynchronous responses are not recovered. Oracle recommends that you use a Load Balancer to ensure that you can recover to a different host.
-
-
If a Load Balancer is configured with the environment, take the following additional steps:
-
In Fusion Middleware Control, from the WebLogic Domain menu, select Environment, then Clusters.
-
Select the cluster you want to configure.
-
From the WebLogic Cluster menu, select Administration, then HTTP.
-
For Frontend Host, enter the new host name.
-
For Frontend HTTP Port and Frontend HTTPs Port, if applicable, enter the new port number.
-
Restart each Managed Server.
-
Parent topic: Recovering After Loss of Component Host
Recovering Web Tier Components to a Different Host
The Web tier consists of Oracle HTTP Server. The following topics describe how to recover it to a different host:
- Recovering Oracle HTTP Server in a Standalone Domain to a Different Host
- Recovering Oracle HTTP Server in a WebLogic Server Domain to a Different Host
Parent topic: Recovering After Loss of Component Host
Recovering Oracle HTTP Server in a Standalone Domain to a Different Host
To recover Oracle HTTP Server in a standalone domain:
Parent topic: Recovering Web Tier Components to a Different Host
Recovering Oracle HTTP Server in a WebLogic Server Domain to a Different Host
To recover Oracle HTTP Server in an Oracle WebLogic Server domain to a different host:
-
Recover the domain, as described in Recovering After Loss of Oracle WebLogic Server Domain Host.
-
Change the configuration of the Oracle HTTP Server instance that was on Host B:
-
In Fusion Middleware Control, from the navigation pane, expand HTTPServer.
-
Select the Oracle HTTP Server instance, such as ohs1.
-
From the Oracle HTTP Server menu, select Administration, then Ports Configuration.
-
For each port in the table, select the port, then click Edit. Change the IP Address.
Note that if ANY is selected, you do not need to make any changes.
-
Click OK.
-
-
Update the mod_wl_ohs wiring for each Oracle HTTP Server instance:
-
In Fusion Middleware Control, from the navigation pane, expand HTTP Server.
-
Select the Oracle HTTP Server instance, such as ohs1.
-
From the Oracle HTTP Server menu, select Administration, then mod_wl_ohs Configuration.
-
In the Locations section, click AutoFill.
All valid WebLogic Server endpoint locations are displayed.
-
Click Apply.
-
-
Restart any Oracle HTTP Server instances that are not on the failed machine by navigating to that instance and clicking Start Up.
-
Start the Oracle HTTP Server instances on Host C by navigating to that instance and clicking Start Up.
Parent topic: Recovering Web Tier Components to a Different Host
Recovering Oracle Forms Services to a Different Host
To recover Oracle Forms Services to a different host:
Parent topic: Recovering After Loss of Component Host
Recovering Oracle Reports to a Different Host
To recover Oracle Reports to a different host:
Parent topic: Recovering After Loss of Component Host
Recovering Oracle Data Integrator to a Different Host
To recover Oracle Data Integrator, follow the procedures in one or both of these topics, depending on the failure:
- Recovering Oracle Data Integrator Repository
- Recovering Oracle Data Integrator Agents to a Different Host
Parent topic: Recovering After Loss of Component Host
Recovering Oracle Data Integrator Repository
If the Oracle Data Integrator Repository must be restored to a different host:
Parent topic: Recovering Oracle Data Integrator to a Different Host
Recovering Oracle Data Integrator Agents to a Different Host
To recover Oracle Data Integrator agents to a different host:
Parent topic: Recovering Oracle Data Integrator to a Different Host
Recovering Oracle WebCenter Content to a Different Host
To recover Oracle WebCenter Content to a different host:
Note that you should restore the database and the shared file system at the same time. If you cannot do that, you can use the IDCAnalyse utility to determine if there are any inconsistencies between the database and the shared file system. If there are, you can perform a manual recovery using IDCAnalyse.
Parent topic: Recovering After Loss of Component Host
Additional Actions for Recovering Entities After Loss of Host
Depending on the entity that you are recovering, you may need to take additional actions after loss of host. The topics about each entity may require you to follow one or more of the following procedures. If so, that is noted in the topic describing how to recover the entity.
The following topics describe the actions you may need to take:
- Recovering Fusion Middleware Control to a Different Host
- Modifying the mod_wl_ohs.conf File
- Creating a New Machine for Certain Components
- Updating Oracle Inventory
- Recovering the Windows Registry
Parent topic: Recovering After Loss of Host
Recovering Fusion Middleware Control to a Different Host
To recover Fusion Middleware Control to a different host, update properties using the System MBean Browser:
Modifying the mod_wl_ohs.conf File
When you recover an Administration Server or a Managed Server to a different host and your environment includes Oracle HTTP Server, you must modify the following file on the new host:
(UNIX) DOMAIN_HOME/config/fmwconfig/components/OHS/ohs_name/mod_wl_ohs.conf (Windows) DOMAIN_HOME\config\fmwconfig\components\OHS\ohs_name\mod_wl_ohs.conf
Note that with Oracle HTTP Server in a WebLogic Server domain, this directory is in the Domain home of the Administration Server. With Oracle HTTP Server in a standalone domain, this directory is the Domain home of Oracle HTTP Server.
Modify all of the instances of the host name, port, and clusters (elements such as WebLogicHost, WebLogicPort, and WebLogicCluster) entries in that file. For example:
<Location /console> SetHandler weblogic-handler WebLogicHost Admin_Host WeblogicPort Admin_Port WLProxySSL ON WLProxySSLPassThrough ON </Location> . . . <Location /soa-infra> SetHandler weblogic-handler WebLogicCluster SOAHOST1VHN2:8001,*SOAHOST2VHN1*:*8001* WLProxySSL ON WLProxySSLPassThrough ON </Location>
Creating a New Machine for Certain Components
If the Administration Server has a Listen address, you must create a new machine with the new host name before you start the Administration Server:
Take the following steps:
Updating Oracle Inventory
For many components, when you recover to a different host, as in the case of loss of host, you must update the Oracle inventory. To do so, execute the following script:
(UNIX) ORACLE_HOME/oui/bin/attachHome.sh (Windows) ORACLE_HOME\oui\bin\attachHome.cmd
Recovering the Windows Registry
When you recover any component to a different host on Windows, as in the case of loss of host, you must import any Windows Registry keys related to Oracle Fusion Middleware to the new host. (You exported the Registry keys in Backing Up Windows Registry Entries.)
Recover the following Registry key.
HKEY_LOCAL_MACHINE\Software\Oracle
In addition, recover each node that begins with Oracle within the following registry keys:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services HKEY_LOCAL_MACHINE\SYSTEM\ControlSet002\Services
To import a key that you have previously exported, use the following command:
regedit /I FileName
For example:
regedit /I C:\oracleregistry.reg
You can also use the Registry Editor to import the key, as described in the Registry Editor Help.
Recovering After Loss of Database Host
For information about recovering your database, see Recovering a Database.
Parent topic: Recovering After Loss of Host