Installing MyProxy

National Center for Supercomputing Applications

University of Illinois at Urbana-Champaign

MyProxy is most easily installed from the Virtual Data Toolkit (VDT) or the Globus Toolkit (GT). We recommend proceeding to the VDT or GT pages for installation instructions and downloads.

This page documents the procedure for adding or upgrading MyProxy for an existing Globus Toolkit installation. Java versions of the MyProxy clients are also available as part of Java CoG Kit distribution which is available at http://www.globus.org/cog/. The Grid Portal Development Kit provides a portal development environment with a MyProxy Java bean that uses the Java CoG Kit MyProxy clients. Also, the Grid Portal Toolkit interfaces with MyProxy using the Perl CoG Kit.

If you're installing a MyProxy server, please review the MyProxy Administrator's Guide before proceeding.

Step 1: Install a Clock Synchronization Service

The most common cause of MyProxy authentication problems is incorrect system clocks. GSI authentication is very sensitive to clock skew. You must run a system clock synchronization service of some type on your system to prevent authentication problems caused by incorrect system clocks. We recommend NTP. Please refer to your operating system documentation or the NTP Home Page for installation instructions. Please also ensure your system timezone is set correctly.

Step 2: Download a MyProxy GPT Package

Download a MyProxy GPT package from the MyProxy download page. Please review the compatibility statements on the download page to choose a MyProxy version that fits your needs.

Step 3: Prepare for Upgrade

If you are running the myproxy-server as a daemon on your system, shut it down before proceeding. For example, if you installed a myproxy init.d script, you can shutdown the myproxy-server with:

/etc/rc.d/init.d/myproxy stop

or the equivalent for your operating system.

Step 4: Install the MyProxy GPT Package

Set the GLOBUS_LOCATION environment variable (if you haven't already) to the directory where you installed the Globus Toolkit. Set the GPT_LOCATION environment variable to the location of your GPT installation. (GPT_LOCATION and GLOBUS_LOCATION may be the same.) Following the instructions below will install MyProxy to $GLOBUS_LOCATION.

All GPT software must be installed in the location specified by the GLOBUS_LOCATION environment variable, so if you plan to use multiple GPT packages, you should install them all to the same location.

Choose a Globus flavor for your MyProxy installation that matches your installed Globus libraries. The following command will show the flavors you have installed:

$GPT_LOCATION/sbin/gpt-query globus_gssapi_gsi

For example:

$ $GPT_LOCATION/sbin/gpt-query globus_gssapi_gsi 4 packages were found in /usr/local/globus that matched your query: packages found that matched your query globus_gssapi_gsi-gcc32dbg-dev ver: 3.13 cmp id: 3.13.0 globus_gssapi_gsi-gcc32dbg-rtl ver: 3.13 cmp id: 3.13.0 globus_gssapi_gsi-gcc32dbgpthr-dev ver: 3.13 cmp id: 3.13.0 globus_gssapi_gsi-gcc32dbgpthr-rtl ver: 3.13 cmp id: 3.13.0

In this example, the gcc32dbg and gcc32dbgpthr flavors are available. We recommend using a flavor not containing thr so in this example flavor gcc32dbg should be used.

Then, uninstall any existing MyProxy packages with the following command:

$GPT_LOCATION/sbin/gpt-uninstall myproxy

Finally, install the MyProxy package with the following command:

$GPT_LOCATION/sbin/gpt-build -force -verbose myproxy*.tar.gz <flavor>

replacing <flavor> with the Globus flavor of your choice.

Step 5: Complete the Upgrade

If you shutdown a running myproxy-server in step 3, you can restart it now. For example:

/etc/rc.d/init.d/myproxy start

Installation Complete

This completes the installation of the MyProxy client tools. To use the MyProxy client tools, you must set up your Globus environment. Set the GLOBUS_LOCATION environment variable to the location of your MyProxy installation. Then, depending on your shell, run one of the following commands.

For csh shells:

source $GLOBUS_LOCATION/etc/globus-user-env.csh

For sh shells:

. $GLOBUS_LOCATION/etc/globus-user-env.sh

For additional documentation of the MyProxy client tools, please see the MyProxy User's Guide.

To configure a MyProxy server, please see the Server Installation Guide.

Please submit MyProxy bug reports to Bugzilla. Please consult the Troubleshooting Guide before reporting a problem.