Chapter 2. Clients

Users use the client program to monitor and control resources.

2.1. Installing and Configuring a Client

The following are the necessary steps to install and configure a client. For most of these steps, you must be root on the machine you are configuring.

  1. Use yum to download and install the Tycoon RPMs. The exact command varies depending on the distribution that you are using. For later Redhat Enterprise Linux derived distributions (including Scientific Linux and CentOS), use following:

    [root@alicehost ~]# yum -y -c \
    http://tycoon.hpl.hp.com/~tycoon/dl/yum/tycoon_el.repo install tycoon_client
    

    For Fedora Core, use the following:

    [root@alicehost ~]# yum -y -c \
    http://tycoon.hpl.hp.com/~tycoon/dl/yum/tycoon_fc.repo install tycoon_client
    

    Some older distributions require downloading the repo file separately:

    [root@alicehost ~]# cd /etc/yum.repos.d
    [root@alicehost ~]# wget http://tycoon.hpl.hp.com/~tycoon/dl/yum/tycoon_el.repo
    [root@alicehost ~]# yum -y install tycoon_client
    

    This outputs the following (the version numbers will vary):

    
    Setting up Install Process
    Setting up Repos
    .
    .
    .
    Installed: tycoon_client.noarch 0:0.3.0p27-1
    Dependency Updated: KL.noarch 0:0.3.0p8-1 tycoon.noarch 0:0.3.0p27-1
    Complete!
    
    

    Once the client has been successfully installed, use the following command periodically to update the client:

    [root@alicehost ~]# yum -y update tycoon_client
    
  2. If you have not already done so, follow the directions in the Tycoon User's Manual to create a Tycoon bank account.

  3. Verify that the client has been installed correctly and can connect to the service location service. Using a shell owned by the local user account that you used to create the Tycoon bank account in step 2, type the following:

    [asmith@alicehost ~]# tycoon get_host_list
    
    

    This outputs the following:

    
    IP Address
    ----------
    1.2.3.4
    .
    .
    .
    
    
  4. Verify the connection to the bank. Using you used to create the Tycoon bank account in step 2, type the following:

    [asmith@alicehost ~]# tycoon bank get_balance 
    

    This outputs the following:

    
    Account balance: 1
    
    
  5. Verify the connection to one of the auctioneers. Using the bank account that you created in step 2, type the following, replacing host_name with one of the host names or IP addresses listed in step 3:

    [asmith@alicehost ~]# tycoon host get_status host_name owner_account
    

    This outputs the following:

    
    ip_address: 1.2.3.4 owner_account: bob
    
    

Assuming that all went well, the client is now installed and configured. For documentation on how to use and configure the client, see the Tycoon User's Manual.