Skip to Content

Wiki source code of 4.1 Command Line Tool

Last modified by publicadmin on 2025/12/16 13:04
Show last authors
1 = About the Command Line Tool =
2
3 (% class="wikigeneratedid" id="H" %)
4 The VRE Command Line Tool is a binary executable program that provides a convenient way for users to perform file actions and platform-related tasks programmatically.
5
6 (% class="wikigeneratedid" %)
7 Please contact a Platform Administrator to receive a link to download the Command Line Tool and the Command Line Tool Manual.
8
9 = (% id="cke_bm_66S" style="display:none" %) (%%)Command Groups =
10
11 {{children/}}
12
13
14 = Download the Command Line Tool =
15
16 Linux: [[Download>>https://github.com/vre-charite/command_line_tool/blob/main/app/bundled_app/linux/vrecli]]
17
18 Mac: [[Download>>https://github.com/vre-charite/command_line_tool/blob/main/app/bundled_app/mac_arm/vrecli]]
19
20 After download, user need to grand execution permission to the binary file so that command line tool could be used. User could grant permission to the binary file by using the following command in the downloaded vrecli directory.
21
22 {{code language="none"}}
23 $ chmod +x ./vrecli
24
25 {{/code}}
26
27 If user have sudo permission, user could make command line tool more accessible in any directory by moving it to the /usr/local/bin directory:
28
29 {{code language="none"}}
30 $ sudo mv vrecli /usr/local/bin
31
32 {{/code}}
33
34 Without sudo permission, user could still use command line tool in different directory by referring the command line tool path. For example, use a command line tool in the Downloads folder:
35
36 {{code language="none"}}
37 $ ~/Downloads/vrecli
38
39 {{/code}}
40
41 = Command Summary =
42
43 1. **User: **user related actions such as login and logout
44 1. **Project:** project related actions, including list Project Names and Codes for all Projects accessible by the logged-in user.
45 1. **File: **actions on files. User could use file action commands to list files/folders, upload files/folders, list/export attribute, and download files as well.
46 1. **PACS: **PACS data uploading and annotation to the VRE
47
48 {{code language="none"}}
49 $ vrecli
50 Usage: vrecli [OPTIONS] COMMAND [ARGS]...
51
52 What's new (Version 1.4.0):
53
54 1. Support file annotation when uploading folder
55
56 2. Support PACS data integration with VRE
57
58
59
60 Options:
61 --help Show this message and exit.
62
63 Commands:
64 file File Actions
65 project Project Actions
66 user User Actions
67 {{/code}}
68
69 = Command line tool deployment =
70
71 * Command line tool is deployed to Guacamole VM and Jupyterhub.
72 * The deployment is done by initialization script in Guacamole VM and Jupyterhub.
73 * There is a cronjob running on the Guacamole VM and Jupyterhub to update vrecli tool every day 3 AM.
74 * The VRECLI pre-deployed in Workbench Guacamole VM is stored within {{code language="none"}}/usr/local/bin/{{/code}}, the vrecli pre-deployed in JupyterHub is stored within {{code language="none"}}/opt/shared/{{/code}}. If you want to manually update VRECLI to the latest version, please run the following command in above respective folder where stores the VRECLI:
75
76 {{code language="none"}}
77 $ ./vrecli_update.sh
78 {{/code}}
79
80 = =
81
82 = =
83
84 ----
85
86 **See Also: **
87
88 [[File Status>>doc:Main.user_guide.Navigating the Project Canvas.File Status.WebHome]]
89
90 [[File Processing>>doc:Main.user_guide.Managing Data.File Processing - Green Room.WebHome]]
91
92 [[Analyzing Data>>doc:Main.user_guide.Analyzing Data.WebHome]]
93
94 ----
95
96 {{box}}
97 (% style="text-align:center" %)
98 image:https://i.creativecommons.org/l/by-sa/4.0/88x31.png
99
100 (% style="text-align: center;" %)
101 Copyright © 2022, Indoc Research. This work is licensed under a [[Creative Commons Attribution-ShareAlike 4.0>>http://creativecommons.org/licenses/by-sa/4.0/ ||rel="noopener noreferrer" target="blank"]] International License.
102 {{/box}}