WCLI - Detail of the WCLI commands

Syntax

The syntax to use is the following:

wcli.exe /server=DNSSRRV / password=PASSWORD NOMDELACOMMANDE

Commands

The main commands are the following:

Create : to create a server;
Remove : to remove a server;
Export : to move items (especially printing queues) from a server to an other;

Help : to access information.

Master management

CREATEMASTER Update a server as MASTER

[OPTIONS]:

/master=DNSMASTER

/domain=CUSTOMERNAME

/password=MAINTENANCEPASSWORD

CREATESLAVE : register a server in a domain

[OPTIONS]:

/master=DNSMASTER

/slave=DNSSLAVE

/password=MAINTENANCEPASSWORD

SINGLEIFY Revert a config file to a SINGLE state

[OPTIONS]:

/configpath=Config.xml path

/force to bypass the service state

SYNC synchronisation EXTERNAL/RIGHTS/NOTIFICATIONS

[OPTIONS]:

/master=DNSMASTER | Sync all servers declared on this master

/password=MAINTENANCEPASSWORD | Watchdoc master Root password

/parallel | Recommended if you have many servers

SYNCQUOTAS Synchronize the PMV database configuration + the root checkout node (pricings/pmv-rules/pmv-codes)

[OPTIONS]:

/master=DNSMASTER | Sync all slaves declared on this master

/password=MAINTENANCEPASSWORD | Watchdoc master Root password

/parallel | Recommended if you have many servers

Import SQL import

EXPORT Export to SQL all the print queues controlled (assets)

[OPTIONS]:

/server=DNSSERVER

/password=MAINTENANCEPASSWORD

/configpath=path/config.xml

/ServerWebPath=path/servers.xml

INC Export to SQL all the queues with errors (Queuesfailures)

[OPTIONS]:

/server=DNSSERVER -- FOR 1 SERVER

/password=MAINTENANCEPASSWORD

/configpath=path/config.xml

/ServerWebPath=path/servers.xml -- FOR 1 SERVER AND MORE

Watchdoc management

RESTORESHADOW Restore all the missing shadow queues

[OPTIONS]:

/server=KERNELSERVER

/password=MAINTENANCEPASSWORD

CREATEALL Create all your shared printers (with IP port)

[OPTIONS]:

/server=DNSSERVER

/password=MAINTENANCEPASSWORD

/obfuscate=true obfuscate the doc title.

/blacklist=path♀older.txt Contains all the drivers name who are blacklisted

/force=true (force) QUEUE GROUP=NETWORK QUEUE.

(default) QUEUE GROUP=SERVERNAME.

MERGE Transfert all the print queues as external to an other server

[OPTIONS]:

/slave=DNSSLAVE

/master=DNSMASTER

/domain=CUSTOMERNAME

/password=MAINTENANCEPASSWORD

LOG Change the status of the kernel logs

[OPTIONS]:

/server=KERNELSERVER

/level=TRACELEVEL

TRACELEVEL : PROFILE(ALL), DEBUG, INFO, WARNING, ERROR, FATAL (ONLY FATAL)

/password=MAINTENANCEPASSWORD

FINDPUK Extract all the PUKCODE with inside a txt file

[OPTIONS]:

/server=KERNELSERVER

/accountpath=Path/accounts.txt with account

/configpath=Path/config.xml

CHECKSERVER Check the server status

[OPTIONS]:

/password=MAINTENANCEPASSWORD

/port=KERNELSERVERPORT -- default:5744

Source data : two ways :

---------------------------------

-=> SERVERS.XML

/ServerWebPath=path/servers.xml

---------------------------------

-=> SQL Table or View

/dbserver=databaseservername

/dbdatabase=databaseName

/dbaccount=databaseAccount

/dbpassword=databaseAccountPassword

/dbtable=datebase Tablename or Viewname

Cards management

CHKUSER Delete all cards for user who doesn't exist in the directory anymore

[OPTIONS]:

/configpath=Config.xml path

/forceDelete=true Will remove all entry without any confirmation

Configuration security

CHANGEPASSWORDENCRYPTION change (and enable) the obfuscation of your server(s)

/enabled=true|false - false by default

[OPTIONS LOCAL (single server)]:

/server=dnsservername - localhost by default

/password=maintenance_password

/enabled=true|false - false by default

/algorithm=rot13|base64|baka|aes - By default : aes if enabled=true, plain otherwise

[OPTIONS MASTER/SLAVE (with slaves propagation)]:

/master=masterdns

/masterport=0 - 0 by default, will find the port automatically

/password=maintenance_password

/algorithm=rot13|base64|baka|aes - By default : aes if enabled=true, plain otherwise

/parallel=true|false - Specify the way the servers are processed (sequentially or in parallel)

RestAPI with certificates

REGENCLIENTCERT Regenerates a certificate one the server (ex: tools)

[OPTIONS]:

/server="localhost" ip or fqdn of the server that needs to regenerate its own certificate

/port="5744" port of the Crystal API

/certid="tools" name of the certificate to be deleted and regenerated

/password=MAINTENANCEPASSWORD value of the maintenance-password

/auth="auto" use this if you don't want to supply a password and that the identity running the process is operator in Watchdoc

REGENDOMCERT Regenerates the Domain certificate on the Master of the domain

[OPTIONS]:

/configpath="Path_To_Master_Config.xml" If specified, it will regenerate the certificate for an offline server. If not specified, it will contact the server with the other params

/server="localhost" ip or fqdn of the server that needs to regenerate its own certificate

/port="5744" port of the Crystal API

/password=MAINTENANCEPASSWORD value of the maintenance-password

/auth="auto" use this if you don't want to supply a password and that the identity running the process is operator in Watchdoc

PATCH Provide a quick way to "patch" the configuration

[OPTIONS]:

/xpath="server/local[@id=\"test\"]" xpath of the node to apply the action

/value="true" value to be put within the node if the action is Create / CreateOrUpdate / Update [Not needed if the action is Delete]

[OPTIONAL OPTIONS]:

/action="CreateOrUpdate" The different values are Create | CreateOrUpdate (the default one) | Update | Delete

/configpath="Config.xml" path of the configuration file (where the certificate lies). By default it's the Doxense installation path

/certid="tools" Identifier of the certificate to use to authenticate to the RestAPI

/server="localhost" the server on which we want to perform the operation

/port=5753 the port that will be use to contact the server's api

DELETEQUEUEBYIDFROMFILE Provides a quick way to delete some queue nodes from the configuration

[OPTIONS]:

/configpath="Config.xml" path of the configuration file. By default it's the Doxense installation path

/queueid="SOME_QUEUE_ID" Identifier of the queue that needs to be removed from the configuration

MAILWESPHONE send a mail to your users so they know they can acces to the WESphone and they receive the WESphone URL.

[OPTIONS]:

/wesphoneid=the id of the WESphone instance you created (mandatory)

FOR MAILS:

/csv=c:/myPath/myCsv.csv (optional)

myCsv.csv can contains one or two 'columns'. One named Account, and the other named Mail

Account column (optional) is for the user account: DOMAIN\Username. If not provided, the mail will not be personalized with user's full name.

Mail column (optional) is for the user's mail. If not provided, user's mail will be retrieved from username if possible.

/separator=coma or tab to fix the separator for the csv. (mandatory)

/mails=some@additional.mails,separated@by.what,you@specified.in,separator@para.m (optional)

Note: you can either specify mails or csv or both params. separator param is always mandatory.

/message=Replace generic message with a custom one. (optional)

/certificate=Path to the certificate users need to trust on their phone. (optional)

FOR WATCHDOC SERVER CALL:

/host=KERNELSERVER (optional) -- default:localhost

/port=KERNELSERVERPORT (optional) -- default:5744

/password=MAINTENANCEPASSWORD (optional)

REFRESHWMLS reload wml files.

[OPTIONS]:

FOR WATCHDOC SERVER CALL:

/host=KERNELSERVER (optional) -- default:localhost

/port=KERNELSERVERPORT (optional) -- default:5744

/password=MAINTENANCEPASSWORD (optional)

[REMARKS]:

Do not modify original wml files. You can override wml keys by creating a file lang_[application].override.[culture].wml