Nasuni Desktop Client User Guide

Transcription

1 Nasuni combines the best features of consumer file-sharing applications with the secure and robust storage infrastructure that enterprises demand. The Nasuni Desktop Client provides an easy-to-use, enterprise-friendly service for accessing enterprise data. The Nasuni Desktop Client is available for the following platforms. Operating System x86 x86 64 Windows 7 Yes Yes Windows 8.1 Yes Yes Windows 10 Yes Yes Windows Server 2008 Windows Server 2012 Yes Yes OS X Mavericks 10.9 OS X Yosemite OS X El Capitan Yes Yes Yes In addition to the Nasuni Desktop Client, Nasuni also offers native apps for data access using mobile devices as well as direct Web access, enabling end users to directly and securely access enterprise data. This document outlines the steps necessary to install and use the Nasuni Desktop Client. Your system administrator might provide you with configuration information. If you need help, contact your system administrator. Contents: Installing the Nasuni Desktop Client (Windows) on page 2 Installing the Nasuni Desktop Client (Mac OS X) on page 4 Installing the Nasuni Desktop Client (Linux) on page 5 Configuring the Nasuni Desktop Client (Windows) on page 6 Configuring the Nasuni Desktop Client (Mac OS X) on page 12 Configuring the Nasuni Desktop Client (Linux) on page 18 Nasuni Desktop Client controls (Windows and Mac OS X) on page 21 Using the Nasuni Desktop Client (Windows and Mac OS X) on page 24 Using the Nasuni Desktop Client (Linux) on page 26 Last modified: July 17, /

2 Installing the Nasuni Desktop Client (Windows) To install the Nasuni Desktop Client, follow these steps: 1. Locate the appropriate Nasuni Desktop Client installation.exe file on your computer. 2. Double-click the installation file to begin the installation. If a security warning appears, click Run. 3. The Nasuni Desktop Client Setup wizard runs. The Terms of Service and version information appear. Follow these steps: Figure 1-1: Terms of Service. a. Click I agree to the license terms and conditions, then click Install. The Welcome screen appears. Figure 1-2: Welcome screen. 2

3 b. Click Next. If the Destination Folder page appears, do not change the destination folder, unless instructed otherwise. Click Next. The Ready to install Nasuni Desktop Client page appears. Figure 1-3: Ready to install Nasuni Desktop Client. c. Click Install. The installation begins. This installation can take several minutes to complete. Several windows might open and close during the installation. d. When the installation completes, click Finish. The Nasuni Desktop Client Setup Wizard closes. The NasuniDesktopService service is started as a Windows service. The Nasuni Desktop Client Add Connection Wizard appears. If the Nasuni Desktop Client Add Connection Wizard does not appear, click the Nasuni Desktop Client icon in the System Tray at the bottom right of your screen. Figure 1-4: Nasuni Desktop Client icon. Continue with Configuring the Nasuni Desktop Client (Windows) on page 6. 3

4 Installing the Nasuni Desktop Client (Mac OS X) To install the Nasuni Desktop Client, follow these steps: 1. Locate the appropriate Nasuni Desktop Client installation.mpkg file on your computer. 2. Double-click the installation file to begin the installation. If a security warning appears, click Run. 3. The Install Nasuni Desktop Client window appears. 4. Click Continue. The Read Me file appears. 5. Click Continue. License and Terms of Service information appear. 6. Click Continue. A dialog box appears asking if you agree to the terms. 7. Click Agree. Destination Select information appears. 8. Click Continue. Installation Type information appears. Do not change anything unless instructed to do so. 9. Click Install. If requested, enter a valid user Name and Password. The installation begins. This installation can take several minutes to complete. 10. When the installation completes, click Close. The Install Nasuni Desktop Client window closes. 11. The Nasuni Desktop Client icon appears in the menu bar at the top right of your screen. Figure 1-5: Nasuni Desktop Client icon. Continue with Configuring the Nasuni Desktop Client (Mac OS X) on page 12. 4

5 Installing the Nasuni Desktop Client (Linux) To install the Nasuni Desktop Client on a Linux system, follow these steps: 1. Download the appropriate Nasuni Desktop Client installation package to your computer. 2. At the command prompt, on Red Hat or CentOS systems, execute this command: sudo rpm -Uvh <package-name> On Debian or Ubuntu systems, execute this command: sudo dpkg -i <package-name> where sudo: Use sudo or another method to run the command as root. rpm is the Linux RPM Package Manager, or equivalent. U means Upgrade. h means hash. v means verbose. dpkg is the Debian package management system, or equivalent. i means Install. <package-name> is the name of the installation package. Continue with Configuring the Nasuni Desktop Client (Linux) on page 18. 5

6 Configuring the Nasuni Desktop Client (Windows) To configure the Nasuni Desktop Client, follow these steps: 1. If the Nasuni Desktop Client Add Connection Wizard does not appear, click the Nasuni Desktop Client icon in the System Tray at the bottom right of your screen. Figure 1-6: Nasuni Desktop Client icon. 2. On the Nasuni Desktop Client Add Connection Wizard, the 01 Connect to a Filer page appears. Figure 1-7: Nasuni Desktop Client Add Connection Wizard, 01 Connect to a Filer page. Follow these steps: a. In the Filer Name or IP Address text box, enter the DNS name or the IP address of the Nasuni Filer. IP addresses look like this: Also, enter the port necessary to access the Nasuni Filer. The normal port is 443. b. Enter the Username for the Nasuni Filer. Note: You generally must use Active Directory credentials to log in. If there is at least one volume on the Nasuni Filer with Public authentication, you can use non-active Directory credentials to log in. c. Enter the Password for the Username on the Nasuni Filer. 6

7 d. If there is no proxy, select No Proxy. Otherwise, if there is a proxy, select Manual, then follow these steps: i. From the Proxy Type drop-down list, select one of the following proxy types: ii. HTTP: For an HTTP Web proxy. SOCKS4: For a proxy using the SOCKS4 (Socket Secure) protocol. SOCKS5: For a proxy using the SOCKS5 (Socket Secure) protocol. In the Server text box, enter the DNS name or the IP address of the proxy server. IP addresses look like this: Also, enter the port necessary to access the proxy server. The normal port is 0. iii. If the proxy server does not require a password, clear the Proxy Server requires a password check box. Otherwise, select the Proxy Server requires a password check box. Then enter the Username and Password for the proxy server. e. Click Login. The Nasuni Desktop Client Add Connection Wizard logs in to the Nasuni Filer using the specified parameters. Tip: If you receive a Login - Authentication Failure error, try step a on page 12 through step d on page 13 again. If you continue to receive this error, notify your system administrator. Desktop and Mobile Access might not be enabled for the share. f. The 02 Choose Source page appears. Figure 1-8: 02 Choose Source page. 7

8 3. On the 02 Choose Source page, follow these steps: a. If you know the complete path to the share, select the radio button beside the text box, then enter the complete path to the share in the text box. The following characters are not valid: < > /? * Otherwise, if you do not know the complete path to the share, select the radio button beside the directory tree diagram, and then click the source share or subdirectory on the Nasuni Filer. Tip: You must be able to navigate the entire path to the source directory. b. Click Next. c. The 03 Choose Target page appears. Figure 1-9: 03 Choose Target page. 4. On the 03 Choose Target page, follow these steps: a. Navigate to the target directory on your local computer. Note: You can only use local drives, not remote network drives. Tip: You must be able to navigate the entire path to the target directory. To optionally create a new directory, navigate to where you want to create the new directory, then click Create Folder. Type the name of the new directory, then press Enter. b. Click Next. 8

9 c. The 04 Preferences page appears. Figure 1-10: 04 Preferences page. 5. On the 04 Preferences page, follow these steps: a. (Optional) To exclude any files or directories from being shared, in the Exclusion List text box, enter a comma-separated list of file names or directory names. Do not include any spaces. You can also use wildcards and regular expressions, as listed here:? - Any one character. * - Any zero or more characters. + - Zero or more occurrences of prior pattern character. [] - Any of the characters contained between the brackets. %a - Letter (a-z or A-Z). %d - Digit (0-9). %x - Hex Digit (0-9 or a-f or A-F). %n - Alphanumeric (a-z or A-Z or 0-9). %w - Alphanumeric (a-z or A-Z or 0-9) or underscore character ( _ ). %s - Whitespace (such as spaces or tabs). Such as: C:\Nasuni\*.wav C:\Nasuni\[abc]*.tmp b. (Optional) In the Sync Frequency area, select the time between each attempted synchronization between the Desktop Client and the Nasuni Filer. First, select the time units (Minutes or Hours) from the drop-down list. Then, select the time value from the drop-down list. The default value is 5 minutes. 9

10 c. (Optional) You can control the direction of data flow between the Nasuni Desktop Client and the Nasuni Filer. Warning: If a file changes on the Nasuni Desktop Client and synchronizes with the Nasuni Filer, the Client version of the file overwrites the Filer version of the file if it already exists. To recover an earlier version of the file, use File Browser. Warning: When considering synchronizing data in existing folders, especially when the folders already contain data, verify that you want them synchronized. If you want the data to be separate, creating another directory or share that is not synchronized might be preferable. From the Connection Direction drop-down list, select one of the following: Bi-Directional: Allows data to flow from the Desktop Client to the Nasuni Filer, and vice versa. This is the default choice. Only Filer to Client: Allows data to flow only from the Nasuni Filer to the Desktop Client. Only Client to Filer: Allows data to flow only from the Desktop Client to the Nasuni Filer. d. (Optional) To limit the amount of local disk space to use for data, select the percentage of the local disk to use from the Max Disk Space Allowed drop-down menu. e. (Optional) To allow uploads of smaller files to the Nasuni Filer before the expiration of the Sync Frequency, select the Enable Instant Upload check box. Then enter the Maximum File Size. First, select the file size units (KB, MB, GB, or TB) from the drop-down list. Then, in the Maximum File Size text box, enter the largest file size that you want to upload in this way. The default value is 2 MB. Otherwise, to only upload when the Sync Frequency expires, clear the Enable Instant Upload check box. Note: If you increase the Maximum file size, then data already in the target directory that is now smaller than the new Maximum file size does not upload to the Nasuni Filer before the Sync Frequency expires. However, new data in the target directory that is smaller than the new Maximum file size does upload to the Nasuni Filer before the Sync Frequency expires. 10

11 f. Click Next. The Nasuni Desktop Client Add Connection Wizard configures the Nasuni Desktop Client as specified. The Summary page appears. Figure 1-11: Summary page. The Summary page displays the following information: Remote Path: The path to the share on the Nasuni Filer. Local Path: The path to the local directory on the computer. Connection Direction: The direction of data flow: Bi-Directional, Only Filer to Client, or Only Client to Filer. Instant Upload: An indication of whether Instant Upload is enabled, and the maximum file size to upload immediately. Max Disk Space: The maximum amount of local disk space to use for the target directory. Sync Frequency: How often to synchronize the Nasuni Filer and the Desktop Client. Exclusion List: The files to exclude from synchronization. 6. Click Done. The Nasuni Desktop Client Add Connection Wizard closes. 11

12 Configuring the Nasuni Desktop Client (Mac OS X) To configure the Nasuni Desktop Client, follow these steps: 1. If the Nasuni Desktop Client Add Connection Wizard does not appear, click the Nasuni Desktop Client icon in the menu bar at the top right of your screen. Figure 1-12: Nasuni Desktop Client icon. 2. On the Nasuni Desktop Client Add Connection Wizard, the 01 Connect to a Filer page appears. Figure 1-13: Nasuni Desktop Client Add Connection Wizard, 01 Connect to a Filer page. Follow these steps: a. In the Filer Name/IP Address text box, enter the DNS name or the IP address of the Nasuni Filer. IP addresses look like this: Also, enter the port necessary to access the Nasuni Filer. The normal port is 443. b. Enter the Username for the Nasuni Filer. Note: You generally must use Active Directory credentials to log in. If there is at least one volume on the Nasuni Filer with Public authentication, you can use non-active Directory credentials to log in. c. Enter the Password for the Username on the Nasuni Filer. 12

13 d. If there is no proxy, select No Proxy. Otherwise, if there is a proxy, select Manual, then follow these steps: i. From the Proxy Type drop-down list, select one of the following proxy types: ii. HTTP: For an HTTP Web proxy. SOCKS4: For a proxy using the SOCKS4 (Socket Secure) protocol. SOCKS5: For a proxy using the SOCKS5 (Socket Secure) protocol. In the Server text box, enter the DNS name or the IP address of the proxy server. IP addresses look like this: Also, enter the port necessary to access the proxy server. The normal port is 0. iii. If the proxy server does not require a password, clear the Proxy Server requires a password check box. Otherwise, select the Proxy Server requires a password check box. Then enter the Username and Password for the proxy server. e. Click Login. The Nasuni Desktop Client Add Connection Wizard logs in to the Nasuni Filer using the specified parameters. Tip: If you receive a Login - Authentication Failure error, try step a on page 12 through step d on page 13 again. If you continue to receive this error, notify your system administrator. Desktop and Mobile Access might not be enabled for the share. f. The 02 Choose Source page appears. Figure 1-14: 02 Choose Source page. 13

14 3. On the 02 Choose Source page, follow these steps: a. If you know the complete path to the share, select the radio button beside the text box, then enter the complete path to the share in the text box. The following characters are not valid: < > /? * Otherwise, if you do not know the complete path to the share, select the radio button beside the directory tree diagram, and then click the source share or subdirectory on the Nasuni Filer. Tip: You must be able to navigate the entire path to the source directory. b. Click Next. c. The 03 Choose Target page appears. Figure 1-15: 03 Choose Target page. 4. On the 03 Choose Target page, follow these steps: a. Navigate to the target directory on your local computer. Note: You can only use local drives, not remote network drives. Tip: You must be able to navigate the entire path to the target directory. To optionally create a new directory, navigate to where you want to create the new directory, then click Create Folder. Type the name of the new directory, then press Enter. b. Click Next. 14

15 c. The 04 Preferences page appears. Figure 1-16: 04 Preferences page. 5. On the 04 Preferences page, follow these steps: a. (Optional) To exclude any files or directories from being shared, in the Exclusion List text box, enter a comma-separated list of file names or directory names. Do not include any spaces or colons (:). You can also use wildcards and regular expressions, as listed here:? - Any one character. * - Any zero or more characters. + - Zero or more occurrences of prior pattern character. [] - Any of the characters contained between the brackets. %a - Letter (a-z or A-Z). %d - Digit (0-9). %x - Hex Digit (0-9 or a-f or A-F). %n - Alphanumeric (a-z or A-Z or 0-9). %w - Alphanumeric (a-z or A-Z or 0-9) or underscore character ( _ ). %s - Whitespace (such as spaces or tabs). Such as: *.wav [abc]*.tmp b. (Optional) In the Sync Frequency area, select the time between each attempted synchronization between the Desktop Client and the Nasuni Filer. First, select the time units (Minutes or Hours) from the drop-down list. Then, select the time value from the drop-down list. The default value is 5 minutes. 15

16 c. (Optional) You can control the direction of data flow between the Nasuni Desktop Client and the Nasuni Filer. Warning: If a file changes on the Nasuni Desktop Client and synchronizes with the Nasuni Filer, the Client version of the file overwrites the Filer version of the file if it already exists. To recover an earlier version of the file, use File Browser. Warning: When considering synchronizing data in existing folders, especially when the folders already contain data, verify that you want them synchronized. If you want the data to be separate, creating another directory or share that is not synchronized might be preferable. From the Connection Direction drop-down list, select one of the following: Bi-Directional: Allows data to flow from the Desktop Client to the Nasuni Filer, and vice versa. This is the default choice. Only Filer to Client: Allows data to flow only from the Nasuni Filer to the Desktop Client. Only Client to Filer: Allows data to flow only from the Desktop Client to the Nasuni Filer. d. (Optional) To limit the amount of local disk space to use for data, select the percentage of the local disk to use from the Max Disk Space Allowed drop-down menu. e. (Optional) To allow uploads of smaller files to the Nasuni Filer before the expiration of the Sync Frequency, select the Enable Instant Upload check box. Then enter the Maximum File Size. First, select the file size units (KB, MB, GB, or TB) from the drop-down list. Then, in the Maximum File Size text box, enter the largest file size that you want to upload in this way. The default value is 2 MB. Otherwise, to only upload when the Sync Frequency expires, clear the Enable Instant Upload check box. Note: If you increase the Maximum file size, then data already in the target directory that is now smaller than the new Maximum file size does not upload to the Nasuni Filer before the Sync Frequency expires. However, new data in the target directory that is smaller than the new Maximum file size does upload to the Nasuni Filer before the Sync Frequency expires. 16

17 f. Click Next. The Nasuni Desktop Client Add Connection Wizard configures the Nasuni Desktop Client as specified. The Summary page appears. Figure 1-17: Summary page. The Summary page displays the following information: Remote Path: The path to the share on the Nasuni Filer. Local Path: The path to the local directory on the computer. Connection Direction: The direction of data flow: Bi-Directional, Only Filer to Client, or Only Client to Filer. Instant Upload: An indication of whether Instant Upload is enabled, and the maximum file size to upload immediately. Max Disk Space: The maximum amount of local disk space to use for the target directory. Sync Frequency: How often to synchronize the Nasuni Filer and the Desktop Client. Exclusion List: The files to exclude from synchronization. 6. Click Done. The Nasuni Desktop Client Add Connection Wizard closes. 17

18 Configuring the Nasuni Desktop Client (Linux) To configure the Nasuni Desktop Client on a Linux system, follow these steps: 1. At the command prompt, execute this command: /usr/bin/nasuni-desktop-client This creates the.ndc folder and the Config.ini file. If there are errors, error messages appear. You should also check the log file, which is located in.ndc/nslog. Warning: Do not delete the.config.json file that is created during this process. 2. At the command prompt, execute this command: /usr/bin/nasuni-genauthkey Enter the following information when requested: The IP address of the Nasuni Filer. IP addresses look like this: Tip: The IT administrator responsible for the Nasuni Filer should have this information. Enter the port necessary to access the Nasuni Filer. The normal port is 443. The default port is 0. Tip: The IT administrator responsible for the Nasuni Filer should have this information. Enter the Username for the Nasuni Filer. Note: You must use either local authentication or Active Directory authentication to log in. The volume on the Nasuni Filer must have the CIFS protocol enabled. Enter the Password for the Username on the Nasuni Filer. Is a proxy configured for the network connection: y or n. Tip: The above information is stored with the client. You don t need to re-enter this information unless it changes, in which case you should re-run nasuni-genauthkey. 3. Edit the Nasuni Desktop Client Config.ini file, following these steps: a. Open the Config.ini file, usually located in the ~/.ndc directory, for editing. b. Enter values for these parameters: NUMBER_OF_CONNECTIONS: Enter the number of connections. Each of the connections requires a separate set of parameters that defines the connection, such as in the following example: NUMBER_OF_CONNECTIONS=3 LOCAL_ROOT=/home/nasuni/filersync-1 REMOTE_ROOT=volume-1 ; LOCAL_ROOT=/home/nasuni/filersync-2 REMOTE_ROOT=volume-2 ; LOCAL_ROOT=/home/nasuni/filersync-3 18

19 REMOTE_ROOT=volume-3 For each connection, enter the following parameters: REMOTE_ROOT: Enter the complete path to the share. The following characters are not valid: < > /? * Tip: You must be able to navigate the entire path to the source directory. LOCAL_ROOT: Enter the complete path to the target directory on your local computer. Note: You can only use local drives, not remote network drives. Tip: You must be able to navigate the entire path to the target directory. EXCLUSION_LIST: (Optional) If there are no excluded files or directories, comment this line out. Alternatively, to exclude any files or directories from being shared, enter a commaseparated list of file names or directory names. Do not include any spaces. You can also use wildcards and regular expressions, as listed here:? - Any one character. * - Any zero or more characters. + - Zero or more occurrences of prior pattern character. [] - Any of the characters contained between the brackets. %a - Letter (a-z or A-Z). %d - Digit (0-9). %x - Hex Digit (0-9 or a-f or A-F). %n - Alphanumeric (a-z or A-Z or 0-9). %w - Alphanumeric (a-z or A-Z or 0-9) or underscore character ( _ ). %s - Whitespace (such as spaces or tabs). Such as: /home/nasuni/*.wav /home/nasuni/[abc]*.tmp SYNC_FREQUENCY: (Optional) Enter the time in minutes between each attempted synchronization between the Desktop Client and the Nasuni Filer. The default value is 5 minutes. 19

20 CONNECTION_DIRECTION: (Optional) You can control the direction of data flow between the Nasuni Desktop Client and the Nasuni Filer. For bi-directional data flow, enter 3. This is the default. For data flow from Filer to Client, enter 1. For data flow from Client to Filer, enter 2. Warning: If a file changes on the Nasuni Desktop Client and synchronizes with the Nasuni Filer, the Client version of the file overwrites the Filer version of the file if it already exists. To recover an earlier version of the file, use File Browser. Warning: When considering synchronizing data in existing folders, especially when the folders already contain data, verify that you want them synchronized. If you want the data to be separate, creating another directory or share that is not synchronized might be preferable. INSTANT_UPLOAD: (Optional) To allow uploads of smaller files to the Nasuni Filer before the expiration of the Sync Frequency, enter 1. To disable Instant Upload, enter 0 (zero). If Instant Upload is enabled, enter MAX_FILE_SIZE_UPLOAD in MB. The default value is 2 MB. Note: If you increase the Maximum file size, then data already in the target directory that is now smaller than the new Maximum file size does not upload to the Nasuni Filer before the Sync Frequency expires. However, new data in the target directory that is smaller than the new Maximum file size does upload to the Nasuni Filer before the Sync Frequency expires. MAX_ALLOWED_DISK_CAPACITY: (Optional) Enter the percentage of the local disk to use. c. Save and exit the Config.ini file. 4. At the command prompt, execute this command a second time: /usr/bin/nasuni-desktop-client & This launches the Nasuni Desktop Client. Warning: Do not delete the.config.json file that is created during this process. Tip: A command similar to the above should be executed whenever the computer reboots. Continue with Using the Nasuni Desktop Client (Linux) on page

21 Nasuni Desktop Client controls (Windows and Mac OS X) You can perform a number of actions using the Nasuni Desktop Client controls. To access the Nasuni Desktop Client controls, click the Nasuni Desktop Client icon on your screen. Figure 1-18: Nasuni Desktop Client icon. The color of the Nasuni Desktop Client icon indicates the state of the Nasuni Desktop Client, as follows: Red: Indicates critical conditions, including service not responding, unable to access the Nasuni Filer, and authentication failure. Yellow: Indicates connection-specific conditions. A yellow icon with yellow information indicates conditions such as an invalid connection. A yellow icon with a yellow cross indicates conditions such as quota exceeded and client space limit exceeded. When the icon is yellow, the Manage Connection option in the menu has a yellow information overlay, and the menu itself is blue. Note: If the icon is yellow because a previous sync attempt exceeded the quota of the Nasuni Filer, and a smaller file that does not exceed the quota is synchronized, the icon might temporarily turn green before reverting back to yellow again. Green: Indicates synchronization states. Green with a green check mark indicates that the application is In Sync. Green with a blue check mark indicates that the application is Out of Sync. Green with a white check mark indicates that there is no connection. The Nasuni Desktop Client control menu appears. Figure 1-19: Nasuni Desktop Client control menu. Creating a new connection to the Nasuni Filer To create a new connection to the Nasuni Filer, click Create a Connection. The currently selected source is highlighted in red. See step 3 on page 14 for details. 21

22 Managing existing connections to Nasuni Filer To manage existing connections to the Nasuni Filer, as in step 5 on page 15, click Manage Connections. The Nasuni Desktop Client Manage Connections dialog box opens, allowing you to edit or delete existing connections. To edit an existing connection, select the connection, then click Edit Connection. See step 5 on page 15 for details. To delete an existing connection, select the connection, then click Delete Connection. A dialog box appears asking for permission to delete the connection. To delete the connection, click OK. Otherwise, click Cancel. Changing preferences To change other preferences, click Preferences. Changing proxy On the Proxy tab, you can change the proxy configuration. For details, see step d on page 13. When done, click Apply. Configuring logging On the General tab, in the Logging area, you can configure details of logging events for the Nasuni Desktop Client. In the Log Size text box, enter the maximum size of the log file in MB. When the log file reaches the maximum size, it is saved with a new name and a new log file is started. The default maximum log file size is 40 MB. From the Log Level drop-down list, select the level of logging from the following choices: CRITICAL: The Nasuni Desktop Client cannot run further, due to conditions such as failing to create a thread or to allocate memory. ERROR: A non-fatal error occurs, such as a failure to upload or download files. Also includes all CRITICAL entries. WARNING: Any condition that does not affect functionality and that the Nasuni Desktop Client can handle itself, such as auth key expiration. Also includes all CRITICAL and ERROR entries. INFO: Names of files or directories uploaded or downloaded. Also includes all CRITICAL, ERROR, and WARNING entries. This is the default Log Level. DEBUG: Includes messages like function entry and exit for understanding the code execution path. Also includes all CRITICAL, ERROR, WARNING, and INFO entries. TRACE: Complete trace messages from code execution, including function input and output variables, states of local and global variables. Used for troubleshooting any issues. Also includes all CRITICAL, ERROR, WARNING, INFO, and DEBUG entries. Tip: To minimize logging, select CRITICAL. To monitor names of files and directories uploaded or downloaded, select INFO. Use DEBUG and TRACE only to troubleshoot issues. 22

23 Tip: On Windows, log files are stored in the NSLog folder in the destination folder where Nasuni Desktop Client was installed. The default location is C:\Program Files\Nasuni\ Nasuni Desktop Client\NSLog. On OS X, the log files are stored in /var/log/nslog. The default Log Level is INFO. When done, click Apply. Configuring bandwidth On the General tab, in the Bandwidth area, you can configure the maximum bandwidth to use. In the Upload Rate text box, first select the units of the upload rate (Kbps, Mbps, or Gbps), then enter the maximum rate to upload data to the Nasuni Filer. In the Download Rate text box, first select the units of the download rate (Kbps, Mbps, or Gbps), then enter the maximum rate to download data to the Nasuni Filer. A value of 0 (zero) indicates that there is no maximum bandwidth. When done, click Apply. Configuring Nasuni Filer access information On the Filer tab, you can configure the information necessary to access the Nasuni Filer, including the Filer Name or IP Address, the port, the Username, and the Password. See step a on page 12 for details. When done, click Apply. Updating the connection to the Nasuni Filer To update the connection to the Nasuni Filer, click Update. Viewing revision information of the Nasuni Desktop Client To view the revision information of the Nasuni Desktop Client, click About. Stopping the Nasuni Desktop Client To stop the Nasuni Desktop Client, click Exit. A dialog box appears asking for permission to stop the Nasuni Desktop Client. To stop the Nasuni Desktop Client, click OK. On Windows, this stops the NasuniDesktopService service. On OS X, this stops the OS X service. Nasuni Web page To open the Nasuni Web page, click Nasuni. Latest synced files To view a list of the latest synced files, click Latest Sync. The Nasuni Desktop Client Latest Synced Files Information dialog box appears. You can view the File Name, Local path, and Modified Time of the last 5 synced files. Click Close to close the list. 23

24 Using the Nasuni Desktop Client (Windows and Mac OS X) After the Nasuni Desktop Client is installed and configured, you can use it to easily copy files to and from the Nasuni Filer. Warning: The Nasuni Desktop Client is intended for single user systems. Do not use it for multiple users on the same system. Warning: Even if Case-Sensitive Paths is enabled for a share, file and folder names might be treated as case-insensitive. That is, file names such as ABCD.txt and Abcd.txt might be judged as identical. Avoid file and folder names that are caseinsensitive versions of other file and folder names. Warning: Because Microsoft Windows considers certain file names to be special, such as AUX, LPT1, and names containing special characters, avoid using such files with the Desktop Client. Using files or folders from the Nasuni Filer In step 3 on page 14 you selected a source share on the Nasuni Filer. Any files or folders in that source share are available in the target directory you selected in step 4 on page 14. To use files or folders from the Nasuni Filer, follow these steps: 1. Navigate to the target directory you selected in step 4 on page Within the target directory, navigate to the files or folders you want to use. On this display, there are several different kinds of icons: Green with checkmark: This folder or file has synchronized with the Nasuni Filer. Red with exclamation point: This folder or file has not yet synchronized with the Nasuni Filer. Tip: If the icons are not what you expect, try refreshing the display. 3. You can perform actions on any of these files or folders, including opening, copying, and deleting. Note: The specific results of some actions depend on the Connection Direction chosen in step c on page

25 Adding files or folders to the Nasuni Filer Any files or folders that you add to the target directory you selected in step 4 on page 14 are automatically transferred to the source share on the Nasuni Filer that you selected in step 3 on page 14. Note: The specific results of actions depend on the Connection Direction chosen in step c on page 16. Warning: If a file changes on the Nasuni Desktop Client and synchronizes with the Nasuni Filer, the Client version of the file overwrites the Filer version of the file if it already exists. To recover an earlier version of the file, use File Browser. Warning: When considering synchronizing data in existing folders, especially when the folders already contain data, verify that you want them synchronized. If you want the data to be separate, creating another directory or share that is not synchronized might be preferable. Note: If you create a large directory structure on the Nasuni Desktop Client and then immediately attempt to rename a file or folder in that structure, you might receive a message that a file or folder is currently open by another process. This is expected behavior. To add files or folders to the Nasuni Filer, follow these steps: 1. Copy files or folders. 2. Navigate to the target directory you selected in step 4 on page Within the target directory, navigate to the folder where you want to add files or folders. 4. Paste the copied files or folders in the target directory. On this display, there are several different kinds of icons: Green with checkmark: This folder or file has been synchronized with the Nasuni Filer. Red with exclamation point: This folder or file has not been synchronized with the Nasuni Filer. You can verify that any added files or folders are present on the Nasuni Filer by using the File Browser feature of the Nasuni Filer user interface or the Nasuni Management Console user interface, after the synchronization takes place. 25

26 Using the Nasuni Desktop Client (Linux) After the Nasuni Desktop Client is installed and configured, you can use it to easily copy files to and from the Nasuni Filer. Warning: The Nasuni Desktop Client is intended for single user systems. Do not use it for multiple users on the same system. Warning: Even if Case-Sensitive Paths is enabled for a share, file and folder names might be treated as case-insensitive. That is, file names such as ABCD.txt and Abcd.txt might be judged as identical. Avoid file and folder names that are caseinsensitive versions of other file and folder names. Warning: Because certain file names can be regarded as special, such as AUX, LPT1, and names containing special characters, avoid using such files with the Desktop Client. Using files or folders from the Nasuni Filer In step b on page 18 you selected a source share on the Nasuni Filer. Any files or folders in that source share are available in the target directory you selected in step b on page 18. To use files or folders from the Nasuni Filer, follow these steps: 1. Navigate to the target directory you selected in step b on page Within the target directory, navigate to the files or folders you want to use. 3. You can perform actions on any of these files or folders, including opening, copying, and deleting. Note: The specific results of some actions depend on the Connection Direction chosen in step b on page

27 Adding files or folders to the Nasuni Filer Any files or folders that you add to the target directory you selected in step b on page 18 are automatically transferred to the source share on the Nasuni Filer that you selected in step b on page 18. Note: The specific results of actions depend on the Connection Direction chosen in step b on page 18. Warning: If a file changes on the Nasuni Desktop Client and synchronizes with the Nasuni Filer, the Client version of the file overwrites the Filer version of the file if it already exists. To recover an earlier version of the file, use File Browser. Warning: When considering synchronizing data in existing folders, especially when the folders already contain data, verify that you want them synchronized. If you want the data to be separate, creating another directory or share that is not synchronized might be preferable. Note: If you create a large directory structure on the Nasuni Desktop Client and then immediately attempt to rename a file or folder in that structure, you might receive a message that a file or folder is currently open by another process. This is expected behavior. To add files or folders to the Nasuni Filer, use Linux commands to create, copy, or move files or folders to the target directory. You can verify that any added files or folders are present on the Nasuni Filer by using the File Browser feature of the Nasuni Filer user interface or the Nasuni Management Console user interface, after the synchronization takes place. 27

28 Uninstalling the Nasuni Desktop Client (Windows) Should it become necessary to uninstall the Nasuni Desktop Client, follow these steps: 1. Select Start Control Panel Programs and Features. The Programs and Features page appears. 2. Right-click Nasuni Desktop Client. 3. Select Uninstall. 4. The Nasuni Desktop Client Setup screen appears. Select Uninstall. Follow any prompts. Windows might open and close automatically. 5. A message appears indicating that the setup action was successful. Click Close. The Nasuni Desktop Client is uninstalled. Uninstalling the Nasuni Desktop Client (Mac OS X) Should it become necessary to uninstall the Nasuni Desktop Client, follow these steps: 1. Drag the Nasuni Desktop Client application to the Trash. 2. Drag the /Applications/NasuniDesktop folder to the Trash. The Nasuni Desktop Client is uninstalled. Copyright by Nasuni Corporation. All rights reserved. 28