Registration and Login for OSG Connect

(An abbreviated version of these signup instructions is provided when you choose signup from the OSG Connect main site. This section of the Help Desk provides more comprehensive information about the registration process, but the shortened step-by-step guide is perhaps easier to follow.)

Overview of access procedure

The Open Science Grid governs access to grid resources through an accounting framework that assigns each user's jobs to an accounting group or project. As a new user of the OSG, one of the first things to iron out is what project or projects best describe your work.  This is more a matter of accountability than of entitlement: it concerns how organizations report to their sponsors and funding agencies on the utilization of resources placed under their administration.

To assist in this, OSG Connect uses a group management tool that places users into one or more groups with names such as osg.RDCEP or osg.Extenci. The osg portion of this name differentiates our groups from those of other organizations in the same group management facility. The latter portion identifies the specific project, each with a Principal Investigator or other administrator, that oversees access to resources. Within our web tools, these names are often in mixed case, though you may see them uppercased in some reporting/accounting software.

The first step in registration is to create a user account and bind it to other identity information. After that you will enroll in a project group.

Once you've enrolled in a group, you'll have the requisite rights to log in to the submit node for the OSG Connect job scheduler, or to transfer data in and out of Stash. Submit node logins are typically via Secure Shell (SSH) using a password or a public key. We'll discuss how to connect further on. Stash access is possible from the submit node and through Globus transfer or using HTTP to a public space within your Stash.

Sign in to or create an account

Before enrolling in a project you must have an account in the identity management framework. Visit the OSG Connect web site, then select Sign In/Sign Up ▸ Sign up as a new user. There are a few paths forward from here, but all end up with linking your OSG Connect identity with a Globus identity. This not only provides integrated identity service, it also enables you to begin performing data transfers to OSG Connect very early on, with a minimal fuss, using Globus transfer.

Globus Registration

If your institution is not linked to CILogon, you can sign in with a Globus identity instead. Click on Sign Up with Globus. If you already have a Globus account, click Already a member? Sign In to sign in now. Otherwise, provide your name, email address, and a username and password to register a new account. Your OSG Connect identity will piggyback from here.

Using Globus ID (existing) Using Globus (new)
Click Sign Up with Globus, then Already a member? Sign In Click Sign Up with Globus.
Enter Globus username and password. Enter Name, Email, Username, Password.
Await validation email, use link to confirm.
Go to the Join group workflow. Go to the Join group workflow.

After CILogon signin, you should find yourself at a portal.osgconnect.net screen that deals with Globus ID. If you don't have a Globus account already, skip this section. Click on Create a new Globus account and move on to the next section.

If you have a Globus account, go ahead and sign in. This will link your account information together, allowing you to sign in using your InCommon ID or any other ID that you link in the future. Otherwise, create one now.

Create a new Globus account

If you need to create a new account, it's mostly straightforward. At this time you'll only need to provide your name, email address, a username you want to use, and a password. You will also need to validate your email address.  You should quickly receive an email from support@globus.org with a subject of Globus - Confirm Email Address. Wait for it now: the link in that email will resume the registration workflow. Then wait a moment for your account to be created. Then move to the Join group workflow below.

Join group

You'll see some activity in the browser as you automatically join the osg community, and you may need to provide some additional personal information: a Field of Science, aDepartment, an Institution, and a Phone Number.  Finally you'll land on the Manage Identities screen.  Move on to Add an SSH key.

Generate and Add an SSH key

Please visit this page for step by step instructions to generate and adding an SSH key

Join a project

Congratulations! You're now signed up, and you have all the accounts that you'll need. A critical step remains, though, before you can begin computing. You've now joined the OSG Connect community, which gives you visibility of the various projects associated with OSG Connect. To begin working in the facility, or using the Stash service for file storage,  you'll need to join one (or more) of them.

You may already know what project(s) you need to join, go to the OSG Connect web site and select the Connect ▸ Join a Project menu item to see a list of currently active projects.(If you're a PI, and your project is not shown, let us know. Details on setting up a new project in OSG Connect are shown elsewhere in the ConnnectBook.)

Once you've found a project to join, simply click on its name at the left of your screen, and then on Join Now at the lower right. On receiving your request, SG Connect staff will request authorization from the PI or designated representative. Upon acceptance, you will automatically be granted all access to submit node and to Stash. On the submit node, you'll be a member of a UNIX group representing the project. And, in addition to your personal stash, the project will have its own group stash for shared data.

For our workshops, we readily admit attendees into the osg.ConnectTrain project. Even if you have no other project at this time, we can bring you in for the short term to learn more about OSG Connect. After the workshop, please feel free and ready to discuss creation of projects to more closely accommodate your work.

Ready?

Having stepped through these procedures and joined an osg.* project group, you have all the roles and access that you need to continue working. There can be some delay for project membership approval, but aside from that access rights are generally implemented in the OSG Connect servers within minutes. Take a moment if you need to, then we'll move on to basic high-throughput (HT) job submission using HTCondor.

 

This page was updated on Dec 16, 2018 at 19:00 from registration-and-login.md.