 |
Page History
...
For a Previous Installation
If you:
- Installed caNanoLab prior to release 2.1 against an MySQL database
OR
Installed release 1.2, release 1.1.1, or release 1.1 against an Oracle database, - AND have associated production data in these schemas
AND would like to continue to use the same data for caNanoLab release 2.1 in MySQL,
...
- Review the following database initialization steps, and then go directly to section, Data Migration.
| Info | ||
|---|---|---|
| ||
If you have a previously installed caNanoLab running on a Wildfly server, stop the server before running the database scripts. |
...
Step | Action | |||||||||||||||||
1 | Set up an environment variable
| |||||||||||||||||
2 | Execute the Ant build script build.xml located at Example: Issue the following commands to execute the Ant script:
Successful execution of the Ant script generates the following artifacts that include two deployable web archive war files, configuration files and libraries for running the web application in the Wildfly environment, and also places these artifacts in the appropriate directories under
| |||||||||||||||||
3 | We recommend increasing the JBoss JVM heap size to 2G bytes and permanent generation (permgen) memory space to 256M bytes by updating the file
This configuration file is read when Wildfly server starts. | |||||||||||||||||
4 |
| |||||||||||||||||
| 5. | Start JBoss application server in Standalone mode. This script assumes the CLI port is running at 19990. If it is different, you need to update port number at the second line in the script.
|
Verification
Once the deployment artifacts are deployed and the Wildfly application server is correctly configured, you can start the Wildfly application server, which in turn starts the caNanoLab application.
Open the URL http://<APP_SERVER_URL>/caNanoLab/, for example, http://localhost:8080/caNanoLab. The Welcome/Login page displays.
...
The following steps illustrate an example use of the UPT tool to create a new user, assign the user to be a caNanoLab administrator, and assign the user to the Curator group.
Step | Action | |||||
1 | NOTE:
| |||||
|
The user superadmin with the password superadmin was created as a part of the database setup. Only a superadmin user 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 the user 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.
Info title 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 ViewDetails, then update the following fields:
- ApplicationDatabaseURL, for example,
jdbc://mysql://localhost:3306/canano - ApplicationDatabaseUserName, for example,
cananolab_app - ApplicationDatabasePassword, for example,
go!234 - ApplicationDatabaseConfirmPassword, for example,
go!234 - ApplicationDatabaseDialect, for example,
org.hibernate.dialect.MySQLDialect ApplicationDatabaseDriver, for example,
com.mysql.jdbc.DriverInfo title 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.
- ApplicationDatabaseURL, for example,
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.
Follow similar steps to create other application user accounts as appropriate.
| Info | ||
|---|---|---|
| ||
Since release 1.5.2, if you are not using LDAP for user authentication, superadmin or caNanoLab administrators maintain the passwords for user accounts. The UPT tool does not allow users to manage their own passwords. |
- Publicly-available data can be browsed through Browse caNanoLab links on the home page without logins.
- At each new data submission, the user who creates the data and the Curator group are automatically assigned role CURD to the newly-created data.
- For more information about how to use the UPT tool for managing user accounts, contact NCICBIIT Application Support at ncicbiit@mail.nih.gov and request that the caNanoLab technical team give you a demonstration of the UPT tool in the context of the caNanoLab application.
Contacting Application Support
...
