Maintaining the Scanner Accounting and LabNotes tools

NOTE: This "HowTo" note is intended for system administration. Executing these procedures requires privileged computer access.

IMPORTANT NOTE on OWNERS and PERMISSIONS
Ownership and permissions of these files is critical. As such, be sure to run 'SetOwners' as described below, each time you make any changes.

Adding New Users:

To add a new LabNotes user to the Logger.

  1. Login as 'root'
  2. Open and edit the file called, '/usr/users/bin/apache/cgi-bin/LabNotes/accounts'
  3. Add a line containing the users last name, email and an easily-remembered password. No spaces are allowed!
  4. Save the file.
  5. Type: '/usr/users/bin/apache/cgi-bin/LabNotes/SetOwners' to set file owners and permissions.
  6. logout.

Adding A New IRB Number:

To add a new IRB number to the Experiment Logger

  1. Login as 'root'
  2. Open and edit the file called, '/usr/users/bin/apache/cgi-bin/LabNotes/IRBnumbers.txt'
  3. Add a line containing the IRB number, a description and the e-mail of the PI for that IRB number. No spaces are allowed in and of these fields!
  4. Save the file.
  5. Type: '/usr/users/bin/apache/cgi-bin/LabNotes/SetOwners' to set file owners and permissions.
  6. logout.

Each IRB number has a limited list of eligible users. To modify the list of users for a given IRB number

  1. Login as 'root'
  2. Open and edit the file called, '/usr/users/bin/apache/cgi-bin/LabNotes/IRBnumberusers'
    where IRBnumber represents the relevant IRB number. For example, to add users to 97-01-007-04, open and edit 97-01-007-04users
  3. Add a line containing each eligible users name exactly as it appears in the accounts file. The IRB owner's name should always appear.
  4. Save the file.
  5. Type: '/usr/users/bin/apache/cgi-bin/LabNotes/SetOwners' to set file owners and permissions.
  6. logout.

The Experiment Logger will generate a unique sequence number for each protocol. You must create the control file for this purpose

  1. Login as 'root'
  2. Create a file called, '/usr/users/bin/apache/cgi-bin/LabNotes/HSPCSeqNumIRBnumber'
    where IRBnumber represents the relevant IRB number. For example, to set the scan number for 97-01-007-04, open and edit
    HSPCSeqNum97-01-007-04
  3. Enter the desired starting number for the scans on that protocol, typically 0.
  4. Save the file.
  5. Type: '/usr/users/bin/apache/cgi-bin/LabNotes/SetOwners' to set file owners and permissions.
  6. logout.

Adding a New Brain Mapping Protocol

These are the separately billable entities recognized by the BMC.

This should only be done after John Mazziotta has okayed the protocol.

To add a new protocol to the drop-down list on the Experiment Logger.

  1. Login as 'root'
  2. Open and edit the file called, '/usr/users/bin/apache/cgi-bin/LabNotes/LNprotocols.txt'
  3. Add a line describing the new protocol as follows:
    1. Insert a line containing the protocol name alphabetically in the list of protocols
    2. The second entry is the billing information (no spaces). This is the account to be billed for these scans
    3. The third entry is the number of scans allocated to this protocol
    4. The fourth entry (currently unused) is a brain mapping account number, which should be different for each protocol
    5. The fifth entry is the e-mail of the person responsible for that protocol
    6. The final entry is intended as a short identifier for files created under this protocol. Most folks do not use it.
  4. Type: '/usr/users/bin/apache/cgi-bin/LabNotes/SetOwners' to set file owners and permissions.
  5. logout.

Adding Scans to an Existing Protocol

Never add scans to the protocols without prior approval from John Mazziotta.

  1. Login as 'root'
  2. Open and edit the file called, '/usr/users/bin/apache/cgi-bin/LabNotes/LNprotocols.txt'
  3. Edit the third entry in the line concerning this protocol. This number is the number of scans remaining on this protocol.
  4. Save the file.
  5. Type: '/usr/users/bin/apache/cgi-bin/LabNotes/SetOwners' to set file owners and permissions.
  6. logout.
  7. Notify leona@loni.ucla.edu telling her how many scans were added.

Back to HowTo pages
This page is maintained by MarkCohen [updated 2.12.01]