In OmniRPC, two kinds of authentication to invoke grid-RPC on remote host are supported, Globus and SSH (Secure Shell). The installation kit of OmniRPC can be configured with our without Globus feature. To install OmniRPC with Globus feature, your system must be ready to use Globus, of which installation kit is not included in this CD-ROM. SSH authentication feature is always supported by OmniRPC in any configuration, that is, with/without Globus. So, if you are not familiar to Globus nor your system is not Globus-ready, you can install OmniRPC without Globus feature.
HMCS-G trial account only supports SSH authentication, so just for trial usage of HMCS-G, it is enough to install OmniRPC without Globus feature.
/Software/HMCS-G_Trial_Kit/libsrc
If you have installed OmniRPC as default setting, you don't have to modify OMRPCTOP term. Otherwise, modify this term in Makefile. If you want to change the directory to contain HMCS-G client API library, modify HMCSGTOP as you wish.
% makeHere you don't have to be root user.
% make installYou may have to be root user for writing files to system privileged directory.
http://www.rccp.tsukuba.ac.jp/people/Research/HMCSG/register.htmlThe registration is very simple. All you have to do is only giving your name, affiliation and valid e-mail address. Just after registered yourself, an automatic e-mail which contains the instruction to use the trial kit will be sent to the registered e-mail address. After you receive it, you can run the sample code or your own program under HMCS-G service.
After you registered yourself to our trial kit service through the web site
http://www.rccp.tsukuba.ac.jp/people/Research/HMCSG/register.htmlyou will receive an e-mail from the system to give you the private key and pass-phrase to access the special account for HMCS-G trial kit. After you get this key, prepare to run the sample codes or your own code as following steps.
% ssh-agent bash(You can specify any shell instead of bash.)
% ssh-add RSAKEYThen, the system requires you to type-in the pass-phrase for RSA authentication with this private key. The pass-phrase is also sent to you with this private key after your registration.
% ssh hmcsg@hmcs-gw.rccp.tsukuba.ac.jpThe reply from system should be something like:
Last login: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxYou cannot directly login to our HMCS-G server as shown above, but don't worry. This is correct response of the system because we don't allow any user to login our server with interactive shell.
This shell does not work as interactive login shell, sorry.
Connection to hmcs-gw.rccp.tsukuba.ac.jp closed.
If the system requires a password with following message:
hmcsg@hmcs-gw.rccp.tsukuba.ac.jp's password:It means you failed to record the pass-phrase for your given RSA private key. Maybe the private key was broken or you made a mistake to type-in pass-phrase.
There is no plain password available for this account. You have to use RSA private key to access it as described in above section.
server: hmcs-gw.rccp.tsukuba.ac.jp user: hmcsg
All client program (including sample codes) of HMCS-G is under control of OmniRPC, so all of them accept option flags for OmniRPC. These flags must be placed just after the program name in command line. So, the typical syntax of command line for HMCS-G clients is:
% program [OmniRPC-options] argument ...For SSH authentication which is available with this trial kit,
you always have to provide ``--ssh'' option as OmniRPC flag.(Be careful that the option requires two hyphens before word of "ssh".) Otherwise, OmniRPC tries to apply Globus authentication, but it is not supported by the account for trial users.
In gg6start function (see "HMCS-G client API manual") you have to specify the name of server and user account to request OmniRPC service. If the user name of you is same as that on the server, you just have to provide server host name only. However, with this trial kit the user name on server side is fixed as ``hmcsg''. Therefore, you have to specify the server name according to the syntax of SSH with user name and host name. It is
hmcsg@hmcs-gw.rccp.tsukuba.ac.jp(See "Server and Account for Trial Kit" section.)
Both sample codes require this name as an argument on command line.