###########################
Administration
###########################


As an administrator, you extra capabilities can be explored on your page at the top right corner. Click on your name to view the drop-down administration menu. In this tutorial, we'll cover the important aspects of your administrator functions. 

.. thumbnail:: /_images/Images/Administration/Administration_AdministrationMenu.png
   :title:
   
   Administrative Menu

.. centered:: :sup:`Figure 1: Administrative Menu`

|

**What Will Be Covered:**

* Users
* Adding a User
* User Logins
* Roles
* Teams
* HPC Servers
* Editing HPC Servers
* HPC Utilization
* All Settings
* Post Processors 
* LDAP Settings
* Logs
* Lucy Docs


**********
Users
**********

Click on the Users option in the Administrative Menu to get started. 

.. thumbnail:: /_images/Images/Administration/Administration_UsersMenu.png
   :width: 200px
   :title:
   
   Users Option

.. centered:: :sup:`Figure 2: Users Option`

|

The users section shows you thumbnail views of all users under your administration. You can perform actions such as edit, view or impersonate on individual users. 

.. thumbnail:: /_images/Images/Administration/Administration_UsersHome.png
   :title:
   
   All Users

.. centered:: :sup:`Figure 3: All Users`

|

*Where Am I?*

.. thumbnail:: /_images/Images/Administration/Administration_WhereAmI.png
   :width: 100px
   :title:

   Where Am I?

Add User
========

Click on “Add User” at the top right to create another user. The window for creating or editing a user is basically the same. Here, you can choose a role for the user.

.. thumbnail:: /_images/Images/Administration/Administration_CreateUser.png
   :title:
   
   Add User

.. centered:: :sup:`Figure 4: Add User`

|

User Logins
===========

Click on “Logins” on the grey bar next to “Table” to see which users logged onto the platform on particular dates. 

.. thumbnail:: /_images/Images/Administration/Administration_UserLogins.png
   :title:
   
   User Logins

.. centered:: :sup:`Figure 5: User Logins`

|

Below video shows how to add user and manage them.

.. video:: _static/movies/adminitrationusers.mp4
   :width: 100%

|


************
Roles
************

Roles make it easier assign permissions to users. You can give reading or writing capabilities to a particular role and give that role to certain users. 

Click on the Roles option in the Administrative Menu to get started. 

.. thumbnail:: /_images/Images/Administration_RolesMenu.png
   :width: 200px
   :title:
   
   Roles Option

.. centered:: :sup:`Figure 6: Roles Option`

|

New Role
========

Click on ”New Role”. Make sure to give a new role a name and description as well as set reading and writing capabilities for the options.

.. thumbnail:: /_images/Images/Administration_Roles.png
   :title:
   
   Create a New Role

.. centered:: :sup:`Figure 7: Create a New Role`

|



Roles with Applications and Permisisons.

Applications with Permissions can be added to Roles and users can be assigned to the Roles while creating or while editing a Role

     
.. thumbnail:: /_images/Images/permissionsapplicationsroles.png
   :title:
   
   Create a New Role
   
|
|   

Each role in the page will show the count of Applications and Users.

.. thumbnail:: /_images/Images/permissionscountwithusers.png
   :title:
   
   Count of Users and Applications
   
|
|   


Right context menu options like Edit, Meta data , Inhert role and Delete options are available for Roles.

.. thumbnail:: /_images/Images/contextmenuoptionsroles.png
   :title:
   
   Context menu options
   
|
|   



Users with Application Permissions
========================================

The User will be seeing only the applications available in roles with respective permissions.

.. thumbnail:: /_images/Images/applicationsuserpermisisons.png
   :title:
   
   Applications and Permissions
   
|
|   

Metadata
===============

Metadata for each Role is now viewable in the sidebar, including permissions and associated users, by clicking on the Role’s name.

.. thumbnail:: /_images/Images/mtadatarolesidebar.png
   :title:
   
   Metadata 
   
|
|   

Merge Role
============

Selecting two roles now shows a new “Merge” option, allowing you to combine their users and permissions into a single role.

.. thumbnail:: /_images/Images/mergerolestwo.png
   :title:
   
   Merge Roles
   
|
|  




************
Teams
************

You can organize your users into teams. Replicate your office or labs' teams onto the platform so you can stay more focused and efficient.

Click on the Teams option in the Administrative Menu to get started. 

.. thumbnail:: /_images/Images/Administration/Administration_TeamsMenu.png
   :width: 200px
   :title:
   
   Teams Option

.. centered:: :sup:`Figure 8: Teams Option`

|

Add Team
========

Click on "Add Team" at the top right corner to create another team. In the new window, choose a name, description and users to populate you team. 

.. thumbnail:: /_images/Images/Administration/Administration_Teams.png
   :title:
   
   Add a Team

.. centered:: :sup:`Figure 9: Add a Team`

|

*Where Am I?*

.. thumbnail:: /_images/Images/Administration/Administration_WhereAmI.png
   :width: 100px
   :title:

   Where Am I?


************
HPC Servers
************

Click on the HPC Servers option in the Administrative Menu to get started. 

.. thumbnail:: /_images/Images/Administration_HPCServersMenu1edit.png
   :width: 200px
   :title:
   
   HPC Servers Option

.. centered:: :sup:`HPC Servers Option`

|

View thumbnails of all your HPC servers and perform actions on them such as viewing utilization, editing, duplicating, exporting or deleting. 

.. thumbnail:: /_images/Images/Administration/Administration_HPCServers1.png
   :title:
   
   All HPC Servers

.. centered:: :sup:`Figure 11: All HPC Servers`

|

*Where Am I?*

.. thumbnail:: /_images/Images/Administration/Administration_WhereAmI.png
   :width: 100px
   :title:

   Where Am I?

Add an HPC Server
=================

Click on ”Add Server” at the top to start a new HPC server configuration.

.. thumbnail:: /_images/Images/Administration_HPCServersMenu1edit.png
   :width: 200px
   :title:
   
   HPC Servers Option

.. centered:: :sup:`HPC Servers Option`

|

Basic Information

Two new options are available in the Basic Information section (top-right corner) to import data for creating HPC servers.

Two new options are available in the **Basic Information** section (top-right corner) to import data for creating HPC servers.

The available options are:

1. **Import from Saved Configuration**  
   Imports server details from a previously saved configuration.

2. **Import from Existing Server**  
   Imports server details from an already configured server.
   
.. thumbnail:: /_images/Images/basicinforaddserversadd1.png
   :title:
   
   Basic Information Import Options

.. centered:: :sup:`Basic Information Import Options`

|   

Fill details like Name of the server, Hostname, IP Address , Operating system, Scheduler, Scheduler Binary path, Min/Max and Default CPU cores, Cores per compute server and click on Next after adding information.

.. thumbnail:: /_images/Images/basicinforaddservers1.png
   :title:
   
   Basic Information

.. centered:: :sup:`Basic Information`

|

Directories

Provide the Lucy Folder path, Stage Directory path (where simulation data and files will be created), and Compute Execution Base Directory path for the HPC server, then click Next to proceed.


.. thumbnail:: /_images/Images/directorieshpcservers1.png
   :title:
   
   Directories

.. centered:: :sup:`Directories`

|

Queues

Add Queues with Cores information and proceed to next step

.. thumbnail:: /_images/Images/queuescoresinforhpcserveres1.png
   :title:
   
   Queues

.. centered:: :sup:`Queues`

|

Interconnects

1. Interconnects in HPC servers are high-speed networking technologies used to connect compute nodes within an HPC cluster.

2. They enable low-latency and high-bandwidth communication between servers, which is essential for parallel computing workloads.

.. thumbnail:: /_images/Images/interconnectshpcservers1.png
   :title:
   
   HPC Servers Interconnects

.. centered:: :sup:`HPC Servers Interconnects`

|

Solver Configuration

All Attributes are shown in this step, and each attribute can be edited using the edit icon available on the right side of the attribute. We can add new Attribute by clicking on Add button available in top right header

.. thumbnail:: /_images/Images/solverconfigurationhpcservers1.png
   :title:
   
   Solver Configuration

.. centered:: :sup:`Solver Configuration`

|

Adding an Attribute

Add information in the attribute inputs and click on apply changes at the end to save the attribute

.. thumbnail:: /_images/Images/addingattributehpcservers1.png
   :title:
   
   Adding an Attribute

.. centered:: :sup:`Adding an Attribute`

|

Edit Solver_Version

Click Edit icon to edit “solver_version”. The value provided need to match the version names in the LUCY.JSON file

.. thumbnail:: /_images/Images/solverversionedit1.png
   :title:
   
   Editing an Attribute

.. centered:: :sup:`Editing an Attribute`

|

Solvers configurations

.. thumbnail:: /_images/Images/solverconfigurationshpcservers.png
   :title:
   
   Solvers configurations

.. centered:: :sup:`Solvers configurations`

|

Submit Command

Add Submit command and Submit template information and proceed to next step

.. thumbnail:: /_images/Images/submitcommandssolvers12.png
   :title:
   
   Submit Command

.. centered:: :sup:`Submit Command`

|

Key or Regular Expression for JOBID Extraction
Submitted batch job (\d+)
This pattern should match the Slurm output

.. thumbnail:: /_images/Images/submitcommandssolvers1.png
   :title:
   
   Submit Command

.. centered:: :sup:`Submit Command`

|

Job Commands

Provide all required JOB commands that are helpful in submitting a Job and proceed to next step

.. thumbnail:: /_images/Images/jobcommandssolvers1edit.png
   :title:
   
   Job Command

.. centered:: :sup:`Job Command`

|

Server Routing

Next, we can navigate directly to Server Routing step and Provide Routing policies.

.. thumbnail:: /_images/Images/serverroutinghpcserversedit.png
   :title:
   
   Server Routing

.. centered:: :sup:`Server Routing`

| 

Environmental Variables

.. thumbnail:: /_images/Images/serverenvironmentalvariables.png
   :title:
   
   Environmental variables

.. centered:: :sup:`Environmental variables`

| 

File Browser

Go to the File browser step and add Browser remote and Transfer commands and click on next step

.. thumbnail:: /_images/Images/filebrowseraddtransfoeredit.png
   :title:
   
   File Browser

.. centered:: :sup:`File Browser`

| 

Submit Hosts

Add the Submission Hosts information and proceed to next step


.. thumbnail:: /_images/Images/submithosts12hpcserversedit.png
   :title:
   
   Submit Hosts

.. centered:: :sup:`Submit Hosts`

| 
|


Regions

In Regions step, the user can configure the regions information

.. thumbnail:: /_images/Images/regionsstepedit.png
   :title:
   
   Regions

.. centered:: :sup:`Regions`

| 
|

Bursting Configuration

.. thumbnail:: /_images/Images/burstingconfigurations.png
   :title:
   
   Bursting Configuration

.. centered:: :sup:`Bursting Configuration`

| 
|

Utilization

Provide the paths for the storage of server usage information

.. thumbnail:: /_images/Images/utilizationhpcservers1edit.png
   :title:
   
   Utilization

.. centered:: :sup:`Utilization`

| 
|

Data pruner types

Add File Pruner Definitions and proceed to next step


.. thumbnail:: /_images/Images/filesprunertypedata.png
   :title:
   
   File pruner types

.. centered:: :sup:`File pruner types`

| 
|

.. thumbnail:: /_images/Images/filesprunertypedataedit.png
   :title:
   
   File pruner types

.. centered:: :sup:`File pruner types`

| 
|

General settings

The Last Step is the Include the general settings as per the users required and click on Save and Close button

.. thumbnail:: /_images/Images/generalsettingshpcserveredit.png
   :title:
   
   General settings

.. centered:: :sup:`General settings`

| 
|

HPC Server saved in Home page

.. thumbnail:: /_images/Images/hpcserversavedinhomepageedit.png
   :title:
   
   HPC Server saved in Home page

.. centered:: :sup:`HPC Server saved in Home page`

| 
|

LUCY JSON File Configurations
==============================

Update URI, PORT and “lucy_scratch_dir”

lucy_scratch_dir is specified lucy dir. The system LUCY should be in the d3VIEW_INSTALL_Dir/lucy/


.. thumbnail:: /_images/Images/lucyscratchdir.png
   :title:
   
   lucy_scratch_dir

.. centered:: :sup:`lucy_scratch_dir`

| 
|

Update mpi paths

Using “Platform_mpi” as an example, we need to provide the correct mpirun path. We also need to provide the correct path for LD_LIBRARY_PATH and MPI_ROOT path in the “env”

.. thumbnail:: /_images/Images/updatempipaths.png
   :title:
   
   Update mpi paths

.. centered:: :sup:`Update mpi paths`

| 
|

Create LSDYNA version

Create a new version for LS-DYNA. We need to provide correct path for binary and post_bin. We also need to provide the correct “mpi_type

.. thumbnail:: /_images/Images/createlsdynaversion.png
   :title:
   
   Create LSDYNA version

.. centered:: :sup:`Create LSDYNA version`

| 
|

Update LSTC_LICENSE_SERVER

Update LSTC_LICENSE_SERVER in the “env” under LSDYNA

.. thumbnail:: /_images/Images/envserverlstc.png
   :title:
   
   Update LSTC_LICENSE_SERVER

.. centered:: :sup:`Update LSTC_LICENSE_SERVER`

| 
|




Edit HPC Server
===============

Click on ”Edit” next to a server thumbnail to update its settings.

.. thumbnail:: /_images/Images/Administration/Administration_EditHPC.png
   :title:
   
   Edit a HPC Server

.. centered:: :sup:`Figure 20: Edit a HPC Server`

|

The default solver in HPCSERVER now has all necessary attributes​.
All the newly created servers will have these attributes by default.

.. thumbnail:: /_images/Images/defaultserverattributes.png
   :title:
   
   Attributes​

.. centered:: :sup:`Attributes​`

|

Column width of an attribute can be edited and saved to HPCserver in server settings option.​

.. thumbnail:: /_images/Images/columnattributeswidth.png
   :title:
   
   Column width of an attribute

.. centered:: :sup:`Column width of an attribute`

|



Interconnects and Translators
==================================

We have new options to add Interconnects and Translators to HPC servers while editing them.

1. Interconnects - We can add name , description , binary and commands to create intreconnects.

2. Translators - We can add name , decription , binary and commands to create Translators.

.. thumbnail:: /_images/Images/interconnectshpcserversone.png
   :title:
   
   Interconnects

.. centered:: :sup:`Interconnects`

|

.. thumbnail:: /_images/Images/interconnectshpcservers2.png
   :title:
   
   Interconnects

.. centered:: :sup:`Interconnects`

|



HPC Utilization
===============

You can view HPC usage by clicking on “Utilization” next to a HPC thumbnail. This window will show you visualizations and information such as core usage, running jobs and peak utilization. 

.. thumbnail:: /_images/Images/Administration/Administration_HPCUtilization.png
   :title:
   
   HPC Utilization Window

.. centered:: :sup:`Figure 21: HPC Utilization Window`

|

Below video show us how to manage HPC server or add a new HPC server to the page.

.. video:: _static/movies/adminitrationrhpcservers.mp4
   :width: 100%

|


HPC server settings
=============================

Here are some of the settings where solver attributes are used to enhnace the process of Job submission.

1. Options to use to detect hung simulation and to terminate them

.. thumbnail:: /_images/Images/detectandterminateservers.png
   :title:
   
   Detect hung simulation and to terminate them

.. centered:: :sup:`detect hung simulation and to terminate them`

|
|

2. Options to terminate jobs with errors that have hung​

.. thumbnail:: /_images/Images/joberrorshungservers1.png
   :title:
   
   Detect hung simulation and to terminate them

.. centered:: :sup:`detect hung simulation and to terminate them`

|
|

3. Options to restart the Simulation


.. thumbnail:: /_images/Images/jobrestartsimulation1.png
   :title:
   
   terminate jobs with errors that have hung

.. centered:: :sup:`terminate jobs with errors that have hung`

|
|

4. Options to post-process simulation after the simulation completes​

.. thumbnail:: /_images/Images/postprocessservers1.png
   :title:
   
   Post-process simulation

.. centered:: :sup:`Post-process simulation`

|
|



5. Solver Version

.. thumbnail:: /_images/Images/solverversionservers1.png
   :title:
   
    Solver Version

.. centered:: :sup:`Solver Version`

|
|


6. Selection of Compression type for LS-DYNA Result files

.. thumbnail:: /_images/Images/selectioncompressiontyperesultsfile1.png
   :title:
   
   Compression Type

.. centered:: :sup:`Compression Type`

|
|

7. Solver Precision and Solver MPI

.. thumbnail:: /_images/Images/solverprecisionsserver1.png
   :title:
   
   Solver Precision and Solver MPI

.. centered:: :sup:`Solver Precision and Solver MPI`

|
|


8. Options to provide Preview intervals and state intervals

.. thumbnail:: /_images/Images/intervalsstateservers1.png
   :title:
   
   Preview intervals and state intervals

.. centered:: :sup:`Preview intervals and state intervals`

|
|


9. Memory Options

.. thumbnail:: /_images/Images/memoryoptionsservers1.png
   :title:
   
   Memory Options

.. centered:: :sup:`Memory Options`

|
|


10. Binary path to use for compression

.. thumbnail:: /_images/Images/binarypathusecompression1.png
   :title:
   
   Binary Path

.. centered:: :sup:`Binary Path`

|
|

11. New variables QOS and NICE

.. thumbnail:: /_images/Images/qosandicevariables.png
   :title:
   
   QOS and NICE

.. centered:: :sup:`QOS and NICE`

|
|


HPC Disk/Job/Node status
===============================

HPC Servers in job submission will now show disk status/Job status and Node status​.​

.. thumbnail:: /_images/Images/disknodejobstatus.png
   :title:
   
   Disk,Job and Node

.. centered:: :sup:`Disk,Job and Node`

|
|

In Job Submision , we now see node information in the node status and job info in the job status when clicked in HPC servers.

.. thumbnail:: /_images/Images/nodestatusclick.png
   :title:
   
   Node status
   
.. centered:: :sup:`Node status`

|
|

.. thumbnail:: /_images/Images/jobstatusclick.png
   :title:
   
   Job status

.. centered:: :sup:`Job status`

|
|

Clicking on Disk usage will show usage by users i HPCservers while submitting a job.

.. thumbnail:: /_images/Images/diskstatusclick.png
   :title:
   
   Disk usage

.. centered:: :sup:`Disk usage`

|
|

HPCSERVER → Utilization view during job submission now includes the queue list.​

.. thumbnail:: /_images/Images/queueshpcserver.png
   :title:
   
   HPC server queues

.. centered:: :sup:`HPC server queues`

|
|


************
All Settings
************

Click on the All Settings option in the Administrative Menu to get started. 

.. thumbnail:: /_images/Images/Administration/Administration_AllSettingsMenu.png
   :width: 200px
   :title:
   
   All Settings Option

.. centered:: :sup:`Figure 22: All Settings Option`

|

This takes you to a page which presents an overview of everything. Click on other links in the side panel to explore and update settings. 

.. thumbnail:: /_images/Images/Administration/Administration_AllSettings_Overview.png
   :title:
   
   All Settings Overview

.. centered:: :sup:`Figure 23: All Settings Overview`

|

*Where Am I?*

.. thumbnail:: /_images/Images/Administration/Administration_WhereAmI.png
   :width: 100px
   :title:

   Where Am I?

Post Processors
===============

Under the settings section on the side panel, you can update an array of settings. The buttons for these sections are located on top. Click on Post Processors to go to this section.

.. thumbnail:: /_images/Images/Administration/Administration_PostProcessors.png
   :title:
   
   Click on Post Processors

.. centered:: :sup:`Figure 24: Click on Post Processors`

|

Update these settings as you like. 

.. thumbnail:: /_images/Images/Administration/Administration_PostProcessors2.png
   :title:
   
   Post Processors Settings

.. centered:: :sup:`Figure 25: Post Processors Settings`

|

LDAP Settings
=============

Under the same side panel section, click on "LDAP" at the top right next to "Post Processors". 

.. centered:: :sup:`Figure 26: Click on LDAP Settings`

.. thumbnail:: /_images/Images/Administration/Administration_LDAP.png
   :title:
   
   Click on LDAP Settings

Here, you can edit you LDAP configuration.

.. thumbnail:: /_images/Images/Administration/Administration_LDAP2.png
   :title:
   
   LDAP Settings

.. centered:: :sup:`Figure 27: LDAP Settings`

|

Logs
====

One the side panel, click on the section, "Logs". Here, you can view all logs on the platform and under which user it was performed. 

.. thumbnail:: /_images/Images/Administration/Administration_Logs.png
   :title:
   
   View All Logs

.. centered:: :sup:`Figure 28: View All Logs`

|

Below video shows how to nagivate to HPC settings page and view all the settings.


.. video:: _static/movies/adminitrationsettings.mp4
   :width: 100%

|


*****************************
Email settings
*****************************

Mail settings in Administration includes several MAIL Settings for the user.​

.. thumbnail:: /_images/Images/mailsettingadminitsration.png
   :title:
   
   Email settings

.. centered:: :sup:`Email settings`

|
|