1.4.2 Precautions for using server management commands
-
If an insufficient memory error occurs during the command execution, and the command cannot be executed normally, specify the JavaVM option -Xmx<size> with the USRCONF_JVM_ARGS key in the option definition file (usrconf.bat) used for the server management command, and extend the maximum size of the memory allocation pool. '64 MB' is the default value when -Xmx<size> is not specified.
Example:
- In Windows
-
set USRCONF_JVM_ARGS=-Xmx512m
- In UNIX
-
set USRCONF_JVM_ARGS="-Xmx512m"
-
If a large file is to be operated, the java.lang.OutOfMemoryError message might be displayed in the console in which the server management commands are activated. In such cases, change the memory allocation size of JavaVM by using the -Xms and -Xmx options of the USRCONF_JVM_ARGS key used in the option definition file (usrconf.bat in Windows and usrconf in UNIX) for the server management commands.
- Coding example:
-
set USRCONF_JVM_ARGS="-Xms64m -Xmx256m"
-
The encoding specified in the XML declaration part of the property file determines the applicable property file and does not affect the encoding of the Deployment Descriptor file on the server-side (the encoding of the server-side Deployment Descriptor file is always UTF-8).
-
In Windows, make sure that you open the Command Prompt window as a user with administrator privileges. If you do not open the Command Prompt window as a user with administrator privileges, an administrator privilege error occurs and the end code 9 is returned.
-
In UNIX, if the Component Container administrator is set up, apart from the superuser even the general users can execute the command.
In Windows, make sure that you open the Command Prompt window as a user with administrator privileges. If you do not open the Command Prompt window as a user with administrator privileges, you cannot execute commands even if you are a member of the Administrators group.
-
You cannot use the supplementary characters of Unicode in the directory and file names.
If characters that cannot be converted to character encoding at runtime are output in the log file, such characters are converted to ?.
-
The execution permission setup in the Bean method is valid only in the create method, business method, and remove method. The execution permission setup using the server management command for other methods is ignored.
-
If you establish a remote connection with J2EE servers or batch servers using commands, the KDJE30045-E message might be displayed in the console and in the dialog box. In such cases, you match the versions of server management commands and J2EE servers, or the version of Cosminexus Component Container.
-
If you execute a delete node command and display list node command simultaneously for a same resource, the KDJE39057-E message might be displayed on the console where the J2EE server or batch server is running, however, there will be no impact on the operations of the J2EE server or batch server.
The delete node commands and display list node commands are as follows:
Delete node server management commands
cjdeleteapp
cjdeleteres
cjundeployrar
cjdeletelibjar
Display list node server management commands
cjlistapp
cjlistres
cjlistrar
cjlistlibjar
-
If you want to include a space in the command option of server management commands, specify the space as follows:
In Windows
Enclose the command option with a space within double quotation marks ("").
Example: When Display name acquires the resource adapter information of TP1/Message Queue - Access
cjgetresprop -type rar -resname "TP1/Message Queue - Access" -c C:\temp\rar.xml
In AIX
Enclose the command option with a space within double quotation marks ("").
Example: When Display name acquires the resource adapter information of TP1/Message Queue - Access
cjgetresprop -type rar -resname "TP1/Message Queue - Access" -c /home/rar.xml
Other UNIX
Enclose the entire command option within double quotation marks ("") and also enclose the command option containing the space within single quotation mark ('').
Example: When Display name acquires the resource adapter information of TP1/Message Queue - Access
cjgetresprop "-type rar -resname 'TP1/Message Queue - Access' -c /home/rar.xml"
However, the command might not function properly in the following cases:
-
There are two or more consecutive spaces in the option enclosed within single quotation mark.
-
There is a space immediately after the first single quotation mark or there is a space just before the last single quotation mark.
-
-
In UNIX, when a command option of the server management commands includes an exclamation mark (!), enclose the command option that includes an exclamation mark (!) within single quotation marks (').
Example: When displaying a list of Connection Pools for Connector 1.5
cjlistpool server-name -nameserver provider-URL resource-adapter-display-name!connection-definition-identifier
-
Do not specify a string beginning with an underscore "_" or a string with consecutive underscores "__" in display-name-of-queue specified in the tag (<linked-to> tag in the <resource-env-ref> tag) for the resource environment variable in the attribute file to be used with the server management commands.
-
In the application, do not include the CLASSPATH environment variable or the classes referenced from the classes included in the class path that are specified in the option definition file for server management commands.
-
When you are executing the server management commands in Windows, do not use strings containing ^ or & in the path to be setup in the PATH environment variable or CLASSPATH environment variable.
-
If vbroker.se.iiop_tp.scm.iiop_tp.listener.port is specified in the usrconf.properties (system property file for server management commands), you cannot use Server Plug-in or HCSC commands and the server management commands together.
-
When you are operating a J2EE server of another host or using multiple NICs, you must define the webserver.connector.http.permitted.hosts key beforehand, in usrconf.properties (user property file for J2EE servers). For details on the webserver.connector.http.permitted.hosts key, see 2.2.3 usrconf.properties (User property file for J2EE servers) in the uCosminexus Application Server Definition Reference Guide.