The User Agent is the component of the ShareGrid architecture that allows a machine to share its resources with the grid. When a machine is running a correctly installed and configured User Agent, then its compute, storage, and network resources become available to applications submitted to the grid via ShareGrid’s user-frontend MyGrid.
Requirements
- user account – you must have an account on the machine on which you want to install User Agent
- disk space – you will need 800KBs for the installation plus additional space for log files
- operating system – Linux or Microsoft Windows (2k or XP).
- Java – version 1.5 or later
- tools – decompression tools (i.e. tar/gzip/gunzip)
Before to start
- Check the Java version installed on User Agent machine doing:java -version
- If User Agent machine is behind a firewall be sure that it is possible to estabilsh and to accept connections to/from your Peer machine
Installation
- Download ShareGridUA.tgz 743.51 Kb
- cd userAgentSG/
- Edit the ua.properties file and update the ua.name and ua.port properties to reflect your local configuration.
- The default values for all other properties should be OK.
Test your installation
After ua.properties customization, you can start the UserAgent by typing:
- userAgentSG/useragent start
if successful, you will see the following message:
Starting User Agent…
Then, running the following command:
- userAgentSG/useragent status
you should see the following message:
Checking user agent status…
Gum is: [ UP ]
Installation for the execution at machine boot time (optional)
This section let you configure your system in order to run the userAgentSG at machine boot time. The following instructions apply only to Linux operating systems.
- Download and unzip the archive for the companion script rc.userAgentSG: rc.userAgentSG.zip [4.82KB]
- Inside the rc.userAgentSG script, change the name of the user used for running the userAgentSG program.
[Default: user=sharegrid]
If the default value is not for you, you need to change the $user variable inside the rc.userAgentSG script. - Inside the rc.userAgentSG script, change the path to the userAgentSG program.
[Default: useragent="/home/$user/shareGrid/userAgentSG/useragent"]
If the default value is not for you, you need to change the $useragent variable inside the rc.userAgentSG script. - Gain root privileges.
Log-in as root user or, alternatively, use the sudo command. - Add the script in the ‘start-up script’ directory of your operating system.
This location is operating-system dependent. In many Linux operating systems it is typically named ‘/etc/init.d’. If this is your case, simply run:cp rc.userAgentSG /etc/init.d/.
Otherwise, refer to your operating system administration guide.
- Change the script attributes.
In order to execute the script, you need to add the execution attribute:chmod u+x /etc/init.d/rc.userAgentSG
- Tell your operating system to run the script at boot time.
If you run a RedHat-like operating system, you can simply run the following command:chkconfig –add rc.userAgentSG
If not, please consult your operating system administration guide.
- Test your installation by running (with ‘root’ privileges):
/etc/init.d/rc.userAgentSG start
If the output shows the message OK, the installation is done. Otherwise, try to repeat the installation steps (maybe using the detailed instructions contained inside the rc.userAgentSG.README file).
That’s all folks!
Your User Agent is successfully installed and configured. After approximately 10 minutes, you should be able to see it on the ShareGrid status page here . More details concerning the User Agent role can be found here .
