|
|
|
|
|
HELIOS WebShare UB User manual |
||||
Launch a browser and enter the WebShare WebObjects Server address, using port 2009, e.g.:
http://<yourhostname>.company.com:2009
Log on to the WebShare File Server according to the instructions in 5.1 "WebShare File Server login".
Use the Forgot Password? link to open a page which lets the user request a login password. The Register as a New User link is meant for entering user data in order to receive a WebShare account.
Note: The links Forgot Password? and Register as a New User are not available by default. For a description see 4.1 "Server Preferences".
In order to have WebShare administrative privileges, a user must log in as "root", or be a member of either the "WSAdm" or the "SysAdm" group. If HELIOS Admin is also installed, it can be used to create the "WSAdm" group, and assign users to the "WSAdm" group or "SysAdm" group. Members of the "SysAdm" group have administrative privileges for HELIOS Admin and WebShare. Members of the "WSAdm" group have administrative privileges for WebShare only. In the event that HELIOS Admin is not available, the server's system level utilities must be used to create the "WSAdm" or "SysAdm" groups, and add users to them.
The WebShare WebObjects Server port number can be changed by means of the WOPort preference (6.6 "Preference keys"). For administration, the user must log in as "root", or a user being member of the "SysAdm" or "WSAdm" group. The password must be a valid host user password, which has been assigned using "HELIOSDIR/bin/authutil" (see "authutil" in the Base manual).
Important: After the first time installation of a HELIOS product the "root" and "demouser" passwords are empty and must be assigned via the "authutil" program (see Base manual)!
After a successful login, the "Home" window appears, allowing quick access to the defined sharepoints (Fig. 5).
Click on the Administration button. From within the "Administration" section, select the desired item (Fig. 6).
The "Server Preferences" window (Fig. 7) allows specifying default values for the WebShare File Server.
WebShare keeps image preview files, which have already been displayed, in a cache on the WebShare File Server, so they will open quite quickly the next time they are requested. The Cache Size in MB and the path to the Cache Directory are specified in the respective fields. If the Cache Directory is changed, the new directory must already exist, and have full rwx (read-write-execute) privileges for all.
The number of files in the cache is only limited by the assigned cache size. When the cache is full, WebShare starts to delete old files in the cache in order to store newer files. If the Remove All Cache Files checkbox is ticked, WebShare deletes all cache files when the Save Preferences button is clicked.
The Remove All Cache Files operation should be done without any users connected, to avoid login time-outs during the removing. Alternatively, the WebShare File Server can be stopped with the "srvutil stop websharesrv" command and the content of the cache directory subsequently deleted with "rm -r cachedir/*".
Note: The default value for CacheSize is 30 (MB), due to the usually limited disk space in "HELIOSDIR/var". If you change the CacheDir preference to another path, it is recommended to set CacheSize to a value of at least 300 (MB).
WebShare acts as an SMTP client, and can send e-mail notifications via an SMTP server running on the same host, or via an external SMTP server.
Note: The global preferences SMTPHost and SMTPSender (see "Preferences" in the Base manual) must be set up correctly for e-mail notification to work.
By use of the Enable E-Mail Message for Users option, the administrator can determine whether the Mail Message functionality (see Mail Message in 5.2.1 "The "Actions" pop-up menu") is available to WebShare users. Enable WebShare for Host Users and Enable WebShare for Virtual Users determine which type of users can connect to WebShare. Host Users are those who are listed in the HELIOS password file "var/conf/passwd". Virtual Users are user names who have been set up as WebShare users only, but are mapped to a host user name (compare 4.2 "User Administration"). If Enable WebShare for Host Users is not checked, then individual Host Users can still be enabled by entering them as Virtual Users. If neither checkbox is marked, only "root" (or Virtual Users mapped to the user "root") can log in.
Important: Host users must have an entry in the HELIOS password file "var/conf/passwd". Otherwise they will not be accepted as valid users and hence cannot log on to the WebShare File Server.
The Directory Listing Date Format can be customized, e.g. according to American or European date format preferences. For details go to:
The two pop-up menus Default Windows Encoding and Default Mac OS Encoding specify the default download encoding for the used client platform. The setting determined here is applied when OS Default in the Download Encoding pop-up menu (see 5.3 "My User Preferences") is selected.
The Preview Resolutions (pixel or dpi) field is used to specify custom preview resolutions for the remote file preview option (requires ImageServer). Preview pages include four "zoom icons", which are set to fixed values of 256, 512, 768, and 1024 pixels. In addition, there is a pop-up menu, which can be used to offer custom preview resolutions. This makes sense if preview resolutions or sizes are frequently required which differ from the default. The custom pop-up menu dpi and pixel values can be specified in the Preview Resolutions (pixel or dpi) field, as a comma-separated list. Note that images will not be scaled up from their original resolution (i.e., if the image is 512 pixels, and the user clicks 768 pixels, the preview will be only 512 pixels). The preview resolution default pop-up list values are: 36, 72, 96, 144 dpi and 256, 512, 768, 1024 pixel.
The setting of the checkboxes Enable Register User Option and Enable Forgot Password Option determines whether the Register as a New User and Forgot Password? links become available in the login window.
With the option Enforce RSA Crypted Passwords enabled, only encrypted user logins are permitted. For this purpose, Java Script must be active in the web browser.
Click on the Save Preferences button to save modifications. Otherwise the changes will not be saved and will be lost.
The "User Administration" window (Fig. 8) has basically the same features as the "My User Preferences" window (5.3 "My User Preferences"). But in addition, it allows authorized users, e.g. System Administrators, to create and delete WebShare virtual users, and to assign them preset values for Download Encoding and Zip Streaming Format.
In the User Name field enter an arbitrary name. This user name need not exist on the host. You may also enter the name of an existing HELIOS user on that host. Then assign a password to the user in the Password field.
Note: It is compulsory for a WebShare Virtual User to have a password assigned. A Host User need not have a WebShare password, but it is highly recommended for security reasons. See Change WebShare password in 5.3 "My User Preferences".
With the Cannot change Password option active, users are prevented from modifying their password. This option can only be changed by authorized users, e.g. the WebShare administrator.
If the user specified in the User Name field is not a host user, then the entered name must be mapped to a HELIOS host user name in the Run as Host User field. (Note that the specified host user must already exist on the host.)
If an E-Mail address is specified, it appears in the individual user settings (see 5.3 "My User Preferences"). This user e-mail address is for reference purposes only, for the convenience of administrators. It is not otherwise used. The next three fields are optional and need not be filled out: Comment serves as a means to provide additional information on the WebShare user, e.g. to which company or department they belong (see Fig. 8). An expiry date may be specified in the Expires field. The syntax must match that from the example next to the field.
Download Encoding specifies the default download encoding for the user client platform. The setting determined here is applied as the default in the Download Encoding pop-up menu (see 5.3 "My User Preferences").
With the Zip Streaming Format checkbox ticked, the file download uses Zip streaming, which allows file compression on-the-fly, without creating any temporary files.
After creating a WebShare user, or configuring existing users, click on the Save Changes button before proceeding to other tasks. Otherwise the entries will not be saved. To clear all data entry fields and set the Download Encoding and Zip Streaming Format back to the default values, click on the Clear button.
Important: Do not click on Save Changes at this point because the data entry fields still contain the user information, and hence the user will be re-created!
For a correct table display you may need to update the window by clicking the Refresh button at the top of the window. The table listing the WebShare users can be sorted by clicking on the desired column header.
Note: Deleting users removes only virtual users, and host user (WebShare) passwords.
In the event that a system administrator needs to drop a user connection, there are two primary methods:
One is to use the "HELIOSDIR/bin/swho -c" command to list active users and the corresponding process ID (pid). Then "kill -TERM pid" can be used to terminate that process.
Use HELIOS Admin (Lists > Active Users) to show the connections, and either the "Delete" key or the menu item Edit > Clear to terminate the selected connection.
WebShare sharepoints can be organized to suit the required demands, for example, of a production site. The below diagram shows an example where a HELIOS EtherShare or PCShare volume is published via WebShare. At Customer C's site only the CEO is allowed to have full read and write access to the volume. However, the sharepoint is configured to the effect that the staff at Customer C's site is only allowed download access. Each user is only able to see their own projects. It is possible to share the same projects for different users with individual permissions.
With the "Sharepoint Administration" window (Fig. 9) WebShare sharepoints can be created, configured or deleted.
The sharepoint "WebShare Public" is created under the path "HELIOSDIR/public/WebShare" during the installation. By default, it has no write access.
In the Sharepoint Name field enter the name you want to assign to the sharepoint, and then specify the Sharepoint Path. (Note that the specified path must already exist with adequate access rights on the host.)
In the (optional) E-Mail on Access field enter an E-Mail address for notification mails after a user has downloaded, uploaded, deleted, or just previewed a file. (The e-mail is sent as soon as the user has logged off.) Make sure that the complete WebShare sender account is specified, e.g. webshare@mycompany.com
The optional Comment field allows entering additional information about the sharepoint. The comments are displayed in the "Home" window (see Fig. 5).
With the Publish checkbox at the top of the window you can specify if the sharepoint is available at all.
The following options determine whether the buttons in the sharepoint toolbar are available, or grayed out:
Allow Preview
Allows the previewing of text documents. ImageServer is required to preview image files, and QuarkXPress and InDesign documents. ImageServer and PDF HandShake are needed to preview PDF documents (see 7.5 "Image and document previews" for complete details).
Allow Copy
Allows copying, moving, duplicating and pasting marked files and folders. Also allows creating directories by use of the Create Dir option in the "Actions" pop-up menu.
Allow Rename
Allows renaming a marked file or folder by use of the Rename option in the "Actions" pop-up menu. In addition, this option allows the tagging of files and folders with color labels (see 4.5 "Color Label Preferences").
Note: Changing permissions is only allowed if also Allow Rename is allowed.
Download Layouts Only
Specifies that only files inside layout folders in the sharepoint can be downloaded. Layout files are low-resolution proxy files created by ImageServer, for use in OPI aware page layout applications.
Note: The Download Layouts Only function requires that Allow Download is also active. Otherwise no download action will be possible at all.
Always Allow Reading
Allows file and folder read access for all WebShare users, regardless of their host file and folder permissions. This option only affects the downloading or previewing of files.
Always Allow Read/Write
Allows file and folder read/write access for all WebShare users, regardless of their host file and folder permissions. This option only affects the uploading, downloading, or previewing of files, NOT other file management options (e.g. copy/move/paste).
Note: The Always Allow Reading and Always Allow Read/Write options will only appear if enabled by a preference key setting. See AllowAllReadWrite in 7.8 "Preference keys".
If there are no entries in either of the fields, all WebShare users can access the sharepoint. Entries in the Allowed Users field allow only those particular users to access the sharepoint. Likewise, entries in Allowed Groups allow only members of those groups to access the sharepoint. Users who are not allowed access to a sharepoint will not even see it, it will be hidden from them.
Note: Valid names in the Allowed Users field may be WebShare user names or host user names. The Allowed Groups field accepts valid host group names. Each entry must be in a separate line.
After creating a WebShare sharepoint, or configuring existing sharepoints, click on the Save Changes button before proceeding to other tasks. Otherwise the entries would not be saved and get lost. To clear the data entry fields click on the Reset button.
To set up different access rights for the same UNIX directory on the WebShare File Server you can create multiple sharepoints, with the same path but each with a unique name and different access rights (Allowed Users, Allowed Groups).
Likewise, it is possible to set up different file management and previewing options for the same UNIX directory on the WebShare File Server by creating two sharepoints, with the same path but different allowances (Allow Preview, Allow Download, Allow Upload, Allow Copy, Allow Delete, Allow Rename, Always Allow Reading, Always Allow Read/Write and Download Layouts Only).
After creating a sharepoint you may wish to view the file permissions corresponding to the sharepoint content.
Click on the Home button, and then on the desired sharepoint. Use the Set View button to view the permissions. If you desire to change the permissions, refer to 5.2.1 "The "Actions" pop-up menu" for details.
These permissions will be inherited by any files uploaded via WebShare, and hence determine which users will be able to view files, and change file permissions. Likewise, you may wish to change the file permissions for any existing files in the sharepoint, to enable the desired access for users.
Select a sharepoint from the table and click on the Delete button. For a correct table display you may need to update the window by clicking the Refresh button at the top of the window. The table listing the WebShare sharepoints can be sorted by clicking on the desired column header.
The Macintosh system allows the tagging of files and folders with "labels" in the Finder, e.g. in order to assign different levels of importance. Apple supported this feature up to Mac OS 9. In Mac OS X 10.1 and 10.2, there was no such support. With the new Mac OS X 10.3 this feature is available again.
WebShare also provides this feature and offers built-in default color labels which resemble Apple's color scheme (Fig. 10). Since Mac OS 9 uses other color schemes than Mac OS X 10.3, WebShare provides both color schemes, which are accessible by clicking the respective link in the window.
However, the label names and color definitions are arbitrary and can be edited to meet your requirements.
The "Accounting" window (Fig. 11) lists all user actions on the WebShare File Server. The default view displays Time, User, Client, Action, Target, Sharepoint, Path and Entry per action.
By means of the pop-up menu you can choose which accounting file is displayed in the "WebShare Accounting" window. The content is taken from the files "webshare.acct" (today) to "webshare.acct.6" (seven days ago), which are stored in "HELIOSDIR/var/adm".
The Set View button changes how the data is displayed. Underlined column headers can be clicked to change the sort order. An entry can appear with a yellow or red background. Red is used to highlight security warnings (e.g. login errors). Yellow is used for informational warnings (e.g. download errors).
The "Java Server Statistics" window (Fig. 12) is organized in 4 sections: WebShare Server Information, WebShare Java Information, WebShare User Statistics and WebObjects License Information.
General information about the WebShare WebObjects host like the host name, the server start time, the uptime, the number of HTTP connections and the average time per HTTP transaction, i.e. the elapsed time between HTTP request and response. In addition, the total amounts of uploaded, downloaded and preview data are displayed.
The WebShare Java Information provides information on the OS, the Java version as well as the assigned and available memory.
In this section, WebShare information about the WebObjects license is provided. The WebObjects deployment license should not have any limits, so that Unlimited is displayed in the "WebShare Java Server Statistics" window.
The WebShare WebObjects Server needs Java 1.4.1 or newer. Older versions produce some "Class not found" errors, which do not identify the problem.
Please make sure that Java is found when "start-helios" is issued. A symbolic link from your Java runtime to
"/usr/bin/java" could be a solution. The Java version can be verified via the command line:
Our testing with the WebShare WebObjects Server revealed that Java runs out of memory on Mac OS X 10.2.6.
Our testing with the WebShare WebObjects Server revealed that Java runs out of memory on Linux Kernel 2.4.18.
Many browsers only support the data fork for the upload. This means that additional information like a custom icon, the correct Type & Creator, etc. gets lost during the upload.
Create a Zip Archive using StuffIt DropZip or Mac OS X 10.3 Finder Zip archives, which will include all meta data and WebShare will correctly unpack it on the server. A second benefit is that Zip archives are smaller.
DropZip archives on the Mac OS 9 & Mac OS X platforms do not include proper resource information, e.g. icon, type & creator, preview.
Go to DropZip preferences -> MacBinary and select "Always MacBinary" to ensure full Macintosh file compatibility.
All major browsers support UTF-8 Web pages, unfortunately some fail to accept/preserve file names in upload forms with umlauts, special characters, etc.
Create a Zip archive and upload the archive. StuffIt DropZip and Windows Zip include correct file names which will be unpacked correctly on the server by WebShare.
Files are displayed with a generic icon instead of the application or document icon in the sharepoint window.
This may occur when the icon information in the desktop database is missing. Install an appropriate application for the file in one of the EtherShare server volumes on the host. After issuing "stop-helios" and "start-helios" on the host the icons should appear correctly in the sharepoint window.
Note: If only WebShare is installed on the server, only custom icons and the default document icon will be displayed. In order to display Macintosh application and document icons, EtherShare or a Mac OS X HFS disk is required. Files uploaded from Windows and other non-Macintosh clients are displayed with the default document icon.
For remote file preview the HELIOS ImageServer software must be installed with either a final or demo license.
| © 2005 HELIOS Software GmbH |
|
|
|
|
|
