Table of Contents
You need to execute first "make install" in the top directory if you have not done it before. Otherwise you have to configure library paths using LD_LIBRARY_PATH environment variable.
This section lists different methods on how to set-up HIP manually in order to make applications use HIP. We have categorized the local methods to "easy" and "advanced" here.
1. Use the opportunistic mode as described in Chapter 22, Using Opportunistic mode. This method works with both IPv4 and IPv6 applications. It does not require HIT configuration at all.
a. Running a single IPv6-enabled application using HIP: hipconf run opp <EXECUTABLE>
b. Enabling HIP for all applications in bash shell (add to bashrc if you want to set this permanently): export LD_PRELOAD=libopphip.so:libinet6.so:libhiptool.so:libhipopendht.so
2. Override the resolver library dynamically:
a. Running a single application using HIP: hipconf run normal <EXECUTABLE>
b. Enabling HIP for all applications in bash shell (add to bashrc if you want to set this permanently): export LD_PRELOAD=libinet6.so:libhiptool.so:libhipopendht.so
3. Use HIP configuration GUI to run the application. You can execute applications with GUI and edit their library-path as you like. Also you should be able to see list of processes you have executed from GUI.
4. You can also use HITs directly in the application. For example, you can do "ping6 PEER_HIT". However, hipd must know the mapping from the PEER_HIT to the corresponding IP address. You can tell this mapping to hipd using several ways. First way is to configure the HIT-hostname pair to /etc/hip/hosts and the IP-hostname pair to /etc/hosts. Second way is execute "hipconf add map PEER_HIT PEER_IP". You can insert the hipconf command also to /etc/hip/hipd_config and restart hipd when you want the mapping to be permanent. Works only with IPv6-enabled applications.
5. Overload your /etc/hosts files by inserting HIT-hostname pair into the file and use the hostname in your application. You need to make sure that hipd finds the corresponding IP address as instructed in the previous point. Works only with IPv6-enabled applications.
6. Use external nameservices for HIT-IP mapping. For example, you can use AAAA records in DNS for testing (HI records are not supported yet). Alternatively, use the free OpenDHT name service for automatic host naming as described in Chapter 20, OpenDHT Support (Experimental!).