2.2.7 Notes on setting up the system environment

Note the following items when setting up the system environment:

• Only the following users are authorized to execute the Setup Wizard. If unauthorized users execute the Setup Wizard, an error occurs.

  • For Windows

    Execute the commands as a user with administrator privileges.

  • For UNIX

    Execute the commands as a user with root permission.

• Do not externally terminate the running command by using the Ctrl+C key.

• If an error occurs during the setup processing, the processing is stopped and the setup failure window appears. In such cases, delete the system being setup, and then execute the setup again. To delete the system being setup, execute uninstall by using the Setup Wizard. For details on the uninstallation procedure, see 3.3.1 Unsetup of the system environment.

• In the operations of the Setup Wizard, if you do not enter any value and press the Enter key even when you are prompted to enter setting value, the default value is set for that item. If you press the Enter key for the items having no default value, an error occurs and you are again prompted for entering a setting value.

• When you are prompted to enter a setting value, if you enter a value that cannot be set and press the Enter key, error occurs, and the following window appears.

  Figure 2‒1: Window displayed on entering a value that cannot be set

• When you are prompted to enter a setting value for the item having value that can be set as "0 characters or more", and you press the Enter key without entering any value, null is set.

  If you enter a value for the items for which some value is already set, the following window appears.

  Figure 2‒2: Window displayed on re-entering a value for items having the value that can be set as "0 characters or more"

  When this window appears, if you do not enter any value, and press the Enter key, null is set in place of the already set value.

• You can use the Setup Wizard to set up a system environment only on hosts where the Setup Wizard is executed. You cannot set up a system environment on other hosts.

• If you execute the Setup Wizard using the standard setup, the system environment with the port numbers described in the following table is set up.

  Table 2‒4: Port numbers used in standard setup

  Port number	Purpose
  80	Port number of Web server
  900	Port number of in-process Naming Service
  8008	Port number of http
  28008	Port number of management server
  20295	Port number of Administration Agent
  23152	Port number of RMI registry
  28005	Port number for Management Server completion request reception
  28009	Port number for Management Server internal communication
  28080	HTTP port number for Management Server connection

  If these port numbers are already in use, you cannot set up the system environment using the standard setup. In the Select Setup Method window, enter "2" (Custom setup), and set a unique port number in the following window:

  • Management Functionality Settings window

  • System Environment Settings window

  To match the settings with standard setup except for the port numbers, enter "1" (default) in the Operation Management User Settings window, the J2EE Server Startup User Settings window (For UNIX), and the Select System Configuration window, and. then execute the set up.

• If the setup fails, enter "y" in the Setup failure window to automatically collect a snapshot log as the troubleshooting data.

  The storage location of the snapshot log and the contents collected are as follows.

  Storage location of snapshot log

  • <Setup Wizard log output destination>/snapshot.zip

  Contents collected in snapshot log

  • Directory indicated in <Cosminexus installation directory>/manager/config/snapshotlog.conf

  • <Setup Wizard log output destination>/setupwizard<number of files>.log

  • <Setup Wizard log output destination>/maintenance/setupwizard<Number of files>.log

  • <Cosminexus installation directory>/manager/setup/config/

  • <Cosminexus installation directory>/manager/setup/tmp/

  <Setup Wizard log output destination> is the output destination specified in setup.log.dir of setup.cfg. For setup.cfg, refer to 8.2.18 setup.cfg (Setup file for the Setup Wizard) of the uCosminexus Application Server Definition Reference Guide.

• The following table lists the files used in the Setup Wizard:

  Table 2‒5: List of files used in Setup Wizard

  Classification	File name	Overview	Output destination
  Setup information list	setupwizardlist.txt	This file is output after the successful completion of setup processing. This file is meant for checking the environment configured by using the Setup Wizard.	For Windows <Cosminexus installation directory>\manager\setup\config For UNIX /opt/Cosminexus/manager/setup/config
  Setup information file	setupwizard.dat	This file is output on selecting Save Setup Information in the Setup Information window. It can be used for batch setup.
  	setupwizard_success.dat	This file is automatically output after the (successful) completion of setup processing. It can be used for batch setup or system replication.
  	setupwizard_failed.dat	This file is automatically output after the (failed) completion of setup processing. It can be used for batch setup. However, when using this file for batch setup, you must remove the cause of failure in the setup processing.
  Log file	setupwizard<number of files>.log	Log of the Setup Wizard is output. You can specify the log file settings such as maximum file size and maximum number of files by using setup.cfg (setting file for Setup Wizard).	Any (output destination specified in setup.log.dir of setup.cfg)
  Easy Setup definition file	cmxsetupwz.xml	This file is output after the (successful) completion of the setup process. This file is meant for checking the defined contents of the environment configured by using the Setup Wizard.	For Windows <Cosminexus installation directory>\manager\setup\config For UNIX /opt/Cosminexus/manager/setup/config
  Connector property file of DB Connector	DBConnector_HiRDB_Type4_CP_cfg.xml Or DBConnector_Oracle_CP_cfg.xml	This file is output after the (successful) completion of setup process. This file is meant for checking the defined contents of the DB Connector used in the environment configured by using the Setup Wizard.
  Settings file for Setup Wizard	setup.cfg	This file is provided for specifying the output destination of the Setup Wizard log file, maximum file size, and the maximum number of files.

To Page Top