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. Run the dnshipproxy to handle mapping from hostnames to HITs from hosts files. See Chapter 30, DNS proxy for more details.
2. Use external nameservices for HIT-IP mapping, such as HIP DNS records as instructed in Chapter 29, DNS data manipulation (requires the use of the DNS proxy). Alternatively, use the free OpenDHT name service for automatic host naming as described in Chapter 24, Bamboo-based Name Lookup for HIP.
3. Override the resolver library dynamically:
3a. Running a single application using HIP: hipconf run normal <EXECUTABLE>
3b. 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
4. 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.
5. You can also use HITs (or LSIs) 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.
6. Overload your /etc/hosts files by adding HITs or LSIs to 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.
7. Use the opportunistic mode as described in Chapter 26, Using Opportunistic mode. This method works with both IPv4 and IPv6 applications. It does not require HIT configuration at all.
7a. Running a single IPv6-enabled application using HIP: hipconf run opp <EXECUTABLE>
7b. 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