Before you can install BeanConnect components, you must first install JDK, PCMX, openUTM, openUTM-LU62 gateway (for CICS partners) and the BeanConnect product files from the master installation.
The BeanConnect installation program can perform the following operations:
Installing the BeanConnect proxy container and the MC-CmdHandler
Installing the BeanConnect Management Console including the command line interface (MC-CLI)
Starting the installation procedure
After you have installed the product files, the second step is to perform a user-specific installation of the BeanConnect components.
Log in to the system using the user ID under which BeanConnect is to run. Root or administration authorization is not required for installation.
Switch to the directory in which you want to install the proxy container / Management Console.
Example:
Switch to the directory
<home1/lib>if you want to install the proxy container in<home1/lib>/<proxy_cont_name>and the Management Console in<home1/lib>/<console_name>.Start the installation using the following command:
<BC_inst_dir>/shsc/install.BeanConnectThe procedure displays a menu containing the components you can install.
1 BeanConnect Proxy Container
This installs a BeanConnect proxy container and the MC-CmdHandler.
2 Management Console (Administration Tool)
This installs the BeanConnect Management Console including the command line interface (MC-CLI).
Specify the number of the component(s) that you want to install. If you want to install both components, enter 1 2. If you enter
q, the installation procedure is terminated.
Installing the BeanConnect proxy container
The installation procedure <BC_inst_dir>/shsc/install.BeanConnect requires the following input:
User base directory in which the BeanConnect proxy container has to be installed
The installation procedure sets the current directory (from which the procedure was started) as the BeanConnect user base directory
<BC_home>in which the proxy container is to be installed.If you accept this directory with
y, the installation procedure continues.
If you specifyn, the installation procedure is aborted.To install the proxy container in another directory, switch to this directory and start the installation again.
Name of the proxy container
Specify the name of the proxy container.
The name must be unique in your system.
The name can have a maximum length of eight characters.
The following characters are permitted: A,...,Z, a,...,z, 0,...,9
Lowercase letters are converted to uppercase letters.The default is
BCCONT.A subdirectory with the name of the proxy container is created in the BeanConnect user base directory. The files are installed in this sub-directory. The proxy container home directory is therefore
<BC_home>/<proxy_cont_name>(e.g./opt/lib/bc65a00/BCCONT).If you specify the name of a proxy container that is already installed and is located under
<BC_home>, you are asked whether you want to overwrite the proxy container (new installation) or perform an update installation (see Update installation for the BeanConnect proxy container and Management Console ).openUTM home directory
Specify the openUTM home directory. The installation procedure also searches for appropriate openUTM versions that are installed on the computer and displays a list of the installed UTM versions as of a minimum version. You can select the desired home directory from this list.
If openUTM is not installed in the specified directory, the following error message is displayed:
openUTM not found!In this case, check the specified home directory or the installation of openUTM (see Installing openUTM ).
JAVA home directory
Prerequisite: JDK must already be installed on your system before you can install the proxy container.
The installation procedure asks for the name of the JAVA home directory. You have to specify the directory explicitly. No name is suggested. You have to specify a fully qualified directory name. The procedure then checks your input.
If JDK is not installed in the specified directory, the following error message is displayed:
JDK not found!
Check the specified home directory or install JDK first.Acceptance
The installation procedure displays the name of the archive from which the proxy container is installed. Installation must be performed from the archive
<BC_inst_dir>/64/CPIO.BCCont, respectively.Accept this archive.
Port number of the proxy container
BeanConnect needs a range of one hundred port numbers. You are asked to enter the port number which specifies the beginning of this range.
The range of port numbers must not be used by other proxy containers or other applications. You have to specify a different port number here.
Start Value of the Port Number Range for BeanConnectSpecify the start value of the port number range. The next hundred port numbers are reserved for BeanConnect. Values between 1025 and 65436 are permitted for the port number. Default: 31000.
Password for administration of the proxy container
Specify the password. Default: beanconnectadmin
The proxy container is installed once this dialog has been completed.
You can repeat the installation procedure several times if you want to install multiple proxy containers.
Installing the Management Console
The installation procedure requires you to make the following entries:
User base directory in which the Management Console is to be installed(omitted if you have chosen steps 1 and 2, i.e. you have already installed the proxy container)
The installation procedure sets the current directory (from which the procedure was started) as the BeanConnect user base directory
<BC_home>in which the Management Console is to be installed.If you accept the directory with
y, the installation procedure continues. If you specifyn,the installation procedure is aborted.Directory for the Management Console configuration files
The configuration files are stored in a sub-directory of the BeanConnect user base directory
<BC_home>.Specify the sub-directory
<console_name>. Default:consoleThe Management Console home directory is consequently
<BC_home>/<console_name>.If you specify the name of a Management Console that is already installed in
<BC_home>, you are asked whether you want to overwrite the Management Console (new installation) or perform an update installation (see Update installation for the BeanConnect proxy container and Management Console ).JAVA home directory
Prerequisite: JDK must already be installed on your system before you can install the Management Console.
The installation procedure asks for the name of the JAVA home directory. You have to specify a fully qualified directory name. The procedure then checks your input.
If JDK is not installed in the specified directory, the following error message is displayed:
JDK not found!
Check the specified Java home directory or install JDK first.Oracle WebLogic Server configuration
The following query is issued:
Configuration for Oracle WebLogic Server?([y]|n)If you enter
n, continue at point 6.If you enter
y, you will see the prompt:Please enter product installation directory of WebLogic Server or enter <RETURN> for remote machineIf you enter <RETURN>, you will see the message:
Please copy "wlclient.jar" and "wljmxclient.jar" to "<console-directory>/bin/weblogic" after this installationAcceptance
The installation procedure displays the name of the archive from which the Management Console is installed. Installation must be performed from the archive
<BC_inst_dir>/CPIO.console.Accept this archive.