Managing the CTERA Agent From the Command Line
You manage the CTERA Agent either from the user interface, or directly from the command line, from the directory where the CTERA Agent was installed.
To display the CLI syntax, in the directory where the CTERA Agent was installed, use: cteractl --help.
The command line interface has the following syntax:
Usage: cteractl [--version] [--help] command
Where command can be:
signin [-u string] [-p string] [-c ActivationCode] [--allow-untrusted] [-r ReplacementDeviceID] [-replacelist] ServerAddress
signin [-u string] [-p string] [-c ActivationCode] [--allow-untrusted] [-r ReplacementDeviceID] [-replacelist] ServerAddress
signout
backup-add -f PATH [-f PATH]... [--background]
backup-remove -f PATH [-f PATH]... [--background]
backup-start [--background]
backup-stop [--background]
backup-suspend [--background]
backup-unsuspend [--background]
sync-add -f PATH [--rename=string] [--merge]
sync-remove -f PATH
sync-start [--name=string] [--merge] [--override] [--local-folder=path]
sync-stop [--name=string]
sync-suspend
sync-unsuspend
gui-access --all | --localhost
status
settings re-auth [--signout=n seconds or never] [--network-loss=n seconds or never] [--timer=n seconds or never]
dbg [level]
Examples
cteractl signin -u User1 -p 12345678Aa portal.ctera.com
cteractl.exe signin -run-as paul -user User1 -p 12345678Aa! portal.ctera.me -allow-untrusted
cteractl sync-start --name “ReleaseNotes” --override
cteractl sync-add -f "%USERPROFILE%/Downloads/" --merge
Description of <command>
|
Keyword
|
Meaning
|
|---|---|
|
signin
|
Sign in to the server specified in Server Address.
|
|
u
|
The username for signing in.
|
|
p
|
The password for the username.
|
|
c <Activation code
|
An activation code to use instead of the username and password.
|
|
allow-untrusted
|
Ignore untrusted certificates when logging in to the server.
|
|
ReplacementDeviceID
|
Use this device ID to replace the existing device.
|
|
replacelist
|
A list of replacement device IDs to use.
|
|
Server Address
|
The server address to sign in to.
|
|
signout
|
Sign out of the server.
|
|
backup-add/backup-remove
|
Add or remove files and folders to be backed up.
|
|
PATH
|
The full path of the file or folder to add to or remove from the backup.
|
|
background
|
Run the command in background.
|
|
backup-start/backup-stop
backup-suspend/backup-unsuspend
|
Start or stop a backup.
Suspend or unsuspend a running backup.
|
|
background
|
Run the command in background.
|
|
dbg
|
Set the log level or, when no additional arguments are specified, get the current level. Level is hexadecimal, and you can combine different values for Level. For example:
dbg 0x00000000 returns the current level.
dbg 0x00000042 sets the level to warning for storage.
|
|
Level
|
none = 0x00000000
error = 0x00000001
warning = 0x00000002
info = 0x00000003
debug = 0x00000004
process = 0x00000008
samba = 0x00000010
aapi = 0x00000020
storage = 0x00000040
upload = 0x00000080
http = 0x00000100
dns = 0x00000200
ntp = 0x00000400
backup = 0x00000800
db = 0x00001000
files = 0x00002000
cttp = 0x00004000
cttp_data = 0x00008000
rsync = 0x00010000
alert = 0x00020000
cbck = 0x00040000
av = 0x00080000
index = 0x00100000
auth = 0x00200000
|
|
|
license = 0x00400000
collaboration = 0x00800000
error_abort = 0x01000000
cloud_extender = 0x02000000
apps = 0x04000000
evictor = 0x08000000
evictor_verbose = 0x10000000
caching = 0x20000000
|
|
sync-add/sync-remove
|
Add or remove local folders to be synced to the portal cloud drive.
|
|
PATH
|
The full path of folder to add to or remove from being synced.
|
|
rename
|
Rename a folder in the portal cloud drive. The default is the last folder in the path.
|
|
merge
|
Merge the folder with a folder in the portal cloud drive.
|
|
sync-start/sync-stop
|
Start or stop syncing a portal cloud drive folder.
|
|
name
|
The name of the folder to start or stop syncing.
|
|
merge
|
Merge the portal cloud drive folder with a local folder.
|
|
override
|
Override the content of the local folder with the content from the portal cloud drive.
|
|
local-folder
|
Choose a different location.
|
|
sync-suspend/sync-unsuspend
|
Suspend or unsuspend syncing to the cloud.
|
|
gui-access
|
Set the GUI access.
|
|
all
|
All users have access to the GUI.
|
|
localhost
|
Only localhost users have access to the GUI.
|
|
status
|
Get the agent status. The following information is returned:
 What the agent is connected to, including the IP address.The username.The status of the last backup.The status of the license. |
|
settings re-auth
|
Settings that determine when re-authentication is required.
|
|
network-loss
|
Set the number of seconds after a disconnection that can elapse before authentication is required, even if the user is still signed in to the portal, when the connection returns, or never to never require re-authentication.
|
|
timer
|
Set the number of seconds during a session with the portal after which re-authentication is required, even if the user is still signed in to the portal, or never to never require re-authentication during a session.
|