noah nwnw5

rev:2012/11/18

User Frequently Asked Questions

Miscellaneous
Versions
Email and Elinks
Links and Bookmarks (Favorites)
Downloads
Permissions
Browser Issues


Miscellaneous

U1.1: What is new in this version of NOAH?
U1.2: What is 'meta-data' .. and how do I change it?
U1.3: Where do the files and directories go when I delete them ? .. can I get them back?
U1.4: What does 'Upload' and 'Download' mean in the NOAH context?
U1.5: Who are 'World' and 'Universe'?
U1.6: How do I clear and toggle check boxes?
U1.7: What are 'Tool Tips' and how do I see them?
U1.8: How do I sort on a field?
U1.9: How to I quickly hide a group of fields so long filenames and titles don't wrap?
U1.10: How do I change the 'master' in a grouping of files and dirs?

Versions

U2.1: How can I see what versions exist for a file?
U2.2: How can I upload multiple new file versions in one step?
U2.3: Where does the 'Comment' go when a new version is uploaded? .. can I change it later?
U2.4: Where do the versions go when I delete them? .. can I get them back?
U2.5: My filename on my laptop has changed for the new file version .. is that going to be a problem ?
U2.6: How can I see the md5sum of a file .. and what IS an 'md5sum'?
U2.7: How can I change the file type (i.e. word to wordperfect) without loosing the version history?

Email and Elinks

U3.1: In 'elinks', what's an 'Email Comment'?
U3.2: When I select 'email notification' during a new version upload, who gets the email, when does it get delivered and what will the email say?
U3.3: How can I email an elink page to others?
U3.4: How do I change or remove the Nordicwind logo in an 'elinks' page?
U3.5: Why does my document link in email notification not work (no http:// prefix)?

Links and Bookmarks (Favorites)

U4.1: How can I create a link to a NOAH file in a webpage?
U4.2: How can I create a link to a NOAH file in another NOAH directory?
U4.3: How can I create a link to a NOAH directory in another NOAH directory?
U4.4: How can I create a link to a specific version of a file?
U4.5: How can I bookmark a directory as a 'Favorite'?

Downloads

U5.1: Why does Windows Explorer block my file download after locking?
U5.2: What does 'use NOAH re-load after lock' mean?
U5.3: Why do I sometimes see 'download.cgi?sbox=F10' and other times 'download.cgi?docno=F10'?
U5.4: Why are some text icons in red?
U5.5: What does 'default version' mean in NOAH?
U5.6: What's a 'zip' file and how can I read it?

Permissions

U6.1: What's a 'RW Group' or 'RO Group'?
U6.2: How come I can't move a file into directory 'xyz' ?
U6.3: How come I can't create a directory or upload a file at the 'home' ('/') directory?
U6.4: When I create a new directory or upload a new file, NOAH sets permission access that I'm not happy with. How do I change that?
U6.5: How do I stop people from adding new files/dirs to a directory but still let them upload new file versions?
U6.6: How do I see my user information (first,lastname, email address etc.) ?

Browser Issues

U7.1: Why does my pop-up window stay in the background?


Miscellaneous

U1.1: What is new in this version of NOAH?     ( top )

NOAH version releases are summarized on the NOAH Download Page.

U1.2: What is 'meta-data' .. and how do I change it?     ( top )

'Meta-data' is the information that describes the file or directory with fields such as filename, title, author, date of last upload etc.

See Help: Meta-data.

U1.3: Where do the files and directories go when I delete them ? .. can I get them back?     ( top )

When you delete a file or directory it actually does not get deleted, it simply moves to the WasteBasket directory at the top of the NOAH database.

Generally, the administrator sets the permissions on the WasteBasket directory so only the 'admin' user(s) have 'write' permission. Since a user requires 'write' permission to move a file from a directory, only the 'admin' user can move a file or directory back out of the WasteBasket to the users original directory before 'deletion'.

Ask your NOAH Administrator how often the 'WasteBasket' is purged and what happens to the waste.

U1.4: What does 'Upload' and 'Download' mean in the NOAH context?     ( top )

'Upload' means STORE a file in the NOAH Database by uploading a file from your computer to the NOAH Database Server.

'Download' means RETRIEVE a file from the NOAH Database by downloading a file to your computer from the NOAH Database Server.

U1.5: Who are 'World' and 'Universe'?     ( top )

'World' access means any NOAH user that has an active username and password can access this content.

'Universe' access means that a user does not require an active username and password to access this content in the NOAH database.

See Help: File and Directory Permissions.

U1.6: How do I clear and toggle check boxes?     ( top )

The select boxes down the left side of a NOAH directory listing can be cleared by clicking on the the T in the field header or trailer of the directory listing. Similarly, the C will clear the select boxes.

U1.7: What are 'Tool Tips' and how do I see them?     ( top )

'Tool Tips' are tips that appear when a user pauses the mouse over a button or hyperlink and gives the user more information as to the purpose of this button or link.

Firefox bug:
Firefox version 2.0 has a bug that makes using tooltips a pain! The bug is that there seems to be a delay between when the page is loaded and when you can hover over a link for a tool tip. It is about 4 seconds. If you wait 4 seconds with your mouse NOT over a link and then go to that link, every thing works. If you don't wait the 4 seconds but hover over a link immediately, then the tool tips will not appear!

U1.8: How do I sort on a field?     ( top )

Click on the field label. Pause your mouse over the field label to see the Tool Tip!

U1.9: How to I quickly hide a group of fields so long filenames and titles don't wrap?     ( top )

Click on the close icon in the light grey section just below the Perms., Owner, Group, Size and Date fields.
To restore the hidden fields, click on [Details] or open icon.

See Help: Meta-data.

U1.10: How do I change the 'master' in a grouping of files and dirs?     ( top )

With the check boxes to the left of the files and directories, select the ONE file or directory you want to make the master of the group and clear the remaining check boxes in the group. Then, click the 'Group' button and the master of the group will change.

See Help: Group/Ungroup Select Actions.


Versions

U2.1: How can I see what versions exist for a file?     ( top )

Click on the V ] link in the Info field and scroll down and see the versions.

See Help: [Info] field.

U2.2: How can I upload multiple new file versions in one step?     ( top )

Check more than one select button beside the files you want to upload new versions to and then click the 'upload' button in the 'Selection Actions:' region. All the selected files will appear in a large upload menu permitting you to craft your comments and upload file names as one large 'Submit' reducing chance for missing a file.

U2.3: Where does the 'Comment' go when a new version is uploaded? .. can I change it later?     ( top )

When uploading a new file version, the comment you enter gets attached to the version which you can see in the version listings by clicking on V ] in the Info field beside the file of interest. You can also change comments on any number of file versions in one shot helping you 'correct' comments from previous uploads as more information becomes available.

U2.4: Where do the versions go when I delete them? .. can I get them back?     ( top )

When a version is deleted it is not removed from the NOAH database until the administrator runs the purge command. Check with your administrator if you want to know how often the purge command is run.

If you delete one or more versions of a file you can use the button 'Retrieve recent version deletes' to 'undelete' these files and get them back. If the administrator has run the 'purge' admin command (maybe as a scheduled job), the deleted versions are removed from the database to a special waste directory. It is up to the administrator to decide when to finally delete these 'waste' files and versions.

U2.5: My filename on my laptop has changed for the new file version .. is that going to be a problem ?     ( top )

No problem. NOAH does not care what the name of the new version is.

If you change the filename extension of the new file (because it was created with a different application) then you must change the filename in NOAH to agree with the extension. If you do not do this your browser will not pick the correct application to open the file on download.

See the related FAQ U2.7.

U2.6: How can I see the md5sum of a file .. and what IS an 'md5sum'?     ( top )

The md5sum of a file is the checksum that is calculated to provide a unique signature for the content in a file. If file 'a' has the same md5sum as file 'b', then the two files are identical.

You can see the md5sum of any file in NOAH by opening the Version Details page by clicking on the V ] link in the Info field beside the filename. Once on this Version Details page you can hover your mouse over the file version of interest and the md5sum will pop up as a tool tip.

The md5sum's are used mostly by the Client Scripting programs to check to see if a file should be refreshed and then taking appropriate action. This saves time and bandwidth. Being able to see the md5sum in the NOAH browser is mostly for debug purposes.

U2.7: How can I change the file type (i.e. word to wordperfect) without loosing the version history?     ( top )

Imagine you start an analysis of a problem with a 'word' document and save incremental versions in NOAH under the filename 'analysis.doc'.

After a few weeks of work you realize that you should be doing your analysis with an excel spreadsheet .. so you transfer your information from word to excel and start saving new versions of 'analysis.doc' as excel files. This is a good solution and works as long as you rename 'analysis.doc' to 'analysis.xls'. You now have a history of your work from 'word' to 'excel'.

NOAH handles this file type change by permitting you to rename files and filename extensions. In addition, if you download an old version of this 'analysis.xls' file you will see that the filename is numeric and maintains the filename extension that was present when the file was originally uploaded. This means that when you click on an old filename version that was done, in this example, in word, the browser will know to open the word application to read it!

For this to work, you must make sure that when you create files on your computer for upload that you use a filename extension that agrees with the file type and application you are using. Most applications will automatically provide the correct filename extension so this is not a problem.

See Help: [Info] field.


Email and Elinks

U3.1: In 'elinks', what's an 'Email Comment'?     ( top )

The 'Email Comment' field entry in the Elinks page permits the user to include an email comment when one of the 'Email to ..' buttons is used to email a document link.

Further email customization is possible by the NOAH administrator through changing the email templates in the admin directory.

U3.2: When I select 'email notification' during a new version upload, who gets the email, when does it get delivered and what will the email say?     ( top )

In a 'new version upload', the user has options to send email notification to the usernames in the 'Read-write Group', 'Read-only Group' and/or 'World' group for each file in the upload.

In the case of the 'World' group, this includes every username in the NOAH database. If the NOAH Administrator decides that this option can be abused, 'World' email notification can be disabled in the 'noah.config' file.

Email notification is cued and sent on a schedule determined by your NOAH Administrator. Generally this frequency is set at 5 minutes.

The NOAH Administrator can control the general content of the email through template files in the NOAH admin directory.

See Help: Email Notification Option.

U3.3: How can I email an elink page to others?     ( top )

If you choose to use the email notification buttons in 'elink', each file or directory in your 'elink' list will generate an email notification and get cued to be sent out as described in FAQ U3.2.

... but maybe you just want to send the 'elink' page itself! In this case, use the 'Save Page' button in 'elink' and send the resulting file as an attachment to your email using your email tool.

Too much work ? .. well some email/browser combinations (like thunderbird/firefox) will permit you to simply 'select/copy' and 'paste' from one window to the other preserving the html graphics as presented in 'elinks'.

Still too much work ? .. keep it simple if you like and just copy the link or short-cut (terminology varies with OS) with a mouse 'right click' and paste it into your email. Of course in this case you don't even have to use 'elinks', just spot the file you want in the NOAH directory list, select V ] to view the details of the file, look for the version of the file you want and grab it with a 'right-click' and then paste it into the email!
If you change the 'sbox=' to 'docno=', the browser will try to by-pass the 'download' dialog and open the file directly (useful for html files!).

But wait! .. I see that the link is 'bookmarkable' even without going into V ]!
Why: This is true if the file is not locked or if the administrator has disabled 'lock_prompt' .. so go ahead and use this link for bookmarking!

Why do I have to go into the V ] view of the file ?
The other links you see in the NOAH directory listings support features that do not expose the correct url for the 'right-click' trick to work.
NOTE: you may want to read more about links starting with FAQ U4.1.

See Help: Email Notification Option.

U3.4: How do I change or remove the Nordicwind logo in an 'elinks' page?     ( top )

Ask your NOAH Administrator to change the 'noah.config' file to change or remove the 'elink' icon. The variables are 'elinks_http' and 'elinks_logo'.

U3.5: Why does my document link in email notification not work (no http:// prefix)?     ( top )

If the 'noah.config' file was not created properly, the 'server' variable may not have a prefix of http:// or https://. If this is the case, then document links in email notification will look correct but your email tool will not make it a link that you can simply click on to access the file. The fix is to ask your NOAH Administrator to fix the 'server' variable in the 'noah.config' file.


Links and Bookmarks (Favorites)

U4.1: How can I create a link to a NOAH file in a webpage?     ( top )

As discussed in FAQ U3.3, the simple way to grab the correct syntax for a NOAH document link is with the mouse right-click on a document link in the NOAH 'view versions' page (V ]) and paste the link into your target webpage or email tool.

If you want NOAH to try to open the file directly without the 'download dialog', change the 'sbox=' to 'docno=' in this copied link. (useful for html documents!)

The exact syntax goes like this:

http://myserver/cgi-bin/mynoah/download.cgi?docno=F10

where 'http://myserver' is the server name, 'mynoah' is the cgi-bin directory that the NOAH binaries reside in and 'F10' is an example file idno of F10.

Add the menu=1 option to this URL like this (don't forget the '&' !):

http://myserver/cgi-bin/mynoah/download.cgi?docno=F10&menu=1

and you get a menu prompt before downloading the file with a number of useful options that might interest the user.

U4.2: How can I create a link to a NOAH file in another NOAH directory?     ( top )

The NEW way:
Use the 'doclink' button in the Select Actions: box to create a doclink and then move this doclink to the directory of choice.

The OLD way: (this is still instructive ..)
The simple way is to use 'elink' with your files and use the 'Save page' button to save an html page with these links. Upload this html page to the directory that you want to make accessible in another NOAH directory. Of course you may want to modify this html file to meet your needs, or simply create your own html file using the tricks from FAQ's U3.3 and U4.1.

U4.3: How can I create a link to a NOAH directory in another NOAH directory?     ( top )

The OLD Way
Use the 'doclink' button as described in U4.2 but select a directory instead of a file!

The OLD Way (this is still instructive ..)
To create a link to another NOAH DIRECTORY in an html file, use the following:

http://myserver/cgi-bin/mynoah/cdocs.cgi?dirno=D23

where 'http://myserver' is the server name, 'mynoah' is the cgi-bin directory that the NOAH binaries reside in and 'D23' is an example directory number in the default NOAH database'.

If you have multiple databases, and the database you are working with is not 'default', then use the following:

http://myserver/cgi-bin/mynoah/cdocs.cgi?dirno=D23&database=ACME

where the database is 'ACME'.

U4.4 How can I create a link to a specific version of a file?     ( top )

The simple answer is similar to previous answers: find the document link in NOAH and use the mouse right-click to copy the link and paste it into your target tool for an html page or email.

The more precise syntax is:

http://myserver/cgi-bin/mynoah/download.cgi?docno=F10&docver=2

Where 'docver=2' refers to document version # V2 as seen in the V ] document version menu link in the Info field in a NOAH directory listing.

Don't forget to add the '&database=ACME' if your database is ACME and not 'default'.

NOTE that in all the above cases, adding the 'menu=1' option means that the link will open a menu before downloading. See FAQ U4.1.

U4.5: How can I bookmark a directory as a 'Favorite'?     ( top )

If you want to return often to a favorite NOAH directory, you can use your browsers Bookmark or Favorites feature to save the URL/Address of the current directory.

The Bookmark or Favorites features of the modern browsers are very flexible and permit you to organize your bookmarks in categories and give you lots of options to make these bookmarks easy to find.

NOTE: If you have arrived at a NOAH directory after submitting a dir or file meta-data edit, you will notice that the URL for your bookmark is incomplete and will link you to the homeclose ). directory. To fix this, click on the reloadreload ) link (beside Current Directory:) and this will correct the URL and make it ready for bookmarking.

U5.1: Why does Windows Explorer block my file download after locking?     ( top )

If your browser is setup to block pop-ups, then you will get this block.

You have a number of options here:

U5.2: What does 'use NOAH re-load after lock' mean?     ( top )

If you see this message it means your administrator has chosen a noah.config 'lock_prompt' mode that does not refresh the browser page when 'downloading with lock'. This is to avoid the problem of blocking pop-ups described in U5.1 .. but it means that you must manually update the browser page by clicking on the reload link.

U5.3: Why do I sometimes see 'download.cgi?sbox=F10' and other times 'download.cgi?docno=F10'?     ( top )

The 'sbox' syntax generally forces the browser to ask if you want to save the file or open it with a specific application where as the 'docno' syntax tends to skip this question if the browser knows how it wants to handle this file type.

This is most obvious in html files where the browser has no doubts on how to handle html. It may also be seen in text files where the browser can be the default for opening text (.txt) file types.

U5.4: Why are some text icons in red?     ( top )

If the most recent file version is not set as the default, then NOAH will flag this to the users with a red text icon ( close ).

U5.5: What does 'default version' mean in NOAH?     ( top )

'default version' in NOAH is the file version that is downloaded by default if the 'docver' is not specified. In a NOAH directory listing, all files in the listing will download the default version when selected.

See FAQ U5.4 on icon colour.

U5.6: What's a 'zip' file and how can I read it?     ( top )

A 'zip' file is a file that contains many other files and directories in a compressed format. If you are dealing with a number of files and directories, it is easier to email or move around a single 'zip' file than it is to move the files and directories as one block. This is especially true when transferring files through the Internet and across different operating systems.

'zip' files also add some compression making them generally smaller in size than the flat uncompressed directories and files which saves disk space and speeds up email.

U6.1: What's a 'RW Group' or 'RO Group'?     ( top )

'RW Group' is short for 'read-Write Group' and 'RO Group' is short for 'Read-Only Group' and is used in NOAH as a shortened syntax to make menus more compact and easier to read.

See Help: File and Directory Permissions.

U6.2: How come I can't move a file into directory 'xyz' ?     ( top )

To move a file (or directory) from one NOAH directory to another, you need to have 'Read-Write' access permission to both the source and target directories.

In addition, directories that have been 'locked' by another user will prevent you from moving files from or to the locked directory.

Finally, only an 'admin' user can create/delete or move files in the home directory ( close ).

U6.3: How come I can't create a directory or upload a file at the 'home' ('/') directory?     ( top )

Only an 'admin' user can create/delete or move files in the home directory ( close ).

See Help: Admin user restrictions.

U6.4: When I create a new directory or upload a new file, NOAH sets permission access that I'm not happy with. How do I change that?     ( top )

When a new directory or file is created, it takes it's permission template from the current directory where the new directory or file is being created. Change the permissions of the current directory and all subsequent files and directories will be created with this new template.

See Help: File and Directory Permissions.

U6.5: How do I stop people from adding new files/dirs to a directory but still let them upload new file versions?     ( top )

Lock the directory.

See Help: File and Directory Locking.

U6.6: How do I see my user information (first,lastname, email address etc.) ?     ( top )

In the upper right corner of a NOAH directory display beside the NOAH version release, there is a link for the currently logged on username. Click on this link.

U7.1: Why does my pop-up window stay in the background?     ( top )

In more recent versions of Firefox, the default configuration of 'javascript' is to disable javascripts from raising or lowering windows. This is annoying if you are clicking on multiple S ] links to see who is subscribed to a file or directory since the subscriber list will keep going into the background behind the main NOAH window.

In Firefox, select 'Edit' -> 'Preferences' -> 'Content' and select the 'Advanced' button beside the 'Enable JavaScript' checkbox and allow scripts to 'Raise or lower windows'.


contact: noah@nordicwind.ca Copyright © 2004-2012 Nordicwind Inc. - All rights reserved.