cjenvupdate (convert work directory and user definition files)
- Organization of this page
Format
cjenvupdate [-f]
Function
When the J2EE server is using an earlier version of Cosminexus Component Container, this command converts the earlier format of work directory and the following user-defined files to the format used in the current version:
-
usrconf.properties (user properties file for the J2EE server)
-
usrconf.cfg (option definition file for the J2EE server)
-
server.policy (security policy file for the J2EE server)
-
usrconf.properties (system properties file for server administrator commands)
-
usrconf.bat#1 (operation definition file for server administrator commands)
-
usrconf.properties (user properties file for the Web container server)#2
-
usrconf.cfg (option definition file for the Web container server)#2
-
web.policy (SecurityManager definition file)
- #1
-
In UNIX, this is usrconf.
- #2
-
A file used with compatible functionality.
This command must be executed immediately after completion of an upgrade installation from an older version. When the work directory is to be converted, the drive containing the work directory must have about twice as much unused space as the disk size actually used by the work directory.
work-directory is the directory that was specified for the ejb.public.directory key of usrconf.cfg (option definition file for the J2EE server).
When this command is executed, backup files of the definition files to be converted are created in the same directory as the definition files. Each backup file that is created is given the name name-of-converted-definition-file.envupdate_bak. If a file with that name already exists when the backup file is to be created, the backup file name is set to name-of-converted-definition-file.envupdate_bak_? (? is a sequential number from 1 to 2147483647). Backup files are not deleted automatically when this command is completed.
For the Application Server migration, see 10. Migrating from Application Server of Earlier Versions (In the J2EE Server Mode) in the uCosminexus Application Server Maintenance and Migration Guide.
Arguments
- -f
-
Forcibly converts, even if there are some DD files that cannot be converted.
Post-conversion operations
When the work directory is converted by this command, after the conversion is completed, a backup work directory is created#1 immediately under the work directory of each J2EE server. The work directory stores the post-conversion information (files), and the backup work directory stores the pre-conversion information (files). If the name of the work directory is ...\directory-name or .../directory-name, the name of the backup work directory becomes ...\directory-name\directory-name_old\ or .../directory-name/directory-name_old/.#2 After conversion, you should perform a startup check of the J2EE server, an operation check of the J2EE applications, and a termination check of the J2EE server. After the checks have been completed, you can delete the backup work directory if the pre-conversion work directory information files are no longer required. However, it is recommended that you save the backup work directory to another location.
- #1
-
If the work directory is not converted, the backup work directory is not created.
- #2
-
If a backup work directory already exists, ...\directory-name\directory-name_old\ or .../directory-name/directory-name_old/ is renamed to ...\directory-name\directory-name_old?\ or .../directory-name/directory-name_old?/ (? is a sequential number from 1 to 2147483647).
Action when an error occurs
If execution of the work directory conversion command fails, you can identify the file path on which the failure occurred from the messages output by the command. An example of the output messages is shown below:
KDJE30220-I Migration of the definition files of the old version is in progress. KDJE30221-I The definition files of the old version have been migrated successfully. KDJE30204-I The server checking is in progress. Server name = [server-name] KDJE30202-E The Deployment Descriptor cannot be converted. File = [file-path], Reason = [detailed-information] KDJE30205-E The server will not be migrated because a problem occurred in the Deployment Descriptor. Server name = [server-name]
Exception information is output as detailed-information. Refer to this detailed-information, eliminate the problem, check that the disk has sufficient unused space, and then re-execute the command.
If you cannot identify the cause from detailed-information or if an error occurs even when you re-execute the command after checking and revising the condition, contact a maintenance engineer.
Return values
- 0:
-
The command terminated normally.
- 1:
-
The command terminated abnormally.
Notes
-
To execute the cjenvupdate command in UNIX, you must have root permission (if Component Container Administrator is not set) or the Component Container Administrator permission (if Component Container Administrator is set).
-
If the extension DD file (hitachi-ra.xml) for the resource adapter of J2EE resources and the J2EE resource adapter is scrambled, the unscrambled Java EE-compliant DD file (ra.xml) will be scrambled.
-
This command might fail if files under the following directories are accessed while the command is running. Note that these files might be unintentionally accessed by a virus scan engine.
- Windows:
-
- Application-Server-installation-directory\CC
- work-directory
- UNIX:
-
- /opt/Cosminexus/CC
- work-directory