Table of Contents
This chapter describes the required tasks before installing WebtoB.
Before WebtoB is installed, the following must be checked:
Host name
A host name is required when a license is requested. There are three ways to check for a host name:
In the case of UNIX systems
Use the 'name –n' command or "/etc/hosts file".
In the case of Windows systems
Check system environment variables.
In the case of using a utility program provided by WebtoB
Execute ncpu in the '/license' directory of WebtoB installation path.
A port number to be assigned when a web server starts. (default value: 80)
The default port can be used only by root. Other users must use a port number starting after 1024.
Account used when a web server starts (default value: root)
To properly start WebtoB, the product license is necessary and the WebtoB environment file must be set. To configure the WebtoB environment file, a host name must be checked.
WebtoB automatically searches for a host name and IP address and then registers them in the environment file during installation.
The following example illustrates how to find a host name and an IP address in a SUN Solaris system. If the host name is displayed in the form of FQDN (Fully Qualified Domain Name), only the first name needs to be set.
$ ifconfig –a
lo0: flags=849<UP,LOOPBACK,RUNNING,MULTICAST> mtu 8232
inet 127.0.0.1 netmask ff000000
hme0: flags=863<UP,BROADCAST,NOTRAILERS,RUNNING,MULTICAST> mtu 1500
inet 192.168.1.10 netmask ffff0000 broadcast 192.168.255.255
$ uname –n
tmaxs1
When WebtoB starts, a port that waits for a connection from an external client (Internet browser) is needed. In general, the default port 80 is used if a web server is installed. However, this port can only be used by a superuser in most operating systems.
Only a user who has root privileges can use port 80. To install WebtoB with a general user account, a port number after 1024 must be used.
Before registering a port in the environment file, the port must be check for conflicts with other programs. If a port other than 80 is used, the user must be notified of the port number.
If port 80 is not used, a browser has to request a service.
The following example is an HTTP URL when the port number of a web server is 8080:
http://www.tmax.co.kr:8080/index.html
Before installing WebtoB, the system environment file in use must be checked. If WebtoB is already installed or a user wants to install WebtoB with WebtoB Servlet Engine together, it is recommended to delete environment variables related to the existing WebtoB installation.
Deleting the environment variables of a previously installed copy of WebtoB prevents installation paths conflicts and the WebtoB Servlet Engine from causing shared memory conflicts.
Whether the JDK path is set or not must be checked because a security password must be encoded while WebtoB Standard Edition and WebtoB Servlet Engine are installed together.
The JDK path can be checked with the following:
$which java
If JDK has not been installed, download the appropriate Java 2 SDK v6.0 or later Standard Edition from the following site:
http://www.oracle.com/technetwork/java/index.html
JDK of Java 5.0 or later version must be installed. After installation, ensure that the JDK is properly installed.
File Descriptor (FD) affects the number of concurrent processes and file accesses. The FD value must be larger than the sum of the number of concurrent processes and accesses.
For optimal performance, it is recommended to set FD according to the following table.
| Operating System | Maximum FD Value |
|---|---|
| UNIX/Linux-K2.6 | 16384 |
| Windows | 4096 |
To run WebtoB in the IPv6 system, the environment variables must be set. If the environment variables are not set, IPv4 socket is used.
IPv6 is specified according to operating systems as shown below.
UNIX/Linux
WEBTOB_PREFER_IPV6=Y #(or y or 1) export WEBTOB_PREFER_IPV6
Windows
Variable Name: WEBTOB_PREFER_IPV6 Variable Value : Y
The following example verifies whether the IPv6 socket is started.
UNIX/Linux
$netstat -a |grep "8080" tcp 0 0 :::3423 :::* LISTEN
Windows
C:\>netstat -a |find "8080" TCP [::]:3423 [::]:0 LISTENING
A license is required to use WebtoB. Before purchasing a full purchase license, a demo license can be obtained as follows:
Check the host name.
A host name is required when applying for the demo license.
A host name can be checked using the hostname command or ncpu created in the ${WEBTOBDIR}/license directory while WebtoB is installed.
An example usage of the hostname command.
$ hostname Gloria
An example usage of ncpu.
$WEBTOBDIR/license/ncpu HOST NAME: qpsx1 HOSTID: A8C03002 NCPUS: 2 OPENFILES: 8192/65536 UNAME: Linux qpsx1 2.6.21-1.3194.fc7 #1 SMP Wed May 23 22:35:01 EDT 2007 i686 i686 i386 GNU/Linux
Apply for a license.
1) Apply for a license from the following site:
http://technet.tmaxsoft.com/en/front/main/main.do > [Demo License Request]
2) Enter the required information, (product name, hostname, e-mail address) in the License Request screen.
3) The demo license is transferred to the previously specified e-mail address.
Apply the license. Save the received demo license to the ${WEBTOBDIR}/license directory with the name of license.dat. If the demo license is applied, a user can use WebtoB for 2 months without limitations.
Basic installation process for WebtoB follows:
Verify system requirements, such as platform and operating system, are met.
Check if another web server or a previous version of WebtoB is already installed. If another web server is installed, check for port number conflicts, and terminate the web server if necessary.
Start the WebtoB installation on the desired server.
Apply the license file after installation is completed.