- 05 Jul 2023
- 3 Minutes to read
Managing the CTERA Agent From the Command Line
- Updated on 05 Jul 2023
- 3 Minutes to read
You manage the CTERA Agent either from the user interface, or directly from the command line, from the folder where the CTERA Agent was installed. The default folder is C:\Program Files (x86)\CTERA\CTERA Agent.
To display the CLI syntax, in the folder where the CTERA Agent was installed, use: cteractl --help.
The command line interface has the following syntax:
cteractl [--version] [--help] command
Where command can be:
signin [-u string ] [-p string ] [-c ActivationCode ] [--allow-untrusted] [-r ReplacementDeviceID ] [-replacelist]
ServerAddress [--run-as=windowsUserAccount ]
signout [--run-as=windowsUserAccount ]
backup-add -f PATH [-f PATH]... [--background] [--run-as=windowsUserAccount ]
backup-remove -f PATH [-f PATH]... [--background] [--run-as=windowsUserAccount ]
backup-start [--background] [--run-as=windowsUserAccount ]
backup-suspend [--background] [--run-as=windowsUserAccount ]
backup-unsuspend [--background] [--run-as=windowsUserAccount ]
dbg [level ] [level ] ...
gui-access --all | --localhost
status [--run-as=windowsUserAccount ]
settings re-auth [--signout=n seconds or never ] [--network-loss=n seconds or never ] [--timer=n seconds or never ] [--run-as=windowsUserAccount ]
sync-add -f PATH [--rename=string ] [--merge] [--caching] [--run-as=windowsUserAccount ]
sync-remove -f PATH
sync-start [--name=string ] [--merge] [--override] [--pinned] [--local-folder=path ] [--run-as=windowsUserAccount ]
pin [-f PATH] [--run-as=Windows user account]
unpin [-f PATH] [--run-as=Windows user account]
sync-stop [--name=string ] [--run-as=windowsUserAccount ]
cteractl signin -u User1 -p 12345678Aa portal.ctera.com cteractl signin -run-as paul -user User1 -p 12345678Aa! portal.ctera.me -allow-untrusted cteractl sync-start --name “ReleaseNotes” --override cteractl sync-suspendcteractl sync-unsuspend cteractl dbg debug backup
Description of <command>
The following keyword is available for all the cteractl commands: run-as= windowsUserAccountName and means that when an agent is installed per user, an administrator can run cteractl commands as another user.
Sign in to the server specified in Server Address.
The username for signing in.
The password for the username.
An activation code instead of the username and password.
Ignore untrusted certificates when logging in to the server.
Use this device ID to replace the existing device.
A list of replacement device IDs to use.
The server address to sign in to – either a portal or gateway.
Sign out of the server.
Add or remove files and folders to be backed up.
The full path of the file or folder to be added or removed.
Run the command in background.
Start or stop a backup.
Suspend or unsuspend a running backup.
Run the command in background.
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 0x00000002 sets the current level to warning.
dbg 0x00000042 sets the level to warning for storage.
You can also use the name instead of the hexadecimal value. For example:
dbg warning sets the current level to warning.
dbg warning storage sets the level to warning for storage.
aapi = 0x00000020
alert = 0x00020000
apps = 0x04000000
auth = 0x00200000
av = 0x00080000
backup = 0x00000800
caching = 0x20000000
cbck = 0x00040000
cloud_extender = 0x02000000
collaboration = 0x00800000
cttp = 0x00004000
cttp_data = 0x00008000
db = 0x00001000
debug = 0x00000004
dns = 0x00000200
error = 0x00000001
error_abort = 0x01000000
evictor = 0x08000000
evictor_verbose = 0x10000000
files = 0x00002000
http = 0x00000100
index = 0x00100000
info = 0x00000003
license = 0x00400000
none = 0x00000000
ntp = 0x00000400
process = 0x00000008
rsync = 0x00010000
samba = 0x00000010
storage = 0x00000040
upload = 0x00000080
warning = 0x00000002
Add or remove local folders to be synced to the portal cloud drive.
The full path of folder to add to or remove from being synced.
Rename a folder in the portal cloud drive. The default is the last folder in the path.
Merge the folder with a folder in the portal cloud drive.
Start or stop syncing a portal cloud drive folder.
The name of the folder to start or stop syncing.
Merge the portal cloud drive folder with a local folder.
Override the content of the local folder with the content from the portal cloud drive.
Choose a different location.
Suspend or unsuspend syncing to the cloud.
Set the GUI access.
All users have access to the GUI.
Only localhost users have access to the GUI.
Get the agent status. The following information is returned:
Settings that determine when re-authentication is required.
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.
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.