From 2eb73916539832a6b33f17bb37086fdc9cb573ea Mon Sep 17 00:00:00 2001 From: Brian Lin Date: Tue, 20 Dec 2022 15:46:30 -0600 Subject: [PATCH 1/3] Add COManage contact registration to the ToC and main doc (SOFTWARE-4758) We've been directing new contacts to do this anyway so we may as well unleash it --- docs/common/registration.md | 27 +++++++++------------------ mkdocs.yml | 4 +++- 2 files changed, 12 insertions(+), 19 deletions(-) diff --git a/docs/common/registration.md b/docs/common/registration.md index af47e4b22..9595a3094 100644 --- a/docs/common/registration.md +++ b/docs/common/registration.md @@ -23,27 +23,18 @@ The instructions in this document require the following: Registering Contacts -------------------- -The OSG keeps a database of contact information for resources, virtual organizations, and projects. -Before submitting any registrations in the topology repository, you must have an entry in the contact database with an -associated GitHub ID. -To register as an OSG contact or add your GitHub ID to your pre-existing contact entry, search for your name in the -[contact database](https://topology.opensciencegrid.org/contacts) and choose one of the following: +OSG staff keep track of contact information for OSG Consortium participants to provide access to OSG services, +notify administrators and security contacts of software and security updates, +and coordinating in case of security incidents or troubleshooting services. -!!! info "Privacy" +To register your contact information with the OSG Consortium, follow the instructions in +[this document](contact-registration.md). + +!!! info "Privacy Notice" The OSG treats any email addresses and phone numbers as confidential data but does not make any guarantees of privacy. - All other data is public, such as name, GitHub username, and any association with particular hosts or services. - -- **If you find your name and see an associated `GitHub` account**, you can start submitting registrations! -- **If you find your name but do not see an associated `GitHub` account**, send an email to - with your GitHub ID. -- **If you cannot find your name**, send an email to with the following information: - - Full name - - Primary email address - - GitHub user name - - Description of your OSG affiliation, e.g. FermiGrid site administrator, senior scientist for the DUNE experiment, - etc. - - Contact information of site, virtual organization, or project sponsor to prove your affiliation + All other data is public (such as name, GitHub username, and any association with particular services or + collaborations). Registering Resources --------------------- diff --git a/mkdocs.yml b/mkdocs.yml index 97bec90a7..2ed499822 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -19,10 +19,12 @@ extra_css: nav: - Home: 'index.md' - Site Planning: 'site-planning.md' -- Registration: 'common/registration.md' - Site Verification: 'site-verification.md' - Site Maintenance: 'site-maintenance.md' - 'Help / Security Incidents': 'common/help.md' +- Registration: + - Contact Information: 'common/contact-registration.md' + - Resources and Collaborations: 'common/registration.md' - Resource Sharing: - Compute: - 'Overview': 'resource-sharing/overview.md' From 926e7122190c69638da8c88bcfb714c3ae3c63b9 Mon Sep 17 00:00:00 2001 From: Brian Lin Date: Tue, 20 Dec 2022 15:52:28 -0600 Subject: [PATCH 2/3] VOs are dead, long live collaborations --- docs/common/registration.md | 41 ++++++++++++++++++++----------------- 1 file changed, 22 insertions(+), 19 deletions(-) diff --git a/docs/common/registration.md b/docs/common/registration.md index 9595a3094..5b27eba14 100644 --- a/docs/common/registration.md +++ b/docs/common/registration.md @@ -1,10 +1,12 @@ +DateReviewed: 2022-12-20 title: Registering in the OSG Registering in the OSG ====================== -The OSG keeps a registry containing active projects, virtual organizations (VOs), resources, and resource -downtimes stored as [YAML files](https://docs.ansible.com/ansible/latest/reference_appendices/YAMLSyntax.html) +The OSG keeps a registry containing active projects, collaborations (i.e., virtual organizations or VOs), resources, +and resource downtimes stored as +[YAML files](https://docs.ansible.com/ansible/latest/reference_appendices/YAMLSyntax.html) in the [topology GitHub repository](https://github.com/opensciencegrid/topology/). This registry is used for [accounting data](https://gracc.opensciencegrid.org), contact information, and resource availability, particularly if your site is part of the [World LHC Computing Grid](http://wlcg.web.cern.ch/) (WLCG). @@ -63,7 +65,7 @@ If you don't already know the relevant names for your resource, using the follow | Facility | Unabbreviated institution or company name, e.g. `University of Wisconsin - Madison` | | Site | Computing center or academic department, e.g. `CHTC`, `MWT2 ATLAS UC`, `San Diego Supercomputer Center`
The only characters allowed in Site names are letters, numbers, underscores, hyphens, and spaces; i.e., a Site name must match the regular expression `^[A-Za-z0-9_ -]+$` | | Resource Group | Abbreviated facility, site, and cluster name. Resource groups used for testing purposes should have an `-ITB` or `- ITB` suffix, e.g. `TCNJ-ELSA-ITB` | -| Resource | In all capital letters, `--`, for example:
`TCNJ-ELSA-CE` or `NMSU-AGGIE-GRID-SQUID`
If you don't know which VO to use, pick `OSG`. | +| Resource | In all capital letters, `--`, for example:
`TCNJ-ELSA-CE` or `NMSU-AGGIE-GRID-SQUID`
If you don't know which collaboration to use, pick `OSG`. | OSG resources are stored in the GitHub repository as YAML files under a directory structure that reflects the above hierarchy, i.e. `topology///.yaml` from the @@ -329,39 +331,40 @@ Follow the instructions below: 1. Wait for OSG staff to approve and merge your modified downtime. -Registering Virtual Organizations ---------------------------------- +Registering Collaborations +-------------------------- -Virtual Organizations (VOs) are sets of groups or individuals defined by some common cyber-infrastructure need. +Collaborations (formerly virtual organizations or VOs) are sets of groups or individuals defined by some common +cyber-infrastructure need. This can be a scientific experiment, a university campus or a distributed research effort. -A VO represents all its members and their common needs in a grid environment. -A VO also includes the group’s computing/storage resources and services. -For more information about VOs, see [this page](https://osg-htc.org/about/organization#virtual-organizations). +A collaboration represents all its members and their common needs in a grid environment. +A collaboration also includes the group’s computing/storage resources and services. +For more information about collaboration, see [this page](https://osg-htc.org/about/organization#virtual-organizations). !!! info - Before submitting a registration for a new VO, please [contact us](#getting-help) describing your organization's - computing needs. + Before submitting a registration for a new collaboration, please [contact us](#getting-help) describing your + organization's computing needs. -VO information is stored as YAML files in the `virtual-organizations` directory of the +Collaboration information is stored as YAML files in the `virtual-organizations` directory of the [topology repository](https://github.com/opensciencegrid/topology/tree/master). -To modify a VO's information or register a new VO, follow the instructions below: +To modify a collaboration's information or register a new collaboration, follow the instructions below: 1. Open the [topology repository](https://github.com/opensciencegrid/topology/tree/master/virtual-organizations) in your browser. -1. If you see your VO in the list, open the file and continue to the next step. - If you do not see your VO in the list, click `Create new file` button: +1. If you see your collaboration in the list, open the file and continue to the next step. + If you do not see your collaboration in the list, click `Create new file` button: ![GitHub file creation](../img/registration/create-file.png) - In the new file dialog, enter `.yaml`, replacing `` with the name of your VO. + In the new file dialog, enter `.yaml`, replacing `` with the name of your collaboration. !!! note ""You're editing a file in a project you don't have write access to."" If you see this message in the GitHub file editor, this is normal and it is because you do not have direct write access to the OSG copy of the topology data, which is why you are creating a pull request. 1. Make changes with the [GitHub file editor](https://docs.github.com/en/repositories/working-with-files/managing-files/editing-files) using - the [VO template](https://github.com/opensciencegrid/topology/blob/master/template-virtual-organization.yaml) + the [collaboration template](https://github.com/opensciencegrid/topology/blob/master/template-virtual-organization.yaml) as a guide. You may leave any `ID` fields blank. If you are modifying existing entries, make sure you do not change formatting or indentation of the modified entry. @@ -369,7 +372,7 @@ To modify a VO's information or register a new VO, follow the instructions below 1. Submit your changes as a pull request; select "opensciencegrid/topology" as the base repo. Provide a descriptive commit message, for example: - Updating contact information for the GLOW VO + Updating contact information for the GLOW collaboration Registering Projects -------------------- @@ -380,7 +383,7 @@ Registering Projects Project information is stored as YAML files in the `projects` directory of the [topology repository](https://github.com/opensciencegrid/topology/tree/master). -To modify a VO's information or register a new VO, follow the instructions below: +To modify a collaboration's information or register a new collaboration, follow the instructions below: 1. Open the [topology repository](https://github.com/opensciencegrid/topology/tree/master/projects) in your browser. From 12fdc3ebd492c2460104df46db67ab9bbbb84a8a Mon Sep 17 00:00:00 2001 From: Brian Lin Date: Tue, 20 Dec 2022 16:20:42 -0600 Subject: [PATCH 3/3] Fix broken link --- docs/data/stashcache/vo-data.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/data/stashcache/vo-data.md b/docs/data/stashcache/vo-data.md index 93d0364d2..3ea71101f 100644 --- a/docs/data/stashcache/vo-data.md +++ b/docs/data/stashcache/vo-data.md @@ -24,7 +24,7 @@ Requirements ------------ In order for a Virtual Organization to join the federation, the VO must already be registered in OSG Topology. -See the [registration document](../../common/registration.md#registering-virtual-organizations). +See the [registration document](../../common/registration.md#registering-collaborations).