NIH | National Cancer Institute | NCI Wiki  

Error rendering macro 'rw-search'

null

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Extract the caNanoLab_2.0.zip to a location on your local system, for example, C:\caNanoLab_2.0. This location is referred to as <CANANOLAB_SOURCE> throughout the document. Verify that the following five folders exist in the directory <CANANOLAB_SOURCE>:

...

Before a user can log in to the caNanoLab application to submit and search data, you must first create a user account through the UPT web interface. The caNanoLab application makes use of the NCICBIIT's User Provisioning Tool (UPT), a separate web application, for user account management. The concepts of users, groups, roles, protection groups are defined according to the CSM/UPT principles. See the CSM documentation for details on these concepts and the use of the UPT tool.

Since release 1.5.2, as a part of the database seed data, two default user groups are created: Public and Curator. The group Public is assigned role R (read-only) public protocols, samples, and publications. The group Curator is assigned role CURD (create, update, read and delete) to all protocols, samples, and publications in the system. When a user first logs into caNanoLab, the user is automatically added to the Public group and can  can see all public data. The user needs to be added to the Curator group in the UPT tool in order to have Curator access.

...

Step

Action

1

Launch the UPT tool at http://<APP_SERVER_URL>/uptlogin and login log in as the super admin. If you are NOT using LDAP for user authentication, the default user account/password for super admin is superadmin/superadmin.

Enter csmupt as the application name when prompted at the UPT log in. If you are using LDAP for user authentication, use the LDAP login name and password of the user assigned as the super admin as specified in the Ant build properties file.

Note:
The user superadmin with initial password superadmin was created as a part of the database setup. Only superadmin can assign users to be caNanoLab administrators.

2

If you are using LDAP for user authentication, skip this step. If you are not using LDAP for authentication, follow this step to reset the password for superadmin:

  • Select User > Select an Existing User.
  • Click on Search and select superadmin, and click on ViewDetails.
  • Update the UserPassword field and ConfirmPassword field.
  • Click on Update to commit the change.

3

Log in as the super admin, and follow these steps to create a new user and assign it to be a caNanoLab administrator:

  • Select User > Create a New User.
  • Create a new user account named admin with an initial password.
  • Select Application>SelectanExistingApplication, and click Search. Select caNanoLab from the application list.
  • Click ViewDetails, then AssociatedAdmins.
  • Assign this user to be an administrator for the caNanoLab application.
  • Click UpdateAssociation to commit the change.
    Note
    : If you are using LDAP for user authentication, any user login names created in the UPT tool must be a valid LDAP log in name.

4

Before the newly-created user can log into the UPT application, logged in as the super admin, follow these steps to update the required database connection information for the csmupt and caNanoLab applications under the Application tab:

Select Application > Select an Existing Application, and click Search. Select csmupt from the application list.

Click View Details, then update the following fields:

  • Application Database URL, for example, jdbc://mysql://localhost:3306/canano
  • Application Database User Name, for example, cananolab_app
  • Application Database Password, for example, go!234
  • Application Database Confirm Password, for example, go!234
  • Application Database Dialect, for example, org.hibernate.dialect.MySQLDialect
  • Application Database Driver, for example, com.mysql.jdbc.Driver

Note: Please refer to Edit Ant Properties for the appropriate values for these fields. Values for Application Database Dialect and Application Database Driver must be exactly entered as shown above.

Repeat the steps to update the database connection information for the caNanoLab application.

5

Log out of the UPT tool and log back in as admin. Use caNanoLab as the application name when prompted at the UPT log in.

6

Select User > Select an Existing User, and click Search. Select admin from the User list.

Click ViewDetails, then AssociatedGroups.

Select Curator from the pre-defined group list and assign it to the user. Click UpdateAssociations to commit the change.

...

For more information about how to use the UPT tool for managing user accounts, contact NCICBIIT Application Support at  ncicbiit@mailnciappsupport@nih.nih.gov and request that the caNanoLab technical team give gives you a demonstration of the UPT tool in the context of the caNanoLab application.

...

NCICBIIT Application Support

ncicbiit@mail.nihnciappsupport@nih.gov