Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Collect systems in a single section #129

Merged
merged 7 commits into from
Oct 21, 2019
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
58 changes: 3 additions & 55 deletions connecting/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -139,61 +139,9 @@ connection to the real X server will be made from the local machine.
Systems Available to All Projects
**********************************

After a user account has been approved and created, the requesting user
will be sent an email listing the system(s) to which the user has
requested and been given access. In addition to the system(s) listed in
the email, all users also have access to the following systems:

Home
=====

*home* is a general purpose system that can be used to log into other
OLCF systems that are not directly accessible from outside the OLCF
network. For example, running the ``screen`` or ``tmux`` utility is one
common use of Home. Compiling, data transfer, or executing long-running
or memory-intensive tasks should never be performed on Home.

Connecting to the ``home`` Host
----------------------------------

Home can be accessed through ssh: ``ssh [email protected]``

Acceptable Tasks
----------------------------------

The Home system should only be used to access systems within the OLCF
network. The following are examples of appropriate uses of Home:

- SSH
- VI and other non-gui editors
- Screen or other terminal multiplexers

Unacceptable Tasks
----------------------------------

The following are examples of inappropriate uses of Home:

- Compiling
- Data transfer
- Long-running or memory-intensive tasks

Data Transfer Nodes
========================

The *Data Transfer Nodes* (DTNs) are hosts specifically designed to provide
optimized data transfer between OLCF systems and systems outside of the OLCF
network. These nodes perform well on local-area transfers as well as the
wide-area data transfers for which they are tuned. The OLCF recommends that
users use these nodes to improve transfer speed and reduce load on computational
systems' login and service nodes.

High Performance Storage System (HPSS)
=========================================

The *High Performance Storage System (HPSS)* provides tape storage for
large amounts of data created on OLCF systems. The HPSS can be accessed
from any OLCF system through the ``hsi`` utility. More information about
using HPSS can be found on the :ref:`hpss` page.
* :ref:`home-user-guide`
* :ref:`dtn-user-guide`
* :ref:`hpss-user-guide` (Subject to Export Control restrictions)

*****************************
OLCF System Hostnames
Expand Down
16 changes: 16 additions & 0 deletions systems/ascent_user_guide.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
******
Ascent
******

System Overview
===============

Ascent is a stand-alone 18-node system with the same architecture and design
as Summit. It's most often utilized as a resource for OLCF training events,
workshops, and conferences. Ascent exists in the NCCS Open Security Enclave,
which is subject to fewer restrictions than the Moderate Security Enclave that
houses systems such as Summit. This means that participants in training events can go through a streamlined version of the approval process before being granted access.

As the Ascent user environment is almost identical to Summit, additional
information can be found in the :ref:`training-system-ascent` section of the
:ref:`summit-user-guide`.
33 changes: 33 additions & 0 deletions systems/dtn_user_guide.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
.. _dtn-user-guide:

**************************
Data Transfer Nodes (DTNs)
**************************

.. _dtn-system-overview:

System Overview
===============

The Data Transfer Nodes ("DTNs"; ``dtn.ccs.ornl.gov``) are hosts specifically
designed to provide optimized data transfer between OLCF systems and systems
outside of the OLCF network. These nodes perform well on local-area transfers
as well as the wide-area data transfers for which they are tuned. The OLCF
recommends that users use these nodes to improve transfer speed and reduce load
on computational systems’ login and service nodes.

.. _dtn-access-connecting:

Access & Connecting
===================

DTN access is automatically granted to all enabled OLCF users.

To connect to the DTNs, SSH to ``dtn.ccs.ornl.gov``. For example:

::

ssh [email protected]

For more information on connecting to OLCF resources, see
:ref:`connecting-to-olcf`.
56 changes: 56 additions & 0 deletions systems/home_user_guide.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
.. _home-user-guide:

***********
Home
***********

.. _home-system-overview:

System Overview
===============

``home.ccs.ornl.gov`` (Home) is a general purpose system that can be used to
log into other OLCF systems that are not directly accessible from outside the
OLCF network. For example, running the ``screen`` or ``tmux`` utility is one
common use of Home. Compiling, data transfer, or executing long-running or
memory-intensive tasks should never be performed on Home.


.. _home-access-connecting:

Access & Connecting
===================

Home access is automatically granted to all enabled OLCF users.

To connect to Home, SSH to ``home.ccs.ornl.gov``. For example:

::

ssh [email protected]

For more information on connecting to OLCF resources, see
:ref:`connecting-to-olcf`.

Usage
===========

Acceptable Tasks
----------------

The Home system should only be used to access systems within the OLCF network.
The following are examples of appropriate uses of Home:

* RSA SecurID Token setup
* SSH
* Vi and other non-GUI editors
* Screen or other terminal multiplexers

Unacceptable Tasks
------------------

The following are examples of inappropriate uses of Home:

* Compiling
* Data Transfers
* Long-running or memory-intensive processes
15 changes: 15 additions & 0 deletions systems/hpss_user_guide.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
.. _hpss-user-guide:

*******************************
High Performance Storage System
*******************************

.. _hpss-system-overview:

System Overview
===============

The High Performance Storage System (HPSS) provides tape storage for large
amounts of data created on OLCF systems. The HPSS can be accessed from any OLCF
system through the ``hsi`` utility. More information about using HPSS can be found
on the :ref:`hpss` page.
12 changes: 8 additions & 4 deletions systems/index.rst
Original file line number Diff line number Diff line change
@@ -1,12 +1,16 @@
.. _system-user-guides:

###################
System User Guides
###################
#######
Systems
#######

.. toctree::
:maxdepth: 2

summit_user_guide
rhea_user_guide
summitdev_user_guide
rhea_user_guide
home_user_guide
dtn_user_guide
hpss_user_guide
ascent_user_guide
4 changes: 2 additions & 2 deletions systems/rhea_user_guide.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@
Rhea User Guide
*********************

Overview
=========
System Overview
===============

Rhea is a 521-node commodity-type linux cluster. The primary purpose of rhea is
to provide a conduit for large-scale scientific discovery via pre/post
Expand Down