Loopback Adapter Configuration


The aim of this document is to provide a guide that thoroughly explains the steps of creating and configuring a Loopback Adapter.

Having the loopback adapter set up is required before installing OBIEE 11g. In fact, Business Intelligence installation will fail for the mentioned environments if the loopback adapter is not properly configured.


In order to install the loopback adapter in the Windows 2003 Virtual Machine, you need to:

1. Go through the ‘Add Hardware’ wizard (from the control panel).

Fig 1

Image 1: Add Hardware Option

2. Select Next to skip over the first two screens, then select ‘Yes, I have already added hardware’ and select next again.

Fig 2

Image 2: Hardware Connection Window

3. Scroll to the bottom of the list on the following screen, and select the ‘Add a new hardware device’ option, click next again.

Fig 3

Image 3: Add New Hardware Window

4. Select ‘Install the hardware that I manually select from a list’, and click next.

Fig 4

Image 4: Type of Installation Window

5. Select ‘Network Adapters’ from device types.

Fig 5

Image 5: Hardware List

6. Select ‘Microsoft’ as the manufacturer, and ‘Microsoft Loopback Adapter’ as the Network Adapter.

Fig 6

Image 6: Network Adapter List of  Vendors

7. You’ll need to click next a few more times, then finish. This will add the Microsoft Loopback Adapter as a new Local Area Connection in your Network Connections list.


To properly configure the loopback adapter you need to go through the following steps:

1. Open the Network Connections list, right click on the new network connection (it’s suggested to rename it to Loopback Adapter Connection before) and select properties. Here, you select Internet Protocol (TCP/IP) and click on the Properties button.

Fig 7

Image 7: Network connections List / Loopback adapter Connection TCP / IP settings

2. From the properties screen for TCP/IP, select ‘Use the following IP address’ and fill in a loopback IP address (make sure to pick something not within your current subnet!). In our case we selected IP and  mask Then click OK and close the properties window.

Fig 8

Image 8: Loopback adapter Connection IP address configuration

3. Now, let’s right click on the original network connection and select properties. Here, you select Internet Protocol (TCP/IP) and click on the Properties button. There you type in the static IP that the ClearPeaks network administrator has assigned you (in our case The subnet mask and the default gateway need to be introduced as well.

Fig 9

Image 9: Loopback adapter Connection DNS configuration

4. From Network Connections, click Advanced, and select Advanced Settings from the menu. Make sure your loopback adapter network connection is at the top of the Connections list (use the up/down arrows if not).

Fig 10

Image 10: Network connection Advanced settings

5. Finally, modify your hosts file to associate your static IP address with your computer name. You have to do the following: Open your windows\system32\drivers\etc\ folder, open the hosts file with Notepad and add an entry for your static IP.  In our case DEV-WriteBackSC.clearpeaks.local DEV-WriteBackSC.

Fig 11

Image 11: Hosts file


To verify how the loopback adapter works properly the outcome of running nslookup hostname over a command line should be like the one shown on the following image:

Fig 12

Image 12: Command window with all the test instructions

4 Responses to “Loopback Adapter Configuration”

  1. Thank you for the article. I know it was posted under Oracle BI EE 11g but this is also relevant to other products as well that rely on the Oracle stack. We use the loopback connector quite a bit for Agile PLM and it’s nice that someone has provided additional documentation that could benefit customers looking to support their own environment.

  2. Jordi Miquel says:

    Hi Rodney,
    Thanks for your comment. I am sure that the loopback connector is currently a hot topic across different Oracle platforms. Anyway, If you have any doubt on how to configure it or on any other BI issue please let us know.

  3. Venkat says:

    Hi ,

    I have seen issue that when i start BI services on cmd command prompt its saying that host name.domain.com has been assigned to multiple ip address like virtual machine ip and Please let me know why it showing. And i also when tried to install the BI Apps it saying web logic node manager not running. Please suggest me on this error.


  4. Jordi Miquel says:

    Hi Venkat,

    It seems that you are trying to install OBIEE 11g under a DHCP environment.
    If this is the case, the loopback adapter needs to be in place as OBIEE 11g requires to lay on a static IP machine.

    In order to set an static IP, please make sure that the following steps are properly configured:

    -a valid subnet address is specified for your loopback adapter and it is not being used by any other host.

    -you’ve correctly set the IP address that the network administrator has assigned to your OBI machine (single address).

    -make sure that this address has been correctly mapped to your OBI hostname within the hosts file.

    To verify that the configuration of your loopback adapter is correct please refer to the last point in this blog.

    If you need more information about the loopback adapter configuration do not hesitate to contact us.



privacy policy - Copyright © 2000-2010 ClearPeaks