File Upload

You can review files describing a system on the ProTop Portal without logging in to the database server or executing any special commands.

The files most commonly needed include dbanalys, structure files, parameter files, property files, and related reports generated by ProTop.

How to see and manage uploaded files on the ProTop Portal:

1. Log on to your ProTop Portal.
2. Click the file upload icon in the left side menu: 
   
   
3. You'll be presented with the Files screen.
4. Click the "eye" icon to view the file, or click the download icon to save a copy of the file.
5. You can filter on a variety of file properties.
6. Click the checkbox on the left to select files to delete and then click the Delete Selected Files to remove them:

Manually upload files

You can upload any file using the sendfile script:

sendfile[.sh] <fileName> [resource]

The filename must be explicit or relative to $PROTOP. A resource is optional. The file name must match an allowed pattern in the etc/upload.cfg file. Please read on to see how to control which files can be manually uploaded.

Background and configuration

This feature automatically uploads dbanalys and associated reports whenever ProTop detects that a new dictionary, database, or server parameter report has been run.

Other files require local customization before being uploaded. The bin/sendfile.sh[.bat] script allows users to upload files subject to the restrictions below. It can be called from local scripts to upload files that are not otherwise automatically uploaded.

NOTE: etc/upload.cfg allows the user to configure rules for which file uploads are permitted. 

Here is the default etc/upload.cfg:

# upload.cfg
#
# the fullpath file name is compared to the pattern in field1
#   - UNIX file separators are REQUIRED - IOW: use "/", do NOT use "\"
#   - the pattern is evaluated using: filename MATCHES pattern
#   - MATCHES supports * (any group of characters, including null) and . (any single character) wild cards 
#   - if you want a literal * or . you must use a ~ escape
#   - these comparisons are NOT case-sensitive
#   - see the 4gl documentation for more details 
#
# if more than one line qualifies the LAST entry will be used
#

* deny                          # deny everything by default

# always end config files with a comment

The default configuration line, * deny, prevents the manual upload of any file.  To allow the manual upload of any log file, for instance, let's say the log/dbmonitor.log file, create a new line below the * deny line, enter a pattern that you want to allow, followed by the "allow" rule so the active lines looks like this:

* deny
*.log allow

NOTE: If more than one line qualifies the LAST entry will be used.