Skip to content

Commit

Permalink
[ci skip] Autodoc commit for e54825c020aa6d67f0c650bfa2abe47ab3c9a7cc.
Browse files Browse the repository at this point in the history
  • Loading branch information
oscwiag committed Nov 19, 2024
1 parent e9734e7 commit 3f69e27
Show file tree
Hide file tree
Showing 11 changed files with 49 additions and 49 deletions.
18 changes: 9 additions & 9 deletions develop/_sources/customizations.rst.txt
Original file line number Diff line number Diff line change
Expand Up @@ -20,15 +20,15 @@ So, for example, if you wished to disable the file browser you would simply
change it's directory to 700 so it's unreadable by regular users.

When this directory is unreadable by regular users, the functionality
it provides will be disabeled.
it provides will be disabled.

.. code-block:: sh
sudo chmod 700 /var/www/ood/apps/sys/files
Alternatively, if you wished to limit acess you can do so through group
Alternatively, if you wished to limit access you can do so through group
permissions. For example, if you wanted to limit access to the file browser
to only memebers in the Unix group ``staff``, you would simply apply the
to only members in the Unix group ``staff``, you would simply apply the
applicable file permission such that anonymous users cannot access the
directory while members of the ``staff`` Unix group can.

Expand Down Expand Up @@ -80,7 +80,7 @@ Because the announcement is rendered via ERB you can do some interesting things,
msg: |
<% if Time.now < Time.new(2018, 9, 24, 12, 0, 0) %>
A **Ruby Partial Downtime** for 4 hours on Monday, September 24 from 8:00am to 12:00pm
will prevent SSH login to Ruby nodes and and Ruby VDI sessions.
will prevent SSH login to Ruby nodes and Ruby VDI sessions.
<% end %>
.. note:: Warnings about the announcement file being missing may be present in users' nginx logs. Despite the warning the Dashboard will still function normally without those files being present.
Expand All @@ -105,7 +105,7 @@ To display a MOTD file on the Dashboard ensure that the environment variables ``
The ``_erb`` formats support ERB rendering to generate more dynamic messages.

.. warning::
Some MOTD formats like ``rss``, ``markdown`` and ``markdown_erb`` can contain malicous
Some MOTD formats like ``rss``, ``markdown`` and ``markdown_erb`` can contain malicious
HTML content. For your safety, by default, the Open OnDemand system will not render
HTML. We provide :ref:`a configuration to enable HTML rendering in MOTD <motd_render_html>`
should you need to render HTML.
Expand Down Expand Up @@ -797,7 +797,7 @@ Full examples are below:
# pin any app with an exact match on the metadata field_of_science of biology
- field_of_science: 'biology'
# pin any app with an glob match *bio* on the metadata field_of_science
# pin any app with a glob match *bio* on the metadata field_of_science
- field_of_science: '*bio*'
Expand Down Expand Up @@ -849,7 +849,7 @@ Custom layouts in the dashboard
-------------------------------

Administrators can now customize what widgets appear on the dashboard and how they're
layed out on the page.
laid out on the page.

In it's simplest form this feature allows for a rearrangement of existing widgets. As
of 2.1 the existing widgets are:
Expand Down Expand Up @@ -1215,7 +1215,7 @@ Grafana support

It's possible to display Grafana graphs within the ActiveJobs app when a user expands a given job.

Grafana must be configured to support embedded panels and at this time it is also required to have a anonymous organization. Below are configuration options are needed to support displaying Grafana panels in ActiveJobs. Adjust `org_name` to match whatever organization you wish to be anonymous.
Grafana must be configured to support embedded panels and at this time it is also required to have an anonymous organization. Below are configuration options are needed to support displaying Grafana panels in ActiveJobs. Adjust `org_name` to match whatever organization you wish to be anonymous.

.. warning::

Expand Down Expand Up @@ -1478,4 +1478,4 @@ For completed sessions, the system will only show the delete button.
.. include:: customizations/support-ticket.inc

.. _OSC's rclone documentation: https://www.osc.edu/resources/getting_started/howto/howto_use_rclone_to_upload_data
.. _2.0 documentation for controling the navbar: https://osc.github.io/ood-documentation/release-2.0/customization.html#control-which-apps-appear-in-the-dashboard-navbar
.. _2.0 documentation for controlling the navbar: https://osc.github.io/ood-documentation/release-2.0/customization.html#control-which-apps-appear-in-the-dashboard-navbar
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Debugging Interactive Apps
Log location
------------

:ref:`Information about interative app log location. <interactive-app-logs>`
:ref:`Information about interactive app log location. <interactive-app-logs>`


App completes without being able to connect to it.
Expand Down
6 changes: 3 additions & 3 deletions develop/_sources/how-tos/monitoring/logging.rst.txt
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ There are two locations to check depending on what information is needed:

:file:`/var/log/httpd/<hostname>_access.log`

- Where OnDemand will log succsseful logins.
- Where OnDemand will log successful logins.

.. warning::

Expand All @@ -46,7 +46,7 @@ There are two locations to check depending on what information is needed:
The NGINX logs are the output of the user :ref:`PUN <glossary>`. These logs will capture things relevant
to a *particular user* such as:

- Debuggin issues related to job submissions for a user. For example, commands being issued to the scheduler
- Debugging issues related to job submissions for a user. For example, commands being issued to the scheduler
(``sbatch``, ``qsub``, etc) can be seen here by searching for ``execve``.
- Issues related to PUNs crashing and/or pages not rendering correctly.

Expand All @@ -72,7 +72,7 @@ information they may need there as well for connections and errors.
.. note::

The files will be *owned by the user* and so admins will need to ensure they are either
able to substitue user or escalate to root in order to see these files.
able to substitute user or escalate to root in order to see these files.

In general the session data or job submission files for apps across the dashboard, such as the Job Composer,
Batch Connect, or Frame-renderer, all start from the root of:
Expand Down
4 changes: 2 additions & 2 deletions develop/_sources/installation/cluster-config-schema.rst.txt
Original file line number Diff line number Diff line change
Expand Up @@ -112,7 +112,7 @@ The job mapping is specific to a cluster's resource manager.
bin_overrides:
--------------

`bin_overrides` adds the ability for a site to specify full paths to alternatives to the configured resource manager's client executables. This advanced feature allows a site considerable flexibilty to write wrappers to handle logging, environment or default setting, or use 3rd party API compatible alternative clients without having to alter the resource manager installation.
`bin_overrides` adds the ability for a site to specify full paths to alternatives to the configured resource manager's client executables. This advanced feature allows a site considerable flexibility to write wrappers to handle logging, environment or default setting, or use 3rd party API compatible alternative clients without having to alter the resource manager installation.

.. warning ::
`bin_overrides` is an advanced feature. OOD relies both on return codes from clients, and on parsing the standard output in order to get information about submitted jobs. Care and testing is recommended.
Expand Down Expand Up @@ -210,4 +210,4 @@ An example config file in ``ondemand.d/pitzer_01_login.yml``:
host: "pitzer-login01.hpc.osu.edu"
Again, the thing to note here is we've left off the ``v2.job`` which renders the cluster useable only for logins, i.e.
*no jobs will be scheduleable on this cluster.*
*no jobs will be scheduleable on this cluster.*
8 changes: 4 additions & 4 deletions develop/_sources/installation/resource-manager/slurm.rst.txt
Original file line number Diff line number Diff line change
Expand Up @@ -8,10 +8,10 @@ cluster looks like:

.. warning::
Open OnDemand's Slurm support defaults to issuing CLI commands with
the ``--export`` flag set to ``NONE``, when Slurms default is ``ALL``.
the ``--export`` flag set to ``NONE``, when Slurm's default is ``ALL``.
This can cause issues with jobs that require ``srun``.

Work arounds are currently to ``export SLURM_EXPORT_ENV=ALL``
Workarounds are currently to ``export SLURM_EXPORT_ENV=ALL``
in a :ref:`script_wrapper <script_wrapper>` before any job scripts run.

Alternatively, you can use ``copy_environment`` below with the caveat
Expand Down Expand Up @@ -48,7 +48,7 @@ cluster

.. warning::
Using the ``cluster`` option is discouraged. This is because maintenance
outages on the Slurm database will propogate to Open OnDemand. Instead sites
outages on the Slurm database will propagate to Open OnDemand. Instead sites
should use different ``conf`` files for each cluster to limit maintenance outages.
bin
The path to the Slurm client installation binaries.
Expand All @@ -67,7 +67,7 @@ bin_overrides
- `scancel`

copy_environment
Copies the enviornment of the PUN when issuing CLI commands. Default behaviour
Copies the environment of the PUN when issuing CLI commands. Default behaviour
for Open OnDemand is to use ``--export=NONE`` flag. Setting this to true will
cause Open OnDemand to issue CLI commands with ``--export=ALL``. Though this may
cause issues as the PUN's environment is very different than a regular shell session.
Expand Down
Loading

0 comments on commit 3f69e27

Please sign in to comment.