1.1. I forgot my user id. How do I retrieve it?
A.
If your RAMADDA site has been configured to send email (see
here to configure email)
then on the Login page you should see "Forget your User ID?" and
"Forget your Password?" links.
1.2. How do I select multiple checkboxes at once?
A.
In RAMADDA when there is a collection of checkboxes in a form (e.g., in the entry list or in the edit metadata form)
selecting one and then
selecting another with a Shift-Click toggles the range of checkboxes between the first the second
checkbox clicked. Doing a Control-Click on a checkbox toggles all of them on or off.
1.3. How do I configure SSL access to RAMADDA?
A.
To configure SSL access see
here if you are running under Tomcat.
See
here if you are running stand-alone.
1.4. I got an out of memory error saying something about PermGen size. Whats up with that?
A.
You will need to change your java runtime memory settings by adding:
java ... -XX:MaxPermSize=256m ...
See the
Tomcat installation section
for more information.
1.5. I want to restrict where users can login from
A.
For security reasons you can configure what IP addresses users are allowed to login from.
In your
repository.properties file in your local RAMADDA directory, e.g.,
<home>/.ramadda/repository.properties
add the property:
##Comma separated list of ip addresses (or prefixes) that are the ones where the user can login
##If blank then login is allowed from anywhere
ramadda.login.allowedips=
##e.g.:
##ramadda.login.allowedips=127.0.0,201.43.72.5
1.6. Oops, I told RAMADDA to use an SSL port and SSL is not working. Now I cannot access the admin page to turn off SSL and I'm stuck. What can I do?
A.
You need to comment out the ramadda.ssl.port property in your .properties file.
Alternatively, you can run RAMADDA with the command line argument:
-Dramadda.ssl.ignore=true
1.7. I forgot the administrator password and cannot access RAMADDA. How do I login?
A.
The easiest way is to set a username/password in the repository.properties file in the
RAMADDA home directory. Just add:
ramadda.admin=userid:password
and then restart RAMADDA. This sets the password for the given userid.
Note: you should remove this entry once you have reset your password.
You can also specify an administrator user id and password from the command line when starting RAMADDA.
If you are running RAMADDA stand alone then just provide the arguments:
-admin <user id> <password>
This creates a new user id if needed and sets the password.
If you are running RAMADDA under Tomcat then change the web.xml to pass in command line arguments
using the "args" entry. This is a comma separated value list of the command line arguments
that are processed by RAMADDA.
<param-name>args</param-name>
<param-value>-admin,userid,password</param-value>
1.8. I set the hostname to an incorrect hostname. Now I can't login?
A.
Make a <anyname>.properties that contains:
override.ramadda.hostname=<good host name>
and place it in your ramadda home directory or plugins directory and restart ramadda.
Once you are logged in go to the Admin Settings page and change the hostname then remove
the properties file.
In general, you can override any property that has been set by defining a property with the "override." prefix.
1.9. How do I configure RAMADDA to send email?
A.
RAMADDA can send email for both the password reset process and for monitoring new entries.
On the main Site Administration page under the "Contact" area you can specify
a SMTP server that RAMADDA will use to send email.
1.10. I have a root .ramadda home dir that I don't want to run in
A.
If you build from source then the build process will create a ~user/.ramadda/plugins directory and copy all of the plugins to that directory. The problem that can occur is if you are running your server and the RAMADDA home directory property goes missing then RAMADDA will default to use the ~user/.ramadda as the home dir if it exists. Now, if you are running the build say as root then the home dir will exist.
If this occurs then
anyone can hit your site and go through the installation process. To not allow this to happen create a file called not_for_server.txt and place it in the ~user/.ramadda directory that is getting created as part of the build but should not be used as the home directory.
See the documentation.
1.11. I want to change the html design of RAMADDA
1.12. Changing the initial welcome text and entries
A.
When RAMADDA is first installed it populates your repository with some initial folders and sets the description
of the root entry with some initial text. You can override what entries are created and what the text is (for example, if
you wanted to configure a number of different RAMADDA servers).
To change the description used just create a file initdescription.txt in the RAMADDA home directory. This file, if it exists,
is read by RAMADDA. You can see the default one in the source tree at:
src/org/ramadda/repository/resources/examples/initdescription.txt
This file contains 2 macros:
${root} - the top-level URL path
${topid} - the ID of the root entry
To change what entries are created RAMADDA looks for a
initentries.xml file in the RAMADDA home directory. The default file is:
src/org/ramadda/repository/resources/examples/initentries.xml
This is just the entries xml format. The ID of the top-level entry is simply "root", e.g.:
<entries>
<entry parent="root" name="Projects" type="group">
<description>A place to store projects</description>
</entry>
</entries>
1.13. Running with non-ascii characters
1.14. I've cleaned up files on my server that I had harvested in RAMADDA. How do I delete those entries in RAMADDA?
A.
If you have harvested files into RAMADDA from your server file system and subsequently delete those files (e.g., scouring a real-time archive) RAMADDA will not delete the corresponding entries automatically. Instead, by default, RAMADDA will not show those kinds of entries to non logged in users but will show them to logged in users. However, no file download is available because the file is missing.
To clean up these entries in RAMADDA you can manually delete the entries or you can set a property to automatically delete these types of entries.
ramadda.delete_entry_when_file_is_missing=true
Be careful with this. I (jeffmc) have seen remote file systems go down momentarily and if this had been set then all of my entries that I had harvested would have been deleted.
SOCIB RAMADDA Data Repository
