Preparing UNIX for TDV Installation
This section applies only if you are installing TDV on a machine running a supported UNIX operating system. Examples of valid and invalid /etc/hosts file entries are shown in the following table.
Validity | /etc/hosts File Entry |
Valid | 127.0.0.1 localhost
IP hostname.domain hostname |
Valid | 127.0.0.1 localhost localhost.localdomain
IP hostname.domain hostname |
Valid | 127.0.0.1 localhost localhost.localdomain localhost
IP hostname.domain hostname |
Invalid | 127.0.0.1 localhost.localdomain
IP hostname.domain hostname |
Invalid | 127.0.0.1 localhost.localdomain localhost
IP hostname.domain hostname |
To prepare your UNIX machine for installation of TDV products
1. Review the new features and bug fixes as documented in the TDV and Business Directory Release Notes.
2. Run the following command to determine if localhost can be resolved on the target installation machine before attempting an installation:
ping localhost
3. If the ping results look like the following, localhost is being resolved and the machine is ready for TDV installation. You can continue with the instructions in other sections.
Linux Ping Example with Valid localhost
$ ping localhost
PING localhost (127.0.0.1) from 127.0.0.1 : 56(84) bytes of data.
64 bytes from localhost (127.0.0.1): icmp_seq=1 ttl=255 time=0.071 ms
64 bytes from localhost (127.0.0.1): icmp_seq=2 ttl=255 time=0.063 ms
64 bytes from localhost (127.0.0.1): icmp_seq=3 ttl=255 time=0.043 ms
--- localhost ping statistics ---
3 packets transmitted, 3 received, 0% loss, time 1999ms
rtt min/avg/max/mdev = 0.043/0.059/0.071/0.011 ms
4. If the ping results look like the following, localhost is not correct. You must edit your /etc/hosts file.
Linux Ping Example with Invalid localhost
This example of /etc/hosts files shows where Server is unable to connect to the repository database because of the localhost.localdomain entry preceding the localhost entry (assuming the localhost entry exists at all).
$ ping localhost
PING localhost.localdomain (127.0.0.1) from 127.0.0.1 : 56(84) bytes of data.
64 bytes from localhost.localdomain (127.0.0.1): icmp_seq=1 ttl=255 time=0.080 ms
64 bytes from localhost.localdomain (127.0.0.1): icmp_seq=2 ttl=255 time=0.071 ms
64 bytes from localhost.localdomain (127.0.0.1): icmp_seq=3 ttl=255 time=0.044 ms
--- localhost.localdomain ping statistics ---
3 packets transmitted, 3 received, 0% loss, time 1998ms
rtt min/avg/max/mdev = 0.044/0.065/0.080/0.015 ms
5. Edit the /etc/hosts file to add a localhost entry, directly after the 127.0.0.1 entry, with the following syntax:
127.0.0.1 localhost <optional host name>
6. Save your changes and rerun the ping for localhost.