Technical Documentation Nasuni Desktop Client Admin Guide

Nasuni Desktop Client Administrator Guide 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

Yes

Windows Server 2012

Yes

OS X Mavericks 10.9

Yes

OS X Yosemite 10.10

Yes

OS X El Capitan 10.11

Yes

In addition to the Nasuni Desktop Client, Nasuni also offers native apps for data access using mobile devices as well as direct browser-based access, enabling end users to directly and securely access enterprise data. This document outlines the steps necessary to administer, install, and use the Nasuni Desktop Client. If you need help, contact Nasuni Technical Support ([email protected]). All Nasuni documentation is at www.nasuni.com/support/documentation. Contents: •

“Enabling access for the Nasuni Desktop Client” on page 2

•

“Installing the Nasuni Desktop Client (Mac OS X)” on page 9

•

“Configuring the Nasuni Desktop Client (Mac OS X)” on page 17

•

“Nasuni Desktop Client controls (Windows and Mac OS X)” on page 26

•

“Using the Nasuni Desktop Client (Windows and Mac OS X)” on page 29

www.nasuni.com / [email protected]

Last modified: May 12, 2016

+1.508.433.6200 / +1.800.208.3418

Technical Documentation Nasuni Desktop Client Admin Guide

Enabling access for the Nasuni Desktop Client The Nasuni Desktop Client uses the same technology that provides the Nasuni Mobile Access service. This service enables mobile devices, such as iOS and Android devices, to access data on Nasuni Filers.

Using the Nasuni Filer user interface To enable access for the Nasuni Desktop Client using the Nasuni Filer user interface, follow these steps: 1. Click Volumes, then select from the list the volume with the CIFS share that you want to provide access to. Note: If this Nasuni Filer is under Nasuni Management Console control, this page is not available on the Nasuni Filer. Instead, use the Nasuni Management Console to view information or perform actions. 2. The Volume properties page appears. The Total Shares status is visible.

Figure 1-1: Total Shares status.

3. Click the Total Shares status. Alternatively, select CIFS Shares from the Properties dropdown list. The CIFS Shares page appears.

Figure 1-2: CIFS Shares page.

2 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

4. For the CIFS share that you want, click Edit Share. The Add CIFS Share/Edit Settings page appears.

Figure 1-3: Add CIFS Share/Edit Settings page.

5. Click Show Advanced Options. The Advanced Options pane appears. 6. Select the Desktop and Mobile Access check box. 7. Click Save Share. This enables access for the Nasuni Desktop Client.

3 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

8. You must also ensure that access is enabled for your target platform. Click Services, then select Mobile Service Settings from the list. The Mobile Service Settings page appears.

Figure 1-4: Mobile Service Settings page.

Note: If this Nasuni Filer is under Nasuni Management Console control, this page is not available on the Nasuni Filer. Instead, use the Nasuni Management Console to view information or perform actions. 9. In the Allowed Devices area, ensure that the platforms you want, such as Linux, OS X, and Windows, are selected. 10. To save your changes, click Save.

4 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

Using the Nasuni Management Console user interface To enable access for the Nasuni Desktop Client using the Nasuni Management Console user interface, follow these steps: 1. Click Volumes. The Volumes page appears. 2. On the Shares page, for the selected share, click Edit

. The Edit Share dialog box appears.

Figure 1-5: Edit Share dialog box.

3. To enable mobile access, select the Desktop and Mobile Access check box. 4. To accept your selections, click Update Share. The share is changed and appears in the list of shares. 5. You must also ensure that access is enabled for your target platform. Click Filers. The Filers page appears. 6. On the Mobile Service Settings page, select the Nasuni Filers in the list whose Mobile Access service settings you want to edit.

5 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

7. Click Edit Filers. The Edit Mobile Service Settings dialog box appears.

Figure 1-6: Edit Mobile Service Settings dialog box.

8. In the Allowed Devices area, ensure that the platforms you want, such as Linux, OS X, and Windows, are selected. 9. Click Save Settings. The Mobile Access service settings are changed. The Nasuni Filers appear in the list on the Mobile Service Settings page. Alternatively, to exit the dialog box without changing the Mobile Access service settings, click Close.

6 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

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.

Figure 1-7: Terms of Service.

Follow these steps: a. Click I agree to the license terms and conditions, then click Install. The Welcome screen appears.

Figure 1-8: Welcome screen.

7 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

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-9: 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-10: Nasuni Desktop Client icon.

Continue with “Configuring the Nasuni Desktop Client (Windows)” on page 11.

8 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

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-11: Nasuni Desktop Client icon.

Continue with “Configuring the Nasuni Desktop Client (Mac OS X)” on page 17.

9 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

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 On Debian or Ubuntu systems, execute this command: sudo dpkg -i 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. is the name of the installation package. Continue with “Configuring the Nasuni Desktop Client (Linux)” on page 23.

10 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

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-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 or IP Address text box, enter the DNS name or the IP address of the Nasuni Filer. IP addresses look like this: 10.1.3.145 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.

11 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

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: •

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.

ii. In the Server text box, enter the DNS name or the IP address of the proxy server. IP addresses look like this: 10.1.3.145 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 17 through step d on page 18 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.

12 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

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.

13 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

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. 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.

14 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

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.

15 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

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.

16 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

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-18: Nasuni Desktop Client icon.

2. On the Nasuni Desktop Client Add Connection Wizard, the 01 Connect to a Filer page appears.

Figure 1-19: 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: 10.1.3.145 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.

17 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

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: •

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.

ii. In the Server text box, enter the DNS name or the IP address of the proxy server. IP addresses look like this: 10.1.3.145 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 17 through step d on page 18 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-20: 02 Choose Source page.

18 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

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-21: 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.

19 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

c. The 04 Preferences page appears.

Figure 1-22: 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.

20 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

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.

21 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

f.

Click Next. The Nasuni Desktop Client Add Connection Wizard configures the Nasuni Desktop Client as specified. The Summary page appears.

Figure 1-23: 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.

22 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

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: 10.1.3.145 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 23

Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

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.

24 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

•

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 31.

25 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

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-24: 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-25: 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 19 for details.

26 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

Managing existing connections to Nasuni Filer To manage existing connections to the Nasuni Filer, as in step 5 on page 20, 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 20 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 18. 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.

27 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

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 17 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.

28 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

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 19 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 19. 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 19. 2. 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 21.

29 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

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 19 are automatically transferred to the source share on the Nasuni Filer that you selected in step 3 on page 19. Note: The specific results of actions depend on the Connection Direction chosen in step c on page 21. 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 19. 3. 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.

30 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

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 23 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 23. 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 23. 2. 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 23.

31 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com

Technical Documentation Nasuni Desktop Client Admin Guide

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 23 are automatically transferred to the source share on the Nasuni Filer that you selected in step b on page 23. Note: The specific results of actions depend on the Connection Direction chosen in step b on page 23. 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.

Technical Support [email protected]

© Copyright 2010-2016 by Nasuni Corporation. All rights reserved.

32 Nasuni Corporation | 313 Speen Street, Natick, MA 01760-1538 | 1.508.433.6200 | www.nasuni.com