1C:RAS и 1C:RAC - Doumor/metr1c GitHub Wiki
Это служба, которая позволяет выполнять запросы к серверу 1С, используя 1C:RAC
Это утилита, которая обращается к RAS для выполнения запросов к серверу 1С.
Иными словами, мы запускаем RAC, который обращается к RAS.
./rac session list --cluster= --cluster-user= --cluster-pwd=
session : 20b18ae8-db3e-47f0-a218-c65c92549464
session-id : 1
infobase : 742d9c5d-0080-4c4a-99b7-951d31819c06
connection : 00000000-0000-0000-0000-000000000000
process : 00000000-0000-0000-0000-000000000000
user-name : Администратор
host : DESKTOP-12345
app-id : Designer
locale : ru_RU
started-at : 2024-04-06T20:41:14
last-active-at : 2024-04-06T22:15:05
hibernate : yes
passive-session-hibernate-time : 1200
hibernate-session-terminate-time : 86400
blocked-by-dbms : 0
blocked-by-ls : 0
bytes-all : 95147839
bytes-last-5min : 0
calls-all : 282429
calls-last-5min : 0
dbms-bytes-all : 14615107913
dbms-bytes-last-5min : 0
db-proc-info :
db-proc-took : 0
db-proc-took-at :
duration-all : 2607544
duration-all-dbms : 2062181
duration-current : 0
duration-current-dbms : 0
duration-last-5min : 0
duration-last-5min-dbms : 0
memory-current : 0
memory-last-5min : 0
memory-total : -256226383
read-current : 0
read-last-5min : 0
read-total : 6409169492
write-current : 0
write-last-5min : 0
write-total : 6246339791
duration-current-service : 0
duration-last-5min-service : 0
duration-all-service : 2368
current-service-name :
cpu-time-current : 0
cpu-time-last-5min : 0
cpu-time-total : 406937
data-separation : ''
client-ip : 123.123.123.123
... (Ещё одна такая запись. В тот момент я был в двух конфигураторах 1С от админа)
./rac connection list --cluster= --cluster-user= --cluster-pwd=
connection : c507d35d-c6f4-4bd0-a4fb-a34dd816b3c9
conn-id : 1168
host : server-1c
process : f9c8e5c0-9689-4209-8e47-ebc2295bcf81
infobase : 742d9c5d-0080-4c4a-99b7-951d31819c06
application : "WebServerExtension"
connected-at : 2024-04-06T22:00:03
session-number : 0
blocked-by-ls : 0
connection : 436063e3-1546-48f2-80fe-8eb00713cb6a
conn-id : 0
host : server-1c
process : f9c8e5c0-9689-4209-8e47-ebc2295bcf81
infobase : 00000000-0000-0000-0000-000000000000
application : "JobScheduler"
connected-at : 2024-04-06T21:59:17
session-number : 0
blocked-by-ls : 0
connection : 6e5fb042-ff15-47e7-bc56-da1755130115
conn-id : 0
host : DESKTOP-12345
process : f9c8e5c0-9689-4209-8e47-ebc2295bcf81
infobase : 742d9c5d-0080-4c4a-99b7-951d31819c06
application : "Designer"
connected-at : 2024-04-06T21:28:51
session-number : 0
blocked-by-ls : 0
(И далее...)
./rac process list --cluster= --cluster-user= --cluster-pwd=
process : f9c8e5c0-9689-4209-8e47-ebc2295bcf81
host : server-1c
port : 1560
pid : 11912
is-enable : yes
running : yes
started-at : 2024-04-06T20:31:03
use : used
available-perfomance : 256
capacity : 1000
connections : 5
memory-size : 3058008
memory-excess-time : 0
selection-size : 49469
avg-call-time : 0.445
avg-db-call-time : 0.050
avg-lock-call-time : 0.010
avg-server-call-time : 0.385
avg-threads : 0.361
reserve : no
./rac server list --cluster= --cluster-user= --cluster-pwd=
server : 45d09f1e-014a-49c0-900a-55197b07427d
agent-host : server-1c
agent-port : 1540
port-range : 1560:1591
name : "Main server"
using : main
dedicate-managers : none
infobases-limit : 8
memory-limit : 0
connections-limit : 256
safe-working-processes-memory-limit : 0
safe-call-memory-limit : 0
cluster-port : 1541
critical-total-memory : 4000000000
temporary-allowed-total-memory : 5000000000
temporary-allowed-total-memory-time-limit : 300
service-principal-name :
speech-to-text-model-directory :
./rac infobase summary list --cluster= --cluster-user= --cluster-pwd=
infobase : 3fe7ad17-b4d9-4f03-a2ed-8db6a17158fd
name : buh
descr :
infobase : 742d9c5d-0080-4c4a-99b7-951d31819c06
name : zup
descr :
infobase : 9bb35418-4f93-4691-a73a-3f46040fbd5b
name : doc
descr :
infobase : 3fe7ad17-b4d9-4f03-a2ed-8db6a17158fd
name : buh
dbms : PostgreSQL
db-server : 1c.server
db-name : buh
db-user : postgres
security-level : 0
license-distribution : allow
scheduled-jobs-deny : off
sessions-deny : off
denied-from :
denied-message :
denied-parameter :
denied-to :
permission-code :
external-session-manager-connection-string :
external-session-manager-required : no
security-profile-name :
safe-mode-security-profile-name :
reserve-working-processes : no
descr :
disable-local-speech-to-text : no
./rac -h
1C:Enterprise 8.3 Remote Administrative Client Utility © 1C-Soft LLC 1996-2023
1C:Enterprise platform administration utility
Use:
rac help [options] [arguments]
Shared options:
--version | -v
get the utility version
--help | -h | -?
display brief utility description
Shared arguments:
<host>[:<port>]
administration server address (default: localhost:1545)
Mode:
help (h)
Display help for the specified mode.
Arguments:
MODE
mode to get information on command line options for
Supported modes:
help Display help for the specified mode.
agent Server cluster agent administration mode
cluster Server cluster administration mode
manager Server cluster manager administration mode
server Working server administration mode
process Working process administration mode
service Cluster manager service administration mode
infobase Infobase administration mode
connection Connection administration mode
session Infobase session administration mode
lock Lock administration mode
rule Assignment rule management mode
profile Cluster security profile management mode
counter Resource consumption counters management mode
limit Resource consumption limits management mode
./rac help agent
1C:Enterprise 8.3 Remote Administrative Client Utility © 1C-Soft LLC 1996-2023
1C:Enterprise platform administration utility
Use:
rac agent [command] [options] [arguments]
Shared options:
--version | -v
get the utility version
--help | -h | -?
display brief utility description
Shared arguments:
<host>[:<port>]
administration server address (default: localhost:1545)
Mode:
agent
Server cluster agent administration mode
Parameters:
--agent-user=<name>
name of the cluster agent administrator
--agent-pwd=<pwd>
password of the cluster agent administrator
Commands:
admin
management of cluster agent administrators
Additional commands:
list
receipt of the cluster agent administrator list
register
adding a new cluster agent administrator
--name=<name>
(required) administrator name
--pwd=<name>
administrator password in case of password authentication
--descr=<descr>
description of the administrator
--auth=pwd[,os]
available authentication methods:
pwd - using the user name and password
os - authentication using OS
--os-user=<name>
OS user name
remove
deleting the cluster agent administrator
--name=<name>
(required) name of the cluster agent administrator
version
getting a cluster agent version
./rac help cluster
1C:Enterprise 8.3 Remote Administrative Client Utility © 1C-Soft LLC 1996-2023
1C:Enterprise platform administration utility
Use:
rac cluster [command] [options] [arguments]
Shared options:
--version | -v
get the utility version
--help | -h | -?
display brief utility description
Shared arguments:
<host>[:<port>]
administration server address (default: localhost:1545)
Mode:
cluster
Server cluster administration mode
Commands:
admin
management of cluster administrators
Additional commands:
list
receipt of the cluster administrator list
register
adding a new cluster administrator
--name=<name>
(required) administrator name
--pwd=<name>
administrator password in case of password authentication
--descr=<descr>
description of the administrator
--auth=pwd[,os]
available authentication methods:
pwd - using the user name and password
os - authentication using OS
--os-user=<name>
OS user name
--agent-user=<name>
name of the cluster agent administrator
--agent-pwd=<pwd>
password of the cluster agent administrator
remove
deleting the cluster administrator
--name=<name>
(required) name of the cluster administrator
--cluster=<uuid>
(required) server cluster identifier
--cluster-user=<name>
name of the cluster administrator
--cluster-pwd=<pwd>
password of the cluster administrator
info
receipt of cluster information
--cluster=<uuid>
(required) server cluster identifier
list
receipt of the cluster information list
insert
new cluster registration
--host=<host>
(required) name (or IP-address) of the computer where
the cluster registry and the main cluster manager process are located
--port=<port>
(required) main port of the main manager
--name=<name>
cluster name (presentation)
--expiration-timeout=<seconds>
forced termination time (seconds)
--lifetime-limit=<seconds>
restart time of cluster working processes (seconds)
--max-memory-size=<Kb>
maximum virtual address space (KB),
used by the working process
--max-memory-time-limit=<seconds>
maximum period of exceeding critical memory limit (seconds)
--security-level=<level>
connection security level
--session-fault-tolerance-level=<level>
fault-tolerance level
--load-balancing-mode=performance|memory
load balancing mode
performance - priority by available performance
memory - priority by available memory
--errors-count-threshold=<percentage>
server errors threshold (percentage)
--kill-problem-processes=<yes/no>
terminate corrupted processes
--kill-by-memory-with-dump=<yes/no>
create process dump when maximum memory amount is exceeded
--agent-user=<name>
name of the cluster agent administrator
--agent-pwd=<pwd>
password of the cluster agent administrator
update
cluster parameter update
--cluster=<uuid>
(required) server cluster identifier
--name=<name>
cluster name (presentation)
--expiration-timeout=<seconds>
forced termination time (seconds)
--lifetime-limit=<seconds>
restart time of cluster working processes (seconds)
--max-memory-size=<Kb>
maximum virtual address space (KB),
used by the working process
--max-memory-time-limit=<seconds>
maximum period of exceeding critical memory limit (seconds)
--security-level=<level>
connection security level
--session-fault-tolerance-level=<level>
fault-tolerance level
--load-balancing-mode=performance|memory
load balancing mode
performance - priority by available performance
memory - priority by available memory
--errors-count-threshold=<percentage>
server errors threshold (percentage)
--kill-problem-processes=<yes/no>
terminate corrupted processes
--kill-by-memory-with-dump=<yes/no>
create process dump when maximum memory amount is exceeded
--agent-user=<name>
name of the cluster agent administrator
--agent-pwd=<pwd>
password of the cluster agent administrator
remove
deleting the cluster
--cluster=<uuid>
(required) server cluster identifier
--cluster-user=<name>
name of the cluster administrator
--cluster-pwd=<pwd>
password of the cluster administrator
./rac help manager
1C:Enterprise 8.3 Remote Administrative Client Utility © 1C-Soft LLC 1996-2023
1C:Enterprise platform administration utility
Use:
rac manager [command] [options] [arguments]
Shared options:
--version | -v
get the utility version
--help | -h | -?
display brief utility description
Shared arguments:
<host>[:<port>]
administration server address (default: localhost:1545)
Mode:
manager
Server cluster manager administration mode
Parameters:
--cluster=<uuid>
(required) server cluster identifier
--cluster-user=<name>
name of the cluster administrator
--cluster-pwd=<pwd>
password of the cluster administrator
Commands:
info
receiving information on the manager
--manager=<uuid>
(required) identifier of the server cluster manager
list
receiving the manager information list
./rac help server
1C:Enterprise 8.3 Remote Administrative Client Utility © 1C-Soft LLC 1996-2023
1C:Enterprise platform administration utility
Use:
rac server [command] [options] [arguments]
Shared options:
--version | -v
get the utility version
--help | -h | -?
display brief utility description
Shared arguments:
<host>[:<port>]
administration server address (default: localhost:1545)
Mode:
server
Working server administration mode
Parameters:
--cluster=<uuid>
(required) server cluster identifier
--cluster-user=<name>
name of the cluster administrator
--cluster-pwd=<pwd>
password of the cluster administrator
Commands:
info
receiving information on the working server
--server=<uuid>
(required) identifier of the working server of the server cluster
list
receiving the working server information list
insert
working server registration
--agent-host=<host>
(required) host name or server agent IP-address
--agent-port=<port>
(required) main port of the server agent
--port-range=<min>:<max>
(required) range of IP-ports for dynamic allocation,
several ranges can be specified
--name=<name>
working server name
--using=main|normal
working server use variant
main - as a main server
normal - as an ordinary server
--infobases-limit=<count>
maximum number of infobases per working process
--memory-limit=<Kb>
memory use limit for working processes
--connections-limit=<count>
maximum number of connections per working process
--cluster-port=<port>
port number of the main manager of the cluster
--dedicate-managers=all|none
service manager allocation variant
all - allocate all services to separate managers
none - allocate all services to one manager
--safe-working-processes-memory-limit=<bytes>
Maximum memory in working processes on servers
--safe-call-memory-limit=<bytes>
safe memory consumption per call (bytes)
--critical-total-memory=<bytes>
maximum amount of working server processes memory
--temporary-allowed-total-memory=<bytes>
working server processes memory threshold
--temporary-allowed-total-memory-time-limit=<seconds>
period (in seconds) of exceeding the process memory threshold
--service-principal-name=<spn>
1C:Enterprise server SPN
--speech-to-text-model-directory=<path>
Speech recognition model directory
update
changing working server parameters
--server=<uuid>
(required) identifier of the working server of the server cluster
--port-range=<min>:<max>
range of IP-ports for dynamic allocation,
several ranges can be specified
--using=main|normal
working server use variant
main - as a main server
normal - as an ordinary server
--infobases-limit=<count>
maximum number of infobases per working process
--memory-limit=<Kb>
memory use limit for working processes
--connections-limit=<count>
maximum number of connections per working process
--dedicate-managers=all|none
service manager allocation variant
all - allocate all services to separate managers
none - allocate all services to one manager
--safe-working-processes-memory-limit=<bytes>
Maximum memory in working processes on servers
--safe-call-memory-limit=<bytes>
safe memory consumption per call (bytes)
--critical-total-memory=<bytes>
maximum amount of working server processes memory
--temporary-allowed-total-memory=<bytes>
working server processes memory threshold
--temporary-allowed-total-memory-time-limit=<seconds>
period (in seconds) of exceeding the process memory threshold
--service-principal-name=<spn>
1C:Enterprise server SPN
--speech-to-text-model-directory=<path>
Speech recognition model directory
remove
deleting the working server
--server=<uuid>
(required) identifier of the working server of the server cluster
./rac help process
1C:Enterprise 8.3 Remote Administrative Client Utility © 1C-Soft LLC 1996-2023
1C:Enterprise platform administration utility
Use:
rac process [command] [options] [arguments]
Shared options:
--version | -v
get the utility version
--help | -h | -?
display brief utility description
Shared arguments:
<host>[:<port>]
administration server address (default: localhost:1545)
Mode:
process
Working process administration mode
Parameters:
--cluster=<uuid>
(required) server cluster identifier
--cluster-user=<name>
name of the cluster administrator
--cluster-pwd=<pwd>
password of the cluster administrator
Commands:
info
receiving information on the working process
--process=<uuid>
(required) identifier of the working process of the server
--licenses
displaying information on licenses granted by the working process
list
receiving the working process information list
--server=<uuid>
identifier of the working server of the server cluster
--licenses
displaying information on licenses granted by the working process
./rac help service
1C:Enterprise 8.3 Remote Administrative Client Utility © 1C-Soft LLC 1996-2023
1C:Enterprise platform administration utility
Use:
rac service [command] [options] [arguments]
Shared options:
--version | -v
get the utility version
--help | -h | -?
display brief utility description
Shared arguments:
<host>[:<port>]
administration server address (default: localhost:1545)
Mode:
service
Cluster manager service administration mode
Parameters:
--cluster=<uuid>
(required) server cluster identifier
--cluster-user=<name>
name of the cluster administrator
--cluster-pwd=<pwd>
password of the cluster administrator
Commands:
list
receiving the service information list
./rac help infobase
1C:Enterprise 8.3 Remote Administrative Client Utility © 1C-Soft LLC 1996-2023
1C:Enterprise platform administration utility
Use:
rac infobase [command] [options] [arguments]
Shared options:
--version | -v
get the utility version
--help | -h | -?
display brief utility description
Shared arguments:
<host>[:<port>]
administration server address (default: localhost:1545)
Mode:
infobase
Infobase administration mode
Parameters:
--cluster=<uuid>
(required) server cluster identifier
--cluster-user=<name>
name of the cluster administrator
--cluster-pwd=<pwd>
password of the cluster administrator
Commands:
info
receiving the information about the infobase
--infobase=<uuid>
(required) infobase identifier
--infobase-user=<name>
name of the infobase administrator
--infobase-pwd=<pwd>
password of the infobase administrator
summary
management of brief information on infobases
Additional commands:
info
receiving brief information on the infobase
--infobase=<uuid>
(required) infobase identifier
list
receiving the list of brief information on infobases
update
updating brief information on the infobase
--infobase=<uuid>
(required) infobase identifier
--descr=<descr>
infobase description
create
infobase creation
--create-database
Create database when creating infobase
--name=<name>
(required) name of infobase
--dbms=MSSQLServer|PostgreSQL|IBMDB2|OracleDatabase
(required) type of the Database Management System where the infobase is located:
MSSQLServer - MS SQL Server
PostgreSQL - PostgreSQL
IBMDB2 - IBM DB2
OracleDatabase - Oracle Database
--db-server=<host>
(required) the name of the database server
--db-name=<name>
(required) database name
--locale=<locale>
(required) identifier of national settings of the infobase
--db-user=<name>
database administrator name
--db-pwd=<pwd>
database administrator password
--descr=<descr>
infobase description
--date-offset=<offset>
date offset in the infobase
--security-level=<level>
infobase connection security level
--scheduled-jobs-deny=on|off
scheduled job lock management
on - scheduled job execution prohibited
off - scheduled job execution permitted
--license-distribution=deny|allow
management of licenses granting by 1C:Enterprise server
deny - licensing is forbidden
allow - licensing is allowed
update
updating information on infobase
--infobase=<uuid>
(required) infobase identifier
--infobase-user=<name>
name of the infobase administrator
--infobase-pwd=<pwd>
password of the infobase administrator
--dbms=MSSQLServer|PostgreSQL|IBMDB2|OracleDatabase
type of the Database Management System where the infobase is located:
MSSQLServer - MS SQL Server
PostgreSQL - PostgreSQL
IBMDB2 - IBM DB2
OracleDatabase - Oracle Database
--db-server=<host>
the name of the database server
--db-name=<name>
database name
--db-user=<name>
database administrator name
--db-pwd=<pwd>
database administrator password
--descr=<descr>
infobase description
--denied-from=<date>
start of the time interval within which the session lock mode is enabled
--denied-message=<msg>
message displayed upon session lock violation
--denied-parameter=<string>
session lock parameter
--denied-to=<date>
end of the time interval within which the session lock mode is enabled
--permission-code=<string>
access code that allows the session to start in spite of enabled session lock
--sessions-deny=on|off
session lock mode management
on - mode of session start lock enabled
off - mode of session start lock disabled
--scheduled-jobs-deny=on|off
scheduled job lock management
on - scheduled job execution prohibited
off - scheduled job execution permitted
--license-distribution=deny|allow
management of licenses granting by 1C:Enterprise server
deny - licensing is forbidden
allow - licensing is allowed
--external-session-manager-connection-string=<connect-string>
external session management parameter
--external-session-manager-required=yes|no
external session management required
yes - external session management is a must
no - external session management is optional
--reserve-working-processes=yes|no
Workflow backup
yes - Workflow backup is enabled
no - Workflow backup is disabled
--security-profile-name=<name>
infobase security profile
--safe-mode-security-profile-name=<name>
external code security profile
--disable-local-speech-to-text=yes|no
deny local speech recognition
yes - local speech recognition denied
no - local speech recognition allowed
drop
remote infobase mode
--infobase=<uuid>
(required) infobase identifier
--infobase-user=<name>
name of the infobase administrator
--infobase-pwd=<pwd>
password of the infobase administrator
--drop-database
delete database upon deleting infobase
--clear-database
clear database upon deleting infobase
./rac help connection
1C:Enterprise 8.3 Remote Administrative Client Utility © 1C-Soft LLC 1996-2023
1C:Enterprise platform administration utility
Use:
rac connection [command] [options] [arguments]
Shared options:
--version | -v
get the utility version
--help | -h | -?
display brief utility description
Shared arguments:
<host>[:<port>]
administration server address (default: localhost:1545)
Mode:
connection
Connection administration mode
Parameters:
--cluster=<uuid>
(required) server cluster identifier
--cluster-user=<name>
name of the cluster administrator
--cluster-pwd=<pwd>
password of the cluster administrator
Commands:
info
receiving information on the connection
--connection=<uuid>
(required) connection identifier
list
receiving the connection list
--process=<uuid>
identifier of the working process of the server
--infobase=<uuid>
infobase identifier
--infobase-user=<name>
name of the infobase administrator
--infobase-pwd=<pwd>
password of the infobase administrator
disconnect
disconnection
--process=<uuid>
(required) identifier of the working process of the server
--connection=<uuid>
(required) connection identifier
--infobase-user=<name>
name of the infobase administrator
--infobase-pwd=<pwd>
password of the infobase administrator
./rac help session
1C:Enterprise 8.3 Remote Administrative Client Utility © 1C-Soft LLC 1996-2023
1C:Enterprise platform administration utility
Use:
rac session [command] [options] [arguments]
Shared options:
--version | -v
get the utility version
--help | -h | -?
display brief utility description
Shared arguments:
<host>[:<port>]
administration server address (default: localhost:1545)
Mode:
session
Infobase session administration mode
Parameters:
--cluster=<uuid>
(required) server cluster identifier
--cluster-user=<name>
name of the cluster administrator
--cluster-pwd=<pwd>
password of the cluster administrator
Commands:
info
receiving information on the session
--session=<uuid>
(required) infobase session identifier
--licenses
displaying information on licenses granted to the session
list
receiving the session information list
--infobase=<uuid>
infobase identifier
--licenses
displaying information on licenses granted to the session
terminate
Forced termination of the session
--session=<uuid>
(required) infobase session identifier
--error-message=<string>
Session termination reason message
interrupt-current-server-call
current server call termination
--session=<uuid>
(required) infobase session identifier
--error-message=<string>
termination cause message
./rac help lock
1C:Enterprise 8.3 Remote Administrative Client Utility © 1C-Soft LLC 1996-2023
1C:Enterprise platform administration utility
Use:
rac lock [command] [options] [arguments]
Shared options:
--version | -v
get the utility version
--help | -h | -?
display brief utility description
Shared arguments:
<host>[:<port>]
administration server address (default: localhost:1545)
Mode:
lock
Lock administration mode
Parameters:
--cluster=<uuid>
(required) server cluster identifier
--cluster-user=<name>
name of the cluster administrator
--cluster-pwd=<pwd>
password of the cluster administrator
Commands:
list
receiving the lock information list
--infobase=<uuid>
infobase identifier
--connection=<uuid>
connection identifier
--session=<uuid>
infobase session identifier
./rac help rule
1C:Enterprise 8.3 Remote Administrative Client Utility © 1C-Soft LLC 1996-2023
1C:Enterprise platform administration utility
Use:
rac rule [command] [options] [arguments]
Shared options:
--version | -v
get the utility version
--help | -h | -?
display brief utility description
Shared arguments:
<host>[:<port>]
administration server address (default: localhost:1545)
Mode:
rule
Assignment rule management mode
Parameters:
--cluster=<uuid>
(required) server cluster identifier
--cluster-user=<name>
name of the cluster administrator
--cluster-pwd=<pwd>
password of the cluster administrator
Commands:
apply
use of requirements
--full
full requirement use mode (default)
--partial
partial requirement use mode
info
receiving information on the assignment rule
--server=<uuid>
(required) identifier of the working server of the server cluster
--rule=<uuid>
(required) assignment rule identifier
list
receiving the list of assignment rules
--server=<uuid>
(required) identifier of the working server of the server cluster
insert
inserting a new assignment rule into the list
--server=<uuid>
(required) identifier of the working server of the server cluster
--position=<num>
(required) requirement position in the list (beginning with 0)
--object-type=<id>
requirement object identifier
--infobase-name=<name>
infobase name,
if the parameter is not specified, the requirement is applied to all
infobases
--rule-type=auto|always|never
allocation rule type:
auto - no rules (by default)
always - allocate to this server only
never - do not allocate to this server
--application-ext=<name>
application with an adjustment
--priority=<priority>
assignment rule priority
update
updating parameters of an assignment rule in the list
--server=<uuid>
(required) identifier of the working server of the server cluster
--rule=<uuid>
(required) assignment rule identifier
--position=<num>
(required) requirement position in the list (beginning with 0)
--object-type=<id>
requirement object identifier
--infobase-name=<name>
infobase name,
if the parameter is not specified, the requirement is applied to all
infobases
--rule-type=auto|always|never
allocation rule type:
auto - no rules (by default)
always - allocate to this server only
never - do not allocate to this server
--application-ext=<name>
application with an adjustment
--priority=<priority>
assignment rule priority
remove
deleting an assignment rule
--server=<uuid>
(required) identifier of the working server of the server cluster
--rule=<uuid>
(required) assignment rule identifier
./rac help profile
1C:Enterprise 8.3 Remote Administrative Client Utility © 1C-Soft LLC 1996-2023
1C:Enterprise platform administration utility
Use:
rac profile [command] [options] [arguments]
Shared options:
--version | -v
get the utility version
--help | -h | -?
display brief utility description
Shared arguments:
<host>[:<port>]
administration server address (default: localhost:1545)
Mode:
profile
Cluster security profile management mode
Parameters:
--cluster=<uuid>
(required) server cluster identifier
--cluster-user=<name>
name of the cluster administrator
--cluster-pwd=<pwd>
password of the cluster administrator
Commands:
list
gets the list of security profiles
update
creates or updates a security profile
--name=<name>
(required) security profile name
--descr=<descr>
security profile description
--config=yes|no
using the security profile from the configuration is allowed
yes - yes
no - no
--priv=yes|no
setting privileged mode in the safe mode is allowed
yes - yes
no - no
--full-privileged-mode=yes|no
setting privileged mode in the safe mode is allowed
yes - yes
no - no
--privileged-mode-roles=<name[;name...]>
privileged mode roles
--crypto=yes|no
using cryptography functions is allowed
yes - yes
no - no
--right-extension=yes|no
all access rights extensions allowed
yes - yes
no - no
--right-extension-definition-roles=<name[;name...]>
roles that restrict access rights
--all-modules-extension=yes|no
allow extension of all modules
yes - yes
no - no
--modules-available-for-extension=<name[;name...]>
modules available for extension
--modules-not-available-for-extension=<name[;name...]>
modules not available for extension
remove
deletes a security profile
--name=<name>
(required) security profile name
acl
manage access lists
Additional commands:
directory
Virtual directory management mode
Additional commands:
list
gets the list of available virtual directories
update
adds or updates an available virtual directory
--alias=<URL>
(required) logical URL of a virtual directory
--descr=<string>
virtual directory description
--physicalPath=<URL>
physical URL of a virtual directory
--allowedRead=yes|no
reading from the virtual directory is allowed
yes - yes
no - no
--allowedWrite=yes|no
writing to the virtual directory is allowed
yes - yes
no - no
remove
removes the virtual directory of a security profile
--alias=<URL>
(required) logical URL of a virtual directory
--access=list|full
full access to the file system or access list management
list - access list is used
full - full access is granted, the access list is ignored
com
Available COM class management mode
Additional commands:
list
gets the list of available COM classes
update
adds or updates an available COM class
--name=<name>
(required) COM class name
--descr=<string>
COM class description
--fileName=<URL>
file name or COM class moniker display name
--id=<uuid>
COM class ID
--host=<URL>
name of the computer where the COM object is created
remove
removes an available COM class
--name=<name>
(required) COM class name
--access=list|full
full access to COM classes or access list management
list - access list is used
full - full access is granted, the access list is ignored
addin
Available add-in management mode
Additional commands:
list
gets the list of available add-ins
update
adds or updates an available add-in
--name=<name>
(required) available add-in name
--descr=<string>
available add-in description
--hash=<string>
available add-in checksum, base64
remove
removes an available add-in
--name=<name>
(required) available add-in name
--access=list|full
full access to add-ins or access list management
list - access list is used
full - full access is granted, the access list is ignored
module
Available external module management mode
Additional commands:
list
gets the list of available external modules
update
adds or updates an external module
--name=<name>
(required) external module name
--descr=<string>
external module description
--hash=<string>
external module checksum, base64
remove
removes an available external module
--name=<name>
(required) external module name
--access=list|full
full access to external modules or access list management
list - access list is used
full - full access is granted, the access list is ignored
app
Available application management mode
Additional commands:
list
gets the list of available applications
update
adds or updates an available application
--name=<name>
(required) application name
--descr=<string>
application description
--wild=<URL>
application command line syntax
remove
removes an available application
--name=<name>
(required) application name
--access=list|full
full access to applications or access list management
list - access list is used
full - full access is granted, the access list is ignored
inet
Available Internet resource management mode
Additional commands:
list
gets the list of available Internet resources
update
adds or updates an Internet resource
--name=<name>
(required) Internet resource name
--descr=<string>
Internet resource description
--protocol=<name>
Internet resource protocol
--url=<URL>
Internet resource address
--port=<number>
Internet resource port, 0 stands for the default port
remove
removes an available Internet resource
--name=<name>
(required) Internet resource name
--access=list|full
full access to Internet resources or access list management
list - access list is used
full - full access is granted, the access list is ignored
--name=<name>
(required) security profile name
./rac help counter
1C:Enterprise 8.3 Remote Administrative Client Utility © 1C-Soft LLC 1996-2023
1C:Enterprise platform administration utility
Use:
rac counter [command] [options] [arguments]
Shared options:
--version | -v
get the utility version
--help | -h | -?
display brief utility description
Shared arguments:
<host>[:<port>]
administration server address (default: localhost:1545)
Mode:
counter
Resource consumption counters management mode
Parameters:
--cluster=<uuid>
(required) server cluster identifier
--cluster-user=<name>
name of the cluster administrator
--cluster-pwd=<pwd>
password of the cluster administrator
Commands:
list
retrieve the counters list
info
retrieve the counter data
--counter=<name>
(required) resource consumption counter ID
update
create or update counter
--name=<name>
(required) resource consumption counter name
--collection-time=<number|current-call>
(required) counter registering period
--group=<users|data-separation>
(required) grouping type
--filter-type=<all-selected|all-but-selected|all>
(required) filter type
--filter=<string>
(required) filter value
--duration=<analyze|not-analyze>
register server calls duration
--cpu-time=<analyze|not-analyze>
register CPU usage time
--memory=<analyze|not-analyze>
register memory consumption
--read=<analyze|not-analyze>
register the amount of data read from disk
--write=<analyze|not-analyze>
register the amount of data written on disk
--duration-dbms=<analyze|not-analyze>
register the DBMS calls duration
--dbms-bytes=<analyze|not-analyze>
register the amount of data received from the DBMS
--service=<analyze|not-analyze>
register the services calls duration
--call=<analyze|not-analyze>
register server calls number
--number-of-active-sessions=<analyze|not-analyze>
register active sessions number
--number-of-sessions=<analyze|not-analyze>
register sessions number
--descr=<descr>
resource consumption counter description
values
display the resource consumption counter readings
--counter=<counter>
(required) resource consumption counter name
--object=<format-string>
filters in "filter_type=value;" format. The following filter types are available: infobase, data-separation, user, appID, safe-mode, and safe-mode-profile-name. You can specify multiple filters separated by |. Example: infobase=ib1;user=user1|user=user2.
remove
delete the resource consumption counter
--name=<name>
(required) resource consumption counter name
clear
clear counter values
--counter=<counter>
(required) resource consumption counter name
--object=<format-string>
filters in "filter_type=value;" format. The following filter types are available: infobase, data-separation, user. To set multiple filters, separate them by vertical bars. For example, infobase=ib1;user=user1|user=user2.
accumulated-values
get list of accumulated counter values
--counter=<counter>
(required) resource consumption counter name
--object=<format-string>
filters in "filter_type=value;" format. The following filter types are available: infobase, data-separation, user. To set multiple filters, separate them by vertical bars. For example, infobase=ib1;user=user1|user=user2.
./rac help limit
1C:Enterprise 8.3 Remote Administrative Client Utility © 1C-Soft LLC 1996-2023
1C:Enterprise platform administration utility
Use:
rac limit [command] [options] [arguments]
Shared options:
--version | -v
get the utility version
--help | -h | -?
display brief utility description
Shared arguments:
<host>[:<port>]
administration server address (default: localhost:1545)
Mode:
limit
Resource consumption limits management mode
Parameters:
--cluster=<uuid>
(required) server cluster identifier
--cluster-user=<name>
name of the cluster administrator
--cluster-pwd=<pwd>
password of the cluster administrator
Commands:
list
retrieve the limits list
info
retrieve the limit information
--limit=<name>
(required) resource consumption limit ID
update
create or update a limit
--name=<name>
(required) resource consumption limit name
--action=<none|set-low-priority-thread|interrupt-current-call|interrupt-session>
(required) resource consumption limit name
--counter=<counter>
a counter referred to the limit
--duration=<number>
server calls duration limit
--cpu-time=<number>
CPU usage time limit
--memory=<number>
memory usage limit
--read=<number>
limit of the amount of data read from disk
--write=<number>
limit of the amount of data written on disk
--duration-dbms=<number>
DBMS calls duration limit
--dbms-bytes=<number>
limit the amount of data received from the DBMS
--service=<number>
service calls duration limit
--call=<number>
server calls number limit
--number-of-active-sessions=<number>
active sessions number limit
--number-of-sessions=<number>
sessions number limit
--error-message=<string>
exceeding the limit message
--descr=<descr>
resource consumption limit description
remove
delete the resource consumption limit
--name=<name>
(required) resource consumption limit name