Contents

Synology DS1019+ v2 Administrator Guide PDF

1 of 11
1 of 11

Summary of Content for Synology DS1019+ v2 Administrator Guide PDF

1

CLI Administrator Guide for Synology Presto Desktop Client

Based on Presto File Server 2.1.1

Table of Contents

Chapter 1: Introduction and Getting Started 01

Launch CLI on Presto Desktop Client

Chapter 2: Transfer Files 02

Download and Upload Files or Directories

Chapter 3: Manage User Database 04

Add or Remove Login Credentials

Chapter 4: Manage Files and Directories 05

Browse Local and Remote Files

Manage Local and Remote Files and Directories

Chapter 5: References 06

Exit Values

Additional Options

Find your information

Synology publishes a wide range of supporting documentation.

In Knowledge Base, you will find useful Help and FAQ articles, as well as video tutorials breaking up processes into handy steps.

In Synology Documentation, you can find User's Guides, Solution Guides, brochures, and White Papers. Experienced users and administrators will find answers and guidance in technical Administrator's Guides and Developer Guides.

Got a problem and unable to find the solution in our official documentation? Search hundreds of answers by users and support staff in Synology Community or reach Synology Support through the web form, email or telephone.

01

Chapter 1: Introduction and Getting Started

Presto Desktop Client supports a command-line interface (CLI), allowing users to execute high-

speed and secure data transfers through the command line and automate their data transfer

workflows. This CLI Guide provides instructions on how to transfer data and manage transfer

settings on Windows, Mac, and Linux computers via CLI on a licensed Presto File Server.

Launch CLI on Presto Desktop Client

Please do either of the following steps to launch CLI on your computer:

On Windows Computer:

1. Launch Command Prompt.

2. Change the directory to Presto's installation path, with %localappdata%\Presto\Presto. app\bin serving as the default path.

3. Execute presto-cli.exe.

On Mac or Linux Computer:

1. Launch Terminal.

2. Execute presto-cli.

Chapter 1: Introduction and Getting Started

02

Chapter 2: Transfer Files

The executable presto-cli is a command-line client supported by Presto File Server, and this

program contains the following syntax and command options.

Download and Upload Files or Directories

To download files or directories:

To download files or directories from a server to a client, please add a local destination after

the remote source:

presto-cli presto://user[:password]@host:source1 [source2...]

destination

To upload files or directories:

To upload files or directories from a client to a server, please specify the local file path and

then specify the remote server destination:

presto-cli source1 [source2...] presto://user[:password]@host:destinati

on

The syntax for uploads and downloads are as follows:

Syntax Description

user, password, host

Use the prefix presto:// to specify a remote Synology NAS credentials with Presto File Server. Both the user and host are required fields to fill in. When the field is empty, the program will immediately ask the user to enter a password. Credentials can be loaded from and saved to a database.

Chapter 2: Transfer Files

03

Chapter 1: Introduction and Getting Started

source(s)

The source files or directories to be transferred to a destination.

Multiple arguments are separated by space characters.

If the path contains one or more spaces, the path should be

enclosed in a pair of quotation marks.

The backslash (\) is not supported, the folder path separator

can only read slash (/) punctuation mark.

For example:

"presto://admin@presto.syno.me:share_folder1/

file/home/Angela/Spaced path here/"

destination

The destination directory is where the source files or directories are to be transferred.

If the path contains one or more spaces, the path should be

enclosed in a pair of quotation marks.

The backslash (\) is not supported, the folder path separator

can only read slash (/) punctuation mark.

For example:

"presto://admin@presto.syno.me:share_folder1/

file/home/Angela/Spaced path here/"

For example, to download the files share1/file1, share1/file2, share2/folder with admin as

the user and presto.syno.me as the host, please do the following:

1. Log in to presto.syno.me with an account belonging to the administrators group.

2. Download share1/file1, share1/file2, and share2/folder to the local path /home/user/ Downloads.

>presto-cli presto://admin@presto.syno.me:share1/file1 share1/file2

share2/folder /home/user/Downloads/

04

Chapter 3: Manage User Database

presto-cli shares user database with Presto. Use the option --load-db to load credentials from

the database.

For example:

>presto-cli --load-db presto://admin@presto.syno.me:share_folder1/file /

home/user/Downloads/

When loading credentials from the user database (--load-db), the changes in the transfer

settings derived from the command-line will override the transfer settings in the user

database. Therefore, the changes in the transfer settings will only be applied to the current

transfer session, while the transfer settings in the user database will remain intact.

presto-cli is not capable of browsing the transfer settings of the connected database. Adding

new settings can override the existing settings.

For example:

>presto-cli --load-db --download-max=10000 --compression presto://

admin@presto.syno.me:share_folder1/file /home/user/Downloads/

Add or Remove Login Credentials

presto-cli provides a method for adding or removing credentials to or from the database.

Please follow the formats below to add or remove login credentials to or from the user

database.

You can choose to either enter your password directly in [:password] or enter it later upon

request:

To add credentials to the user database:

presto-cli -A presto://user[:password]@host

To remove credentials from the user database:

presto-cli -E presto://user[:password]@host

Chapter 3: Manage User Database

05

Chapter 4: Manage Files and Directories

Chapter 4: Manage Files and Directories

Browse Local and Remote Files

To list the file content in a remote or local folder, please specify the folder path without target

in the format below:

presto-cli [presto://user@host:]path/

Manage Local and Remote Files and Directories

To manage local and remote files and directories with presto-cli, please follow the formats for relevant commands shown below, and make sure that the path needs to be specified down to filename and file extensions:

To move or rename a file or directory:

presto-cli -m [presto://user@host:]frompath topath

To copy a file or directory:

presto-cli -c [presto://user@host:]frompath topath

To delete a file or directory:

presto-cli -x [presto://user@host:]path

To create a new directory:

presto-cli -n [presto://user@host:]path

06

Chapter 5: References

Chapter 5: References

Exit Values

The following table displays the exit values that indicate the result of each corresponding

command:

Value Description

0 Successful.

1 Syntax or usage error.

2 Login failed.

3 Cannot establish TCP and UDP connection on the secondary port.

4 Invalid username/password or insufficient user privilege.

5 Client version is too old.

6 Server version is too old.

7 Connection failed due to the wrong port.

8 Connecting to the wrong service.

9 A one-time password is required.

10 No licensed bandwidth.

11 Untrusted SSL certificate.

20 Command failed.

21 Source directory does not exist.

22 Cannot access destination directory.

23 Only part of the transfer tasks is successful.

24 All transfer tasks failed.

30 Operation on user DB failed.

Others Unexpected errors occurred. Please try again and contact Synology Technical Support if the problem persists.

07

Chapter 4: Manage Files and Directories

Additional Options

The following table displays the additional options and their descriptions:

Option Description

-h, --help Display help article.

-v, --verbose Enable verbose mode to receive complete update notifications.

-q, --quiet Enable quiet mode to receive only error notifications or prompts.

-p, --port

Customize the used port for Presto, and require port N and N+1 to transfer files via Presto File Server.

For example, connect to presto.syno.me with port 5566:

>presto-cli -p 5566 presto://admin@presto.syno.

me:share1/

-l, --load-db Apply the existing settings to the database and to Presto GUI client.

--allow-untrust Allow untrusted SSL certificate.

--dry-run Perform a dry-run without making real changes.

--record-activities Write a record to client activity logs, which can be viewed via GUI client.

--auto-retry=COUNT

When network problems occur, presto-cli will only make a number of COUNT attempts to reconnect, but will not retry if the default value is 0.

For example, download a file from the server with a retry count of 10:

>presto-cli --auto-retry=10 presto://admin@presto.

syno.me:share1/folder /home/user/Downloads

--skip-suffix=SUFFIX

Skip transfer files with specific extensions. Use a slash to separate extensions.

For example, download all the contents in share1/folder except the files with jpg, png, and doc extensions:

>presto-cli --skip-suffix=jpg/png/doc presto://

admin@presto.syno.me:share1/folder /home/user/

Downloads

08

Chapter 4: Manage Files and Directories

Option Description

--overwrite=MODE

Define the specific conditions that trigger overwriting. The conditions include "always", "newer", "skip", and "rename". Here, "always" is the default value and "newer" is defined as when modification time (mtime) is newer or data size is different.

For example, set overwrite policy to "skip":

>presto-cli --overwrite=skip presto://admin@presto.

syno.me:share1/folder /home/user/Downloads

--concurrent Set the concurrent count for this connection. The value should be an integer ranging from 1 to 10. The default value is 3.

--upload-max

Set the maximum upload rate, with 0 indicating unlimited value. The value that is entered should be an integer ranging from 0 to 999999. The default value is 0, and the unit of this value is KB/s.

--upload-min Set the minimum upload rate. The value entered should be an integer ranging from 0 to 999999. The default value is 0, and the unit of this value is KB/s.

--download-max Set the maximum download rate, 0 indicate unlimited. The value entered should be an integer ranging from 0 to 999999. The default value is 0, and the unit of this value is KB/s.

--download-min Set the minimum download rate. The value entered should be an integer ranging from 0 to 999999. The default value is 0, and the unit of this value is KB/s.

--encryption Enable encryption when transferring data. This option is disabled by default.

--compression

Enable compression when transferring data. This option is disabled by default.

For example, add multiple transfer settings to the session:

>presto-cli --concurrent=5 --download-max=50000

--download-min=10000 --encryption --compression

presto://admin@presto.syno.me:share1/folder /home/

user/Downloads

--show-progress

Enable progress when transferring data. This option is disabled by default.

Note: This option also forces the verbose option to be enabled, and the previously entered commands and its output will be deleted.

09

Chapter 4: Manage Files and Directories

synology.com

SYNOLOGY INC.

9F, No. 1, Yuandong Rd. Banqiao Dist., New Taipei City 220545

Taiwan Tel: +886 2 2955 1814

SYNOLOGY AMERICA CORP.

3535 Factoria Blvd SE, Suite #200, Bellevue, WA 98006

USA Tel: +1 425 818 1587

SYNOLOGY FRANCE

102 Terrasse Boieldieu (TOUR W) 92800 Puteaux

France Tel: +33 147 176288

SYNOLOGY GMBH

Grafenberger Allee 295 40237 Dsseldorf

Deutschland Tel: +49 211 9666 9666

SYNOLOGY SHANGHAI

200070, Room 201, No. 511 Tianmu W. Rd., Jingan Dist., Shanghai,

China

SYNOLOGY UK LTD.

Unit 5 Danbury Court, Linford Wood, Milton Keynes, MK14 6PL

United Kingdom Tel.: +44 (0)1908048029

Synology may make changes to specifications and product descriptions at any time, without notice. Copyright 2021 Synology Inc. All rights reserved. Synology and other names of Synology Products are proprietary marks or registered trademarks of Synology Inc. Other products and company names mentioned herein are trademarks of their respective holders.

SYNOLOGY JAPAN CO., LTD.

4F, No. 3-1-2, Higashikanda

Manualsnet FAQs

If you want to find out how the DS1019+ Synology works, you can view and download the Synology DS1019+ v2 Administrator Guide on the Manualsnet website.

Yes, we have the Administrator Guide for Synology DS1019+ as well as other Synology manuals. All you need to do is to use our search bar and find the user manual that you are looking for.

The Administrator Guide should include all the details that are needed to use a Synology DS1019+. Full manuals and user guide PDFs can be downloaded from Manualsnet.com.

The best way to navigate the Synology DS1019+ v2 Administrator Guide is by checking the Table of Contents at the top of the page where available. This allows you to navigate a manual by jumping to the section you are looking for.

This Synology DS1019+ v2 Administrator Guide consists of sections like Table of Contents, to name a few. For easier navigation, use the Table of Contents in the upper left corner.

You can download Synology DS1019+ v2 Administrator Guide free of charge simply by clicking the “download” button in the upper right corner of any manuals page. This feature allows you to download any manual in a couple of seconds and is generally in PDF format. You can also save a manual for later by adding it to your saved documents in the user profile.

To be able to print Synology DS1019+ v2 Administrator Guide, simply download the document to your computer. Once downloaded, open the PDF file and print the Synology DS1019+ v2 Administrator Guide as you would any other document. This can usually be achieved by clicking on “File” and then “Print” from the menu bar.