Recent changes to LabSystemAdmin

LabSystemAdmin modified by Stefan Kuhn

Stefan Kuhn — Mon, 02 Sep 2024 12:25:59 -0000

--- v17
+++ v18
@@ -54,7 +54,7 @@
     * Order on screen: These numbers determine the order the experiments are shown on screen for users. If two or more experiments have the same number, their order is random.
     * An experiment can be deleted by checking both boxes in "Check twice and click to delete this machine" and hitting change. If one box is checked (accidentially), nothing happens (note that "deleting" only hides an experiment, it is kept to keep track of historical activity)
 * Add experiments to machines: In the next box, experiments can be activated for individual machines. This is done separately for day and night shift. If shift mode is not used, the night values apply. The "Name in IconNMR files" is the name which is written to the automation file if automation is used. This can be different for each spectrometer and must match with the parameterfile of TopSpin. The duration will be added to the duration from the audita.txt file, can be set to 0 if not relevant. "Compulsory" means that the experiment will be included in every order on this machine and cannot be deselected.
-* Solvents: Every spectrometer has an individual solvent list. Solvents can be added from the list or by setting an individual name followed by pressing “Add solvent”. After adding all solvents the order of the solvent list can be changed individual for every spectrometer by changing the order number behind the solvent name. To delete a solvent, check both boxes and press “Remove/order solvents”. Only change the order for one spectrometer at ones.
+* Solvents: For automation mode, every spectrometer has an individual solvent list. Solvents can be added from the list or by setting an individual name followed by pressing “Add solvent”. After adding all solvents the order of the solvent list can be changed individual for every spectrometer by changing the order number behind the solvent name. To delete a solvent, check both boxes and press “Remove/order solvents”. Only change the order for one spectrometer at ones. For operator and self measurements, there is one list only (and the users can enter any value they like). This list is maintained directly in the database.

 ## Lab workers
 Lab workers can finish order for worker mode. They can also do user administration (as well as the lab leader, whereas the setup above is restricted to the lab leader). Lab workers can register and chose the "I am an operator in this lab group" box. They need to get approved by the lab leader. Alternatively, the role labgroup_worker can be set manually in the database.

LabSystemAdmin modified by Stefan Kuhn

Stefan Kuhn — Tue, 20 Aug 2024 14:31:52 -0000

--- v16
+++ v17
@@ -37,24 +37,24 @@

 * Add spectrometers: Add spectrometers using the "Add a new one"-box below the list of spectrometers. The frequency to enter is the 1H frequency, typically part of the spectrometer name. Once added, the spectrometer can be edited in the list. The following parameters can be changed:
     * There are four possible modes, Sample Changer/Barcode/Operator Order/Self Order. A working day is divided in two shifts, for each of them (called "day" and "night") modes can be activated. If it is more than one, the user can chose. If "Structure input compulsory?" is set for a mode, a structure is needed for submissions in this mode.
-    * The shift times are set in the "Shift operation" column. The first time is for changing from night to day (typically start of the working day), the second from day to night (typically late afternoon). If "Shift operation" is off for a day, ... On weekends, the time means ...
+    * The shift times are set in the "Shift operation" column. The first time is for changing from night to day (typically start of the working day), the second from day to night (typically late afternoon). Leaving "Shift operation" off, results in night mode for the whole day.
     * "Default Mode Day/Default Mode Night" is the mode which is displayed with a new order in the respective shift. The actual mode can always be chosen by the user.
     * "Time for sample change" is used for accounting. The time is added to the time from the bruker audita.txt files.
-    * If "IconNMR integration?" is on, an automation file will be written. This file is transferred using the scp data given.
+    * If "IconNMR integration?" is on, an automation file will be written to the directory path. This file is transferred using scp, with the data set in the interface.
     * A spectrometer can be deleted by checking both boxes in "Check twice and click to delete this machine" and hitting change. If one box is checked (accidentially), nothing happens (note that "deleting" only hides a machine, it is kept to keep track of historical activity).
-    * It is possible to make a spectrometer to be displayed on top of the list on a specific computer (typically the computer controlling that spectrometer). For this, the IP needs to be set manually in the database.
+    * It is possible to make a spectrometer to be displayed on top of the list on a specific computer (typically the computer controlling that spectrometer). For this, the IP needs to be set manually in the database (field DEFAULT_ON_MACHINE in table MACHINE).
 * Add experiment: The next box shows the experiment which can be executed. This is independent of spectrometer, the enabling on specific spectrometers follows later. New experiments are created using the "Add a new one"-box  below the list of experiments. Only the name is needed here. Once created, the experiments can be changed in the list. The following settings can be changed:
-    * Max. Number: ...
+    * Max. Number: TODO.
     * Subexperiments (if composite): An experiment can be composed of several other experiments. None means the experiment is not a composed one.
-    * Identical with: ...
+    * Identical with: TODO
     * Report category: Indicates which category this experiment is added in the reports. Only influences the report. Categories need to be created manually in the database.
     * Form tab: The tab this experiment shows up on the submission page. Tabs need to be created manually in the database.
     * Text before: This is any text displayed before this experiment. It can also be a html tag like a line break to structure the experiment list.
     * Automation order: These numbers determine the order the experiments are written in the automation file. If two or more experiments have the same number,     their order is random.
     * Order on screen: These numbers determine the order the experiments are shown on screen for users. If two or more experiments have the same number, their order is random.
     * An experiment can be deleted by checking both boxes in "Check twice and click to delete this machine" and hitting change. If one box is checked (accidentially), nothing happens (note that "deleting" only hides an experiment, it is kept to keep track of historical activity)
-* Add experiments to machines: In the next box, experiments can be activated for individual machines. This is done separately for day and night shift (TODO what happens if we have no shifts?). The "Name in IconNMR files" is the name which is written to the automation file if automation is used. This can be different for each spectrometer. The duration will be added to the duration from the audita.txt file, can be set to 0 if not relevant. "Compulsory" means that the experiment will be included in every order on this machine and cannot be deselected.
-* Solvents: ...
+* Add experiments to machines: In the next box, experiments can be activated for individual machines. This is done separately for day and night shift. If shift mode is not used, the night values apply. The "Name in IconNMR files" is the name which is written to the automation file if automation is used. This can be different for each spectrometer and must match with the parameterfile of TopSpin. The duration will be added to the duration from the audita.txt file, can be set to 0 if not relevant. "Compulsory" means that the experiment will be included in every order on this machine and cannot be deselected.
+* Solvents: Every spectrometer has an individual solvent list. Solvents can be added from the list or by setting an individual name followed by pressing “Add solvent”. After adding all solvents the order of the solvent list can be changed individual for every spectrometer by changing the order number behind the solvent name. To delete a solvent, check both boxes and press “Remove/order solvents”. Only change the order for one spectrometer at ones.

 ## Lab workers
 Lab workers can finish order for worker mode. They can also do user administration (as well as the lab leader, whereas the setup above is restricted to the lab leader). Lab workers can register and chose the "I am an operator in this lab group" box. They need to get approved by the lab leader. Alternatively, the role labgroup_worker can be set manually in the database.
@@ -62,4 +62,4 @@
 ## User administration
 Users register themselved via the normal registration process (make sure users use the lab server for this, not the www instance of nmrshiftdb2). They need to check the "I want to get my compounds measured there" checkbox and chose their labgroup. All labworkers can see a list of users. The new users need to be activated (Email notifications are provided). The lab needs to decide on a policy here.

-MNova licenses can be administered via the web interface. ...
+MNova licenses can be administered via the web interface.

LabSystemAdmin modified by Stefan Kuhn

Stefan Kuhn — Sun, 18 Aug 2024 12:22:11 -0000

--- v15
+++ v16
@@ -42,6 +42,7 @@
     * "Time for sample change" is used for accounting. The time is added to the time from the bruker audita.txt files.
     * If "IconNMR integration?" is on, an automation file will be written. This file is transferred using the scp data given.
     * A spectrometer can be deleted by checking both boxes in "Check twice and click to delete this machine" and hitting change. If one box is checked (accidentially), nothing happens (note that "deleting" only hides a machine, it is kept to keep track of historical activity).
+    * It is possible to make a spectrometer to be displayed on top of the list on a specific computer (typically the computer controlling that spectrometer). For this, the IP needs to be set manually in the database.
 * Add experiment: The next box shows the experiment which can be executed. This is independent of spectrometer, the enabling on specific spectrometers follows later. New experiments are created using the "Add a new one"-box  below the list of experiments. Only the name is needed here. Once created, the experiments can be changed in the list. The following settings can be changed:
     * Max. Number: ...
     * Subexperiments (if composite): An experiment can be composed of several other experiments. None means the experiment is not a composed one.
@@ -56,7 +57,9 @@
 * Solvents: ...

 ## Lab workers
-Lab workers can finish order for worker mode. They can also do user administration (as well as the lab leader, whereas the setup above is restricted to the lab leader). Lab workers get assigned the role labgroup_worker manually in the database.
+Lab workers can finish order for worker mode. They can also do user administration (as well as the lab leader, whereas the setup above is restricted to the lab leader). Lab workers can register and chose the "I am an operator in this lab group" box. They need to get approved by the lab leader. Alternatively, the role labgroup_worker can be set manually in the database.

 ## User administration
 Users register themselved via the normal registration process (make sure users use the lab server for this, not the www instance of nmrshiftdb2). They need to check the "I want to get my compounds measured there" checkbox and chose their labgroup. All labworkers can see a list of users. The new users need to be activated (Email notifications are provided). The lab needs to decide on a policy here.
+
+MNova licenses can be administered via the web interface. ...

LabSystemAdmin modified by Stefan Kuhn

Stefan Kuhn — Sat, 17 Aug 2024 16:42:28 -0000

--- v14
+++ v15
@@ -52,11 +52,11 @@
     * Automation order: These numbers determine the order the experiments are written in the automation file. If two or more experiments have the same number,     their order is random.
     * Order on screen: These numbers determine the order the experiments are shown on screen for users. If two or more experiments have the same number, their order is random.
     * An experiment can be deleted by checking both boxes in "Check twice and click to delete this machine" and hitting change. If one box is checked (accidentially), nothing happens (note that "deleting" only hides an experiment, it is kept to keep track of historical activity)
+* Add experiments to machines: In the next box, experiments can be activated for individual machines. This is done separately for day and night shift (TODO what happens if we have no shifts?). The "Name in IconNMR files" is the name which is written to the automation file if automation is used. This can be different for each spectrometer. The duration will be added to the duration from the audita.txt file, can be set to 0 if not relevant. "Compulsory" means that the experiment will be included in every order on this machine and cannot be deselected.
+* Solvents: ...

+## Lab workers
+Lab workers can finish order for worker mode. They can also do user administration (as well as the lab leader, whereas the setup above is restricted to the lab leader). Lab workers get assigned the role labgroup_worker manually in the database.

---------------------------
-A couple of tasks must be done by the lab leader during operation. Most of these are done on the lab system page in nmrshiftdb2. These include: 
-
-  * Make users member of the labgroup (users register themselves, but need to be admitted. Email notifications are provided) 
-  * Remove users from labgroup.  
-  * Assign experiments to machines on which they can be run. 
+## User administration
+Users register themselved via the normal registration process (make sure users use the lab server for this, not the www instance of nmrshiftdb2). They need to check the "I want to get my compounds measured there" checkbox and chose their labgroup. All labworkers can see a list of users. The new users need to be activated (Email notifications are provided). The lab needs to decide on a policy here.

LabSystemAdmin modified by Stefan Kuhn

Stefan Kuhn — Sat, 17 Aug 2024 11:07:34 -0000

--- v13
+++ v14
@@ -41,7 +41,7 @@
     * "Default Mode Day/Default Mode Night" is the mode which is displayed with a new order in the respective shift. The actual mode can always be chosen by the user.
     * "Time for sample change" is used for accounting. The time is added to the time from the bruker audita.txt files.
     * If "IconNMR integration?" is on, an automation file will be written. This file is transferred using the scp data given.
-    * A spectrometer can be deleted by checking both boxes in "Check twice and click to delete this machine" and hitting change. If one box is checked (accidentially), nothing happens.
+    * A spectrometer can be deleted by checking both boxes in "Check twice and click to delete this machine" and hitting change. If one box is checked (accidentially), nothing happens (note that "deleting" only hides a machine, it is kept to keep track of historical activity).
 * Add experiment: The next box shows the experiment which can be executed. This is independent of spectrometer, the enabling on specific spectrometers follows later. New experiments are created using the "Add a new one"-box  below the list of experiments. Only the name is needed here. Once created, the experiments can be changed in the list. The following settings can be changed:
     * Max. Number: ...
     * Subexperiments (if composite): An experiment can be composed of several other experiments. None means the experiment is not a composed one.
@@ -50,15 +50,13 @@
     * Form tab: The tab this experiment shows up on the submission page. Tabs need to be created manually in the database.
     * Text before: This is any text displayed before this experiment. It can also be a html tag like a line break to structure the experiment list.
     * Automation order: These numbers determine the order the experiments are written in the automation file. If two or more experiments have the same number,     their order is random.
-    * Order on screen: These numbers determine the order the experiments are shown on screen for users. If two or more experiments have the same number,   their order is random.
+    * Order on screen: These numbers determine the order the experiments are shown on screen for users. If two or more experiments have the same number, their order is random.
+    * An experiment can be deleted by checking both boxes in "Check twice and click to delete this machine" and hitting change. If one box is checked (accidentially), nothing happens (note that "deleting" only hides an experiment, it is kept to keep track of historical activity)


 --------------------------
 A couple of tasks must be done by the lab leader during operation. Most of these are done on the lab system page in nmrshiftdb2. These include: 

   * Make users member of the labgroup (users register themselves, but need to be admitted. Email notifications are provided) 
-  * Remove users from labgroup. 
-  * Add and delete machines (note that "deleting" only hides a machine, it is kept to keep track of historical activity). 
-  * Assign automatic/self/worker operation modes to machines. 
-  * Add and delete experiments (note that "deleting" only hides an experiment, it is kept to keep track of historical activity). 
+  * Remove users from labgroup.  
   * Assign experiments to machines on which they can be run.

LabSystemAdmin modified by Stefan Kuhn

Stefan Kuhn — Sat, 17 Aug 2024 10:56:37 -0000

--- v12
+++ v13
@@ -41,7 +41,16 @@
     * "Default Mode Day/Default Mode Night" is the mode which is displayed with a new order in the respective shift. The actual mode can always be chosen by the user.
     * "Time for sample change" is used for accounting. The time is added to the time from the bruker audita.txt files.
     * If "IconNMR integration?" is on, an automation file will be written. This file is transferred using the scp data given.
-* Add experiment: The next box shows the experiment which can be executed. This is independent of spectrometer, the enabling on specific spectrometers follows later.
+    * A spectrometer can be deleted by checking both boxes in "Check twice and click to delete this machine" and hitting change. If one box is checked (accidentially), nothing happens.
+* Add experiment: The next box shows the experiment which can be executed. This is independent of spectrometer, the enabling on specific spectrometers follows later. New experiments are created using the "Add a new one"-box  below the list of experiments. Only the name is needed here. Once created, the experiments can be changed in the list. The following settings can be changed:
+    * Max. Number: ...
+    * Subexperiments (if composite): An experiment can be composed of several other experiments. None means the experiment is not a composed one.
+    * Identical with: ...
+    * Report category: Indicates which category this experiment is added in the reports. Only influences the report. Categories need to be created manually in the database.
+    * Form tab: The tab this experiment shows up on the submission page. Tabs need to be created manually in the database.
+    * Text before: This is any text displayed before this experiment. It can also be a html tag like a line break to structure the experiment list.
+    * Automation order: These numbers determine the order the experiments are written in the automation file. If two or more experiments have the same number,     their order is random.
+    * Order on screen: These numbers determine the order the experiments are shown on screen for users. If two or more experiments have the same number,   their order is random.


 --------------------------

LabSystemAdmin modified by Stefan Kuhn

Stefan Kuhn — Sat, 17 Aug 2024 10:21:24 -0000

--- v11
+++ v12
@@ -36,9 +36,12 @@
 If the labgroup leader logs in to nmrshiftdb2, the "NMR lab administration" tab should be active. The following tasks need to be done here;

 * Add spectrometers: Add spectrometers using the "Add a new one"-box below the list of spectrometers. The frequency to enter is the 1H frequency, typically part of the spectrometer name. Once added, the spectrometer can be edited in the list. The following parameters can be changed:
- * There are four possible modes, Sample Changer/Barcode/Operator Order/Self Order. A working day is devided in two shifts, for each of them (called "day" and "night") modes can be activated. If it is more than one, the user can chose. If "Structure input compulsory?" is set for a mode, a structure is needed for submissions in this mode.
- * The shift times are set in the "Shift operation" column. The first time is for changing from night to day (typically start of the working day), the second from day to night (typically late afternoon). If "Shift operation" is off for a day, ... On weekends, the time means ...
- * "Default Mode Day/Default Mode Night" is the mode which is displayed with a new order in the respective shift. The actual mode can always be chosen by the user.
+    * There are four possible modes, Sample Changer/Barcode/Operator Order/Self Order. A working day is divided in two shifts, for each of them (called "day" and "night") modes can be activated. If it is more than one, the user can chose. If "Structure input compulsory?" is set for a mode, a structure is needed for submissions in this mode.
+    * The shift times are set in the "Shift operation" column. The first time is for changing from night to day (typically start of the working day), the second from day to night (typically late afternoon). If "Shift operation" is off for a day, ... On weekends, the time means ...
+    * "Default Mode Day/Default Mode Night" is the mode which is displayed with a new order in the respective shift. The actual mode can always be chosen by the user.
+    * "Time for sample change" is used for accounting. The time is added to the time from the bruker audita.txt files.
+    * If "IconNMR integration?" is on, an automation file will be written. This file is transferred using the scp data given.
+* Add experiment: The next box shows the experiment which can be executed. This is independent of spectrometer, the enabling on specific spectrometers follows later.


 --------------------------

LabSystemAdmin modified by Stefan Kuhn

Stefan Kuhn — Thu, 15 Aug 2024 17:02:12 -0000

--- v10
+++ v11
@@ -35,7 +35,10 @@
 ## The spectrometers
 If the labgroup leader logs in to nmrshiftdb2, the "NMR lab administration" tab should be active. The following tasks need to be done here;

-* Add spectrometers: 
+* Add spectrometers: Add spectrometers using the "Add a new one"-box below the list of spectrometers. The frequency to enter is the 1H frequency, typically part of the spectrometer name. Once added, the spectrometer can be edited in the list. The following parameters can be changed:
+ * There are four possible modes, Sample Changer/Barcode/Operator Order/Self Order. A working day is devided in two shifts, for each of them (called "day" and "night") modes can be activated. If it is more than one, the user can chose. If "Structure input compulsory?" is set for a mode, a structure is needed for submissions in this mode.
+ * The shift times are set in the "Shift operation" column. The first time is for changing from night to day (typically start of the working day), the second from day to night (typically late afternoon). If "Shift operation" is off for a day, ... On weekends, the time means ...
+ * "Default Mode Day/Default Mode Night" is the mode which is displayed with a new order in the respective shift. The actual mode can always be chosen by the user.


 --------------------------

LabSystemAdmin modified by Stefan Kuhn

Stefan Kuhn — Thu, 15 Aug 2024 11:09:32 -0000

--- v9
+++ v10
@@ -27,7 +27,18 @@
   * From now on, further users can be added as described below. 

 # Post-Installation
+## The labgroup and the labgroup leader
+A "labgroup" is a set of spectrometers and associated users. Typically, one labgroup exists for one lab and runs on one installation. It is possible to create more than one labgroup for a lab, this could for example mean a separate administration of a set of spectrometers.

+Each labgroup has a "labgroup leader". This is an nmrshiftdb2 user who can administer machines, experiments etc. There can be more lab workers, who run experiments and can administer users. The labgroup leader must exist in the database (typically created by normal registration). The ID of the labgroup leader is entered in the table LABGROUP (needs to be done manually) and the user needs the labgroup_leader role assigned (needs to be done manually).  Also the PSML profile of nmruser must be used by this user.
+
+## The spectrometers
+If the labgroup leader logs in to nmrshiftdb2, the "NMR lab administration" tab should be active. The following tasks need to be done here;
+
+* Add spectrometers: 
+
+
+--------------------------
 A couple of tasks must be done by the lab leader during operation. Most of these are done on the lab system page in nmrshiftdb2. These include: 

   * Make users member of the labgroup (users register themselves, but need to be admitted. Email notifications are provided)

LabSystemAdmin modified by Stefan Kuhn

Stefan Kuhn — Thu, 20 Jun 2013 14:19:30 -0000

--- v8
+++ v9
@@ -2,9 +2,9 @@

 # Pre-installation

-The system is independent from hardware types, OS used and (in theory) also from the type of NMR machines used. You need a machine for the nmrshiftdb2 system to run on. It probably makes sense to use a dedicated server, although this is not a strict requirement. Hardware requirements are modest, any current CPU with standard amount of memory should work fine. Space on harddisk is also not demanding. One lab system reached, together with the data from the public nmrshiftdb2 instance around 1.5 GB after several years of operation. More space might be needed for the raw data (see below). 
+The system is independent from hardware types, OS used and (in theory) also from the type of NMR machines used. You need a machine for the nmrshiftdb2 system to run on. It probably makes sense to use a dedicated server, although this is not a strict requirement. Hardware requirements are modest, any current CPU with standard amount of memory should work fine. Space on harddisk is also not demanding. One lab system reached, together with the data from the public nmrshiftdb2 instance, around 1.5 GB after several years of operation. More space might be needed for the raw data (see below). 

-The lab system must have a directory (configured in nmrshiftdb.properties file) on the server it runs on which contains a sub-directory for each machine (the "raw file directory"). The system assumes that for each order a directory with the name of the order is created in the directory of the respective machine. E. g. an order named "myorder" has been processed on the machine named "av600", the system assumes that a directory /path/from/nmrshiftdb.properties/av600/myorder is created. In our current installations, this is done by pushing the files on the server useing Samba via a script triggered by the Bruker software. Other configurations would be possible, e. g. the directory could be somewhere else and nfs-mounted on the nmrshiftdb2 server, as long as the software sees the directory. 
+The lab system must have a directory (configured in nmrshiftdb.properties file) on the server it runs on which contains a sub-directory for each machine (the "raw file directory"). The system assumes that for each order a directory with the name of the order is created in the directory of the respective machine. E. g. an order named "myorder" has been processed on the machine named "av600", the system assumes that a directory /path/from/nmrshiftdb.properties/av600/myorder is created. In our current installations, this is done by pushing the files on the server using Samba via a script triggered by the Bruker software. Other configurations would be possible, e. g. the directory could be somewhere else and nfs-mounted on the nmrshiftdb2 server, as long as the software sees the directory. 

 nmrshiftdb2 packs the data for each order into a zip and places this in a directory. It also creates a link to this file where the file name is appended to a configured first part. So you need a place which can be addressed a) as a local directory for the software (again the directory might actually be mounted) and b) via an url (might be any protocoll).