Installation and Uninstallation on UNIX

This chapter describes how to install or uninstall Tmax Server and Client on a UNIX (including Linux) platform.

max provides two types of installers: Full and Patch installers. The Full installer is used to install core files, sample files, and environment variables for the initial installation of Tmax. The Patch installer is used to replace only the Tmax core files for upgrade.

For actual Tmax operation, install both Tmax Server and Client.

1. Pre-installation Tasks

Perform the following before installing Tmax Server and Client.

Create a Tmax account.

The root account can be used to install Tmax, but it is recommended to use a Tmax administrator account.
Check system requirements and mount the CD-ROM.

For information about system requirements for each platform and how to mount a CD-ROM, refer to System Requirements by Platform.
Check the following information.

Check whether the server OS and architecture are 32-bit or 64-bit, the absolute Tmax installation path, and the server IP address used for testing after the installation.

After completing the pre-installation tasks, log in with the Tmax administrator account, navigate to the CD-ROM directory, and run the installation script.

2. Installation

The following are the steps for installing Tmax by using the Full installer.

Insert and mount the product CD-ROM.
Go to the directory that contains the Tmax50_SP2_Fix5_AIX_7L_PowerPC_64_16384.bin file.
Grant the execute permission to the file to allow an installer located in another directory to execute the file.
```
$ chmod u+x Tmax50_SP2_Fix5_AIX_7L_PowerPC_64_16384.bin
```

Execute the file in a console.

tmaxh4@starbj81:/EMC01/starbj81>./Tmax50_SP2_Fix5_AIX_7L_PowerPC_64_16384.bin
Preparing to install...
Extracting the JRE from the installer archive...
Unpacking the JRE...
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...

Launching installer...

Preparing CONSOLE Mode Installation...

================================================================
Tmax50_SP2_Fix5                  (created with InstallAnywhere by Macrovision)
----------------------------------------------------------------




================================================================
Introduction
------------

InstallAnywhere will guide you through the installation of Tmax50_SP2_Fix5.

It is strongly recommended that you quit all programs before continuing with
this installation.

Respond to each prompt to proceed to the next step in the installation.  If you
want to change something on a previous step, type 'back'.

You may cancel this installation at any time by typing 'quit'.

PRESS <ENTER> TO CONTINUE:

The Tmax license agreement screen appears.

===============================================================================
License Agreement
-----------------

Installation and use of Tmax50_SP2_Fix5 requires acceptance of the following
License Agreement:

TP-Monitor Tmax Release
TmaxSoft Co., Ltd. (hereafter, TmaxSoft) End-User License Agreement

Product : Tmax

This is a legal agreement between you (either an individual or an company) and
TmaxSoft, Incorporated.  By opening the sealed software package and/or by using
the software, you agree to be bound by the terms of this agreement.

TmaxSoft License
1.  Grant of License:  This TmaxSoft License Agreement ("License") permits you
to use one copy of the TmaxSoft product Tmax, on any single computer, provided
the software is in use on only one computer at any one time.  If this package
is a license pack, you may make and use additional copies of the software up to
the number of licensed copies authorized.  If you have multiple licenses for
the software, then at any time you may have as many copies of the software in
use as you have licenses.
  The software is "in use" on a computer when it is loaded into the temporary
memory (i.e., RAM) or installed into the permanent memory (e.g., hard disk,
CD-ROM, or other storage devices) of that computer, except that a copy
installed on a network server for the sole purpose of distribution to other
computers is not "in use".  If the anticipated number of users of the software
will exceed the number of applicable licenses, then you must have a reasonable

PRESS <ENTER> TO CONTINUE:

Press <ENTER> to continue displaying the Tmax license agreement.

mechanism or process in place to ensure that the number of persons using the
software concurrently does not exceed the number of licenses.

2.  Copyright:  The software (including any images, "applets," photographs,
animations, video, audio, music and text incorporated into the software) is
owned by TmaxSoft or its suppliers and international treaty provisions.
Therefore, you must treat the software like any other copyrighted materials
(e.g., a book or musical recording) except that you may either (a) make one
copy of the software solely for backup or archival purposes, or (b) transfer
the software to a single hard disk provided you keep the original solely for
backup or archival purposes.  You may not copy the printed materials
accompanying the software, nor print copies of any user documentation provided
in "online" or electronic form.

3.  Other restrictions: This license is your proof of license to exercise the
rights granted herein and must be retained by you. You may not rent, lease, or
transfer your rights under this license on a permanent basis provided you
transfer this license, the software, and all accompanying printed materials,
retain no copies, and the recipient agrees to the terms of this license. You
may not reverse engine, decompile, or disassemble the software, except to the
extent that the foregoing restriction is expressly prohibited by applicable
law.

PRESS <ENTER> TO CONTINUE:

Enter 'Y' to accept the terms of the license agreement or 'N' to stop the installation, and then press <ENTER>.
```
PRESS <ENTER> TO CONTINUE:

DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N):
```

Select the Tmax installation set.

'→' indicates the default value. If you press <ENTER> without choosing an installation set, the default value of '1' is chosen. Press <ENTER> or '1' to install the entire engine. Press '2' to install the Client only.

================================================================
Choose Install Set
------------------

Please choose the Install Set to be installed by this installer.

  ->1- Server + Client
    2- Client

ENTER THE NUMBER FOR THE INSTALL SET, OR PRESS <ENTER> TO ACCEPT THE DEFAULT

Select the Installation directory.

Press <ENTER> to use the default value, or enter a path that you want.

=============================================================
Choose Install Folder
---------------------

Where would you like to install?

  Default Install Folder: /EMC01/QA/tmax

ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT

Enter the IP address of a server in which the Tmax system will run. If an IP address is not entered, the IP address of a node in which Tmax is currently being installed is set by default.

=============================================================
Set Environment Variable
------------------------

TMAX_HOST_ADDR  : IP Address of your Tmax Host.

TMAX_HOST_ADDR (DEFAULT: 192.168.1.87):

The pre-installation summary screen appears. Press <ENTER> to continue the installation.

=============================================================
Pre-Installation Summary
------------------------

Please Review the Following Before Continuing:

Product Name:
    Tmax50_SP2_Fix5

Install Folder:
    /EMC01/QA/tmax

Link Folder:
    /EMC01/QA

Disk Space Information (for Installation Target):
    Required:  269,490,714 bytes
    Available: 431,792,128 bytes

PRESS <ENTER> TO CONTINUE:

The following message indicates that the Tmax installation is ready to start. Press <ENTER> to start the installation.

=============================================================
Ready To Install
----------------

InstallAnywhere is now ready to install Tmax50_SP2_Fix5 onto your system
at the following location:

   /EMC01/QA/tmax

PRESS <ENTER> TO INSTALL:

A progress bar will indicate the installation progress.

=============================================================
Installing...
-------------

[==================|==================|==================|===
[------------------|------------------|------------------|---

=============================================================
Installation Complete
---------------------

Congratulations. Tmax50_SP2_Fix5 has been successfully installed to:

   /EMC01/QA/tmax

PRESS <ENTER> TO EXIT THE INSTALLER:

Press <ENTER> to complete the installation.
```
PRESS <ENTER> TO EXIT THE INSTALLER:
```

To install only Tmax Client, press '2' in the step 8 above
If Tmax Server was successfully installed and started with a developed application, verify that the service operates correctly on various platforms. Install Tmax Client and develop a client program to use the service. The Tmax Client module does not require a license and can be downloaded from the technical support site.
For information about post-installation tasks and sample program testing, refer to Configuration.

3. Verifying the Installation

Installing Tmax creates the following directories.

$Tmax HOME
  +---- appbin
  +---- bin
  +---- config
  +---- lib64
  +---- license
  |---- log
        +---- slog
        +---- tlog
        +---- ulog
  +---- mod
  +---- path
  +---- run
  |---- sample
        +---- client
        +---- tdl
        +---- fdl
        +---- sdl
        +---- server
  +---- svct
  +---- usrinc
  +---- topinc
  +---- cobinc
  +---- tuxinc
  +---- tcpgw
  +---- tcpgwthr
  +---- x25gw
  +---- UninstallerData

$Tmax HOME

Home directory of the Tmax system. (system variable: TMAXDIR, environment variable: TMAXDIR)

appbin

Contains server applications developed by using Tmax.

bin

Contains Tmax commands and utilities.

config

Contains the Tmax system configuration file.

lib

Contains the Tmax library (indicated as ‘lib64’ for 64-bit systems).

license

Contains the license file.

log

Contains log files

Subdirectory	Description
slog	Directory where system log files are stored. (Environment variable: SLOGDIR)
ulog	Directory where system user log files are stored. (Environment variable: ULOGDIR)
tlog	Directory where transaction information files are stored. (Environment variable: TLOGDIR)

Subdirectory

Description

slog

Directory where system log files are stored. (Environment variable: SLOGDIR)

ulog

Directory where system user log files are stored. (Environment variable: ULOGDIR)

tlog

Directory where transaction information files are stored. (Environment variable: TLOGDIR)

mod

Contains libraries to be updated when using TDL.

path

Used for inter-process communications.

run

Contains libraries with versioned names after running tdlupdate when using TDL.

sample

The following describes subdirectories.

Subdirectory	Description
client	Contains a sample client program.
tdl	Contains a sample TDL program.
fdl	Contains a sample field key definition file (demo.f).
sdl	Contains a sample structure definition file (demo.s).
server	Contains a sample server program.

Subdirectory

Description

client

Contains a sample client program.

tdl

Contains a sample TDL program.

fdl

Contains a sample field key definition file (demo.f).

sdl

Contains a sample structure definition file (demo.s).

server

Contains a sample server program.

svct

Contains a service table file used to compile server applications.

usrinc

Contains Tmax header files. demo.f defines Field Definition Language (FDL) fields, and demo.s defines Structure Definition Language (SDL) fields. Users can create FDL and SDL fields.

topinc

Contains header files used to migrate AT&T’s Top End to Tmax.

cobinc

Contains COBOL header files.

tuxinc

Contains header files used to migrate BEA’s Tuxedo to Tmax.

tcpgw

Contains TCPGW header files.

tcpgwthr

Contains TCPGW THR header files.

x25gw

Contains X25GW header files.

UninstallerData

Contains files used to uninstall Tmax.

For more information, refer to Tmax Application Development Guide or Tmax Reference Guide.

4. Configuration

4.1. License File Installation

Install the license file to activate Tmax or to use Tmax services via WebT. However, you do not need to install the license file to use only the Tmax Client because the Client does not require a license.

A license is also required to use the following functions.

Function	Description
Domain Gateway	Used for communication between separate Tmax domains.
Reliable Queue	Used to use a reliable queue.
HostLink	Used to integrate a Tmax Server with a mainframe.
WebT	Used to use Tmax services in web.

Function

Description

Domain Gateway

Used for communication between separate Tmax domains.

Reliable Queue

Used to use a reliable queue.

HostLink

Used to integrate a Tmax Server with a mainframe.

WebT

Used to use Tmax services in web.

To use Tmax basic functions or the additional functions described above, you must obtain a license from TmaxSoft.

Licenses can be requested through the TmaxSoft website or by email. You must fill out the required form to obtain and install a license file. To obtain a license, complete the Tmax installation, run the utility to verify the following system information, and send the results to the license issuer.

If Tmax is installed successfully, the ncpu file is located in the license directory. You can get information required to get a license by executing the ncpu utility as follows.

./ncpu

The result is as follows.

HOST NAME1: tmaxs1

HOST NAME2: tmaxs1

HOSTID: 80FD0534

HOSTID: 80FD0534

H/W SERIAL: 2164065588

NCPUS: 2

UNAME: SunOS tmaxs1 5.7 Generic_106541-11 sun4u sparc

SUNW,Ultra-80

A demo license can be used without functional limitations for a limited period. For information about how to download a demo license, refer to Downloading Software.

4.2. Configuring Environment Variables

The C compiler (cc) and the make utility (make) are required to compile Tmax applications or to develop applications at the site where the Tmax Server is installed. Confirm that the PATH environment variable is set to the directory that includes the C compiler and the make utility.

The following shows Tmax system environment variables that are added to .profile after the Tmax installation from the Bourne or Korn shell. The variables may differ depending on the platform.

# New environment setting added by Tmax50_SP2_Fix5 on Tue Aug 28 15:10:11 JST 2012 1.
# The unmodified version of this file is saved in /data2/phk6254/.profile1069083458.
# Do NOT modify these lines; they are used to uninstall.
TMAXDIR=/data2/phk6254/tmax
export TMAXDIR
# End comments by InstallAnywhere on Tue Aug 28 15:10:11 JST 2012 1.

# New environment setting added by Tmax50_SP2_Fix5 on Tue Aug 28 15:10:11 JST 2012 2.
# The unmodified version of this file is saved in /data2/phk6254/.profile1069083458.
# Do NOT modify these lines; they are used to uninstall.
PATH="/data2/phk6254/tmax/bin:${PATH}"
export PATH
# End comments by InstallAnywhere on Tue Aug 28 15:10:11 JST 2012 2.

# New environment setting added by Tmax50_SP2_Fix5 on Tue Aug 28 15:10:11 JST 2012 3.
# The unmodified version of this file is saved in /data2/phk6254/.profile1069083458.
# Do NOT modify these lines; they are used to uninstall.
TMAX_HOST_ADDR=192.168.1.44
export TMAX_HOST_ADDR
# End comments by InstallAnywhere on Tue Aug 28 15:10:11 JST 2012 3.

# New environment setting added by Tmax50_SP2_Fix5 on Tue Aug 28 15:10:11 JST 2012 4.
# The unmodified version of this file is saved in /data2/phk6254/.profile1069083458.
# Do NOT modify these lines; they are used to uninstall.
TMAX_HOST_PORT=8888
export TMAX_HOST_PORT
# End comments by InstallAnywhere on Tue Aug 28 15:10:11 JST 2012 4.

# New environment setting added by Tmax50_SP2_Fix5 on Tue Aug 28 15:10:11 JST 2012 5.
# The unmodified version of this file is saved in /data2/phk6254/.profile1069083458.
# Do NOT modify these lines; they are used to uninstall.
SDLFILE=/data2/phk6254/tmax/sample/sdl/tmax.sdl
export SDLFILE
# End comments by InstallAnywhere on Tue Aug 28 15:10:11 JST 2012 5.

# New environment setting added by Tmax50_SP2_Fix5 on Tue Aug 28 15:10:11 JST 2012 6.
# The unmodified version of this file is saved in /data2/phk6254/.profile1069083458.
# Do NOT modify these lines; they are used to uninstall.
FDLFILE=/data2/phk6254/tmax/sample/fdl/tmax.fdl
export FDLFILE
# End comments by InstallAnywhere on Tue Aug 28 15:10:11 JST 2012 6.

# New environment setting added by Tmax50_SP2_Fix5 on Tue Aug 28 15:10:11 JST 2012 7.
# The unmodified version of this file is saved in /data2/phk6254/.profile1069083458.
# Do NOT modify these lines; they are used to uninstall.
TMAX_CONNECT_TIMEOUT=3
export TMAX_CONNECT_TIMEOUT
# End comments by InstallAnywhere on Tue Aug 28 15:10:11 JST 2012 7.

# New environment setting added by Tmax50_SP2_Fix5 on Tue Aug 28 15:10:11 JST 2012 8.
# The unmodified version of this file is saved in /data2/phk6254/.profile1069083458.
# Do NOT modify these lines; they are used to uninstall.
LD_LIBRARY_PATH="${LD_LIBRARY_PATH}:/data2/phk6254/tmax/lib64"
export LD_LIBRARY_PATH
# End comments by InstallAnywhere on Tue Aug 28 15:10:11 JST 2012 8.

he following describes each environment variable.

Environment Variable	Description
TMAXDIR	Tmax installation directory.
TMAX_HOST_ADDR	IP address of the Tmax Server.
TMAX_HOST_PORT	Port number of the Tmax Server. The port number must be identical to the value set in TPORTNO of the Tmax Server’s configuration file (sample.m).
SDLFILE	Location of the SDL binary file (filename.sdl), which is required to use structure buffers. Set this variable only to use structure buffers.
FDLFILE	The location of the FDL binary file (filename.fdl), which required to use field key buffers. Set this variable only to use field key buffers.
TMAX_CONNECT_TIMEOUT	Tmax system connection timeout.
LD_LIBRARY_PATH	Shared library path. The environment variable is different depending on the OS as follows. SunOS/Compaq/Linux: LD_LIBRARY_PATH HP-UX: SHLIB_PATH AIX: LIBPATH
TMAX_BACKUP_ADDR	IP address of the backup Tmax Server.
TMAX_BACKUP_PORT	Port number of the backup Tmax Server. The port number must be identical to the value set in TPORTNO of the backup Tmax Server’s configuration file (filename.m).

Environment Variable

Description

TMAXDIR

Tmax installation directory.

TMAX_HOST_ADDR

IP address of the Tmax Server.

TMAX_HOST_PORT

Port number of the Tmax Server. The port number must be identical to the value set in TPORTNO of the Tmax Server’s configuration file (sample.m).

SDLFILE

Location of the SDL binary file (filename.sdl), which is required to use structure buffers. Set this variable only to use structure buffers.

FDLFILE

The location of the FDL binary file (filename.fdl), which required to use field key buffers. Set this variable only to use field key buffers.

TMAX_CONNECT_TIMEOUT

Tmax system connection timeout.

LD_LIBRARY_PATH

Shared library path. The environment variable is different depending on the OS as follows.

SunOS/Compaq/Linux: LD_LIBRARY_PATH
HP-UX: SHLIB_PATH
AIX: LIBPATH

TMAX_BACKUP_ADDR

IP address of the backup Tmax Server.

TMAX_BACKUP_PORT

Port number of the backup Tmax Server. The port number must be identical to the value set in TPORTNO of the backup Tmax Server’s configuration file (filename.m).

Since Tmax provides shared libraries, you do not have to re-compile server applications whenever installing a patch or new version. Tmax provides both static and shared libraries. (However, Tmax provides only some shared libraries for AIX.)

To use shared libraries, include them in applications and set FLAGS in each OS compiler. The shared library directory is set automatically in the configuration file (LD_LIBRARY_PATH, SHLIB_PATH, or LIBPATH) when installing Tmax.

The following are compilation options for each platform.

Solaris 32-bit, Compaq, Linux
```
CFLAGS = -O –I$(TMAXDIR)
```
Solaris 5.7 - 5.9 64-bit
```
CFLAGS = -xarch=v9 -O –I$(TMAXDIR)
```
Solaris 5.10~ 64bit
```
CFLAGS = -m64 -O –I$(TMAXDIR)
```
HP PA-RISC 32-bit
```
CFLAGS = -Ae -O –I$(TMAXDIR)
```

HP PA-RISC 64-bit

CFLAGS = -Ae +DA2.0W +DD64 +DS2.0 -O -I$(TMAXDIR)

HP Itanium 32-bit

CFLAGS = -O -Ae -w +DSblended +DD32 -D_HP -I$(TMAXDIR)

HP Itanium 64-bit

CFLAGS = -O -Ae -w +DSblended +DD64 -D_HP -I$(TMAXDIR)

IBM 32-bit
```
CFLAGS = -q32 –brtl -O –I$(TMAXDIR)
```
IBM 64bit
```
CFLAGS = -q64 –brtl -O –I$(TMAXDIR)
```

Apply the Tmax environment variables from the home directory as follows.

Bourne or Korn shell
```
. ./.profile
```
C shell
```
source .cshrc
```

Check whether the environment variables are set properly by using the env or set command.

For more information, refer to Tmax Getting Started Guide or Tmax Application Development Guide.

4.3. Configuring sample.m

sample.m is a Tmax system configuration file written in ASCII. Compile the file to create a binary file used to start and end Tmax by using the cfl utility.

The following is sample sample.m.

*DOMAIN
tmax1          SHMKEY = 79990, MINCLH = 1, MAXCLH = 3,
               TPORTNO = 8888, BLOCKTIME = 30

*NODE
tmaxs2         TMAXDIR = "/user/mmidea/tmax",
               APPDIR  = "/user/mmidea/tmax/appbin",
               PATHDIR = "/user/mmidea/tmax/path",
               TLOGDIR = "/user/mmidea/tmax/log/tlog",
               ULOGDIR = "/user/mmidea/tmax/log/ulog",
               SLOGDIR = "/user/mmidea/tmax/log/slog"

*SVRGROUP
svg1           NODENAME = tmaxs2

*SERVER
svr1           SVGNAME = svg1, MIN = 1

*SERVICE
SDLTOUPPER     SVRNAME = svr1
SDLTOLOWER     SVRNAME = svr1

5. Testing the Tmax Installation

Test the Tmax installation as follows.

The following are an environment and files for the testing.

Environment

Item Description

Operating System

SunOS 5.7 32-bit

Shell

Korn

Path

$TMAXDIR=/user/tmax

Item	Description
Operating System	SunOS 5.7 32-bit
Shell	Korn
Path	$TMAXDIR=/user/tmax

Files

Name	Description
sample.m	Tmax configuration file ($TMAXDIR/config)
svr1.c	Sample server program ($TMAXDIR/sample/server)
sdltoupper.c	Sample client program ($TMAXDIR/sample/client)
demo.s	Structure definition file ($TMAXDIR/sample/sdl)
demo.f	Field key definition file ($TMAXDIR/sample/fdl)
tmax.env	Tmax environment variable definition file ($TMAXDIR/sample/client)

Name

Description

sample.m

Tmax configuration file ($TMAXDIR/config)

svr1.c

Sample server program ($TMAXDIR/sample/server)

sdltoupper.c

Sample client program ($TMAXDIR/sample/client)

demo.s

Structure definition file ($TMAXDIR/sample/sdl)

demo.f

Field key definition file ($TMAXDIR/sample/fdl)

tmax.env

Tmax environment variable definition file ($TMAXDIR/sample/client)

5.1. Basic Configuration

The following describes how to configure the basic environment.

Compile the configuration file in the $TMAXDIR/config directory. sample.m is automatically created in TMAXDIR/config when Tmax is installed. TMAXDIR is the Tmax installation home directory.

$>cfl –i sample.m

If the configuration file is successfully compiled, the following message is displayed.

CFL is done successfully for node(<nodename>)

The host name set in sample.m may not be identical to the actual host name. For example, if executing the uname –n command displays tmax1.tmax.co.kr as a host name, this means that compiling sample.m failed. In this case, check a host name by using the ncpu utility in TMAXDIR/license, set the host name in sample.m, and get a license appropriate for the host name. For more information about ncpu, refer to Configuration.

Create a service table as follows. A service table has information about services handled by each process. It is used when a server process is created.
```
$>gst
```
If the service table is created successfully, the following message is displayed.
```
SVC tables are successfully generated GST is successfully done
```
Create a binary structure definition file in the TMAXDIR/sample/sdl directory by using the sdlc command. Since a server and a client use different files, use different options for the server and the client.
Run the sdlc command for server or client case. If sdlc is successfully executed in either case, no message is displayed.
- Server
  $>sdlc –i demo.s
  Executing the above command creates demo_sdl.h and demo_sdl.c. The files are used when compiling server programs that use structure buffer.
  
  The sample makefile has a routine to execute sdlc when compiling server programs that use structure buffers. However, it is recommended to execute sdlc before the compilation.
- Client
  $>sdlc –c –i demo.s –o tmax.sdl
  Executing the above command created demo_sdl.h and tmax.sdl. If the –o option is not used in the above command, the result sdl file is named as <structure file name>.sdl by default. The created files are used when client programs that use structure buffers allocate memory to the buffers.
  
  The result sdl file is located and named by referring to SDLFILE set in a user configuration file. When Tmax is installed, the installer sets TMAXDIR/sample/sdl/ tmax.sdl to SDLFILE by default. To use the default value, specify the result file name as tmax.sdl by using the –o option.
Create a binary field key file in the TMAXDIR/sample/fdl directory by using the fdlc command for both the server and the client.
```
$>fdlc –c –i demo.f
```
If the file is created successfully, the following message is displayed.
```
FDLC is successfully done
```

5.2. Compiling a Server Program

Compile a server program that provides a service in the TMAXDIR/sample/server directory.

$>./compile sdl svr1

If the program is successfully compiled, the following message is displayed.

cc -O -I/user/tmax -c svr1.c

cc -O -I/user/tmax -L/user/tmax/lib -o svr1 svr1.o demo_sdl.o svr1_svctab.o

-lsvr -lnsl –lsocket -lnodb

mv svr1 /user/tmax/appbin

/user/tmax/appbin in the last line can be replaced with a directory that includes service programs. The directory can be set in Tmax configuration file by a user.

For more information, refer to Tmax Administration Guide.

5.3. Starting Tmax

Start Tmax with the following command.

$>tmboot

If Tmax starts successfully, the following message is displayed.

TMBOOT for node(tmaxs2) is starting:
        TMBOOT: TMM is starting: Mon Jun 20 17:05:50 2022
        TMBOOT: CLL is starting: Mon Jun 20 17:05:50 2022
        TMBOOT: CLH is starting: Mon Jun 20 17:05:50 2022
10045.170550:(I) CLH0211 General Infomation : event mechanism is epoll [EVT0003]
(I) CLH9991 Current Tmax Configuration: Number of client handler(MINCLH) = 1
                Supported maximum user per node = 15922
                Supported maximum user per handler = 15922 [CLH0141]
        TMBOOT: TLM(tlm) is starting: Mon Jun 20 17:05:50 2022
        TMBOOT: SVR(svr1) is starting: Mon Jun 20 17:05:50 2022

The <nodename>, <Supported maximum user per node>, and <Supported maximum user per handler> values differ depending on the system.

Tmax may not start successfully in the following cases. If Tmax starts abnormally or an error messages is displayed, check the following, take appropriate action, and then restart Tmax.

TPORTNO and TPORTNO+1 set in the Tmax configuration file (xxxx.m) are already used by the system.
The value set in SHMKEY is already used by the system.
The Tmax configuration file is not compiled successfully with cfl.
Service programs registered in the Tmax configuration file are not all compiled.

5.4. Compiling and Executing a Client Program

The following are the steps for compiling and executing a client program.

Compile a client program in the TMAXDIR/sample/client directory.

TMAXDIR/sample/client
$>./compile c sdltoupper

If the program is successfully compiled, the following message is displayed.

cc -O -I/user/tmax -c sdltoupper.c
cc -O -I/user/tmax -L/user/tmax/lib -o sdltoupper sdltoupper.o -lcli -lnsl –lsocket

Check that tmax.env exists in the current directory (sample/client). tmax.env is a text file that defines environment variables used for a client to access the Tmax system.

Execute the client program.
```
$>./sdltoupper tmax
```
If the service is executed successfully, the following message is displayed, which means that Tmax is installed successfully.
```
send data: tmax
recv data: TMAX
```

The following describes sample files provided by Tmax.

Client	Server	Compilation	Remarks
sdltoupper.c sdltolower.c	svr1.c	compile sdl svr1	STRUCT buffer
toupper.c tolower.c	svr2.c	compile c svr2	STRING buffer
fdltoupper.c fdltolower.c	svr3.c	compile c svr3	FIELD buffer
cli_ucs.c	svr_ucs	compile ucs svr_ucs	UCS program
toupper_conv.c	svr_conv.c	compile c svr_conv	Interactive service
toupper_rq.c cli_rq.c	svr_rq.c	compile c svr_rq	RQ service
cli_sq.c	svr_sq.c	compile c svr_sq	SQ service
hmscall.c hmsrecv.c	svr_hms.c	compile c svr_hms	HMS program
fdl_main.c	fdltest.pc	compile pc fdltest	FIELD buffer, Oracle integration
sdl_main.c	sdltest.pc	compile psdl sdltest	STRUCT buffer, Oracle integration
tbr_main.c	tbrtest.tbc	compile tbc tbrtest	CARRAY buffer, Tibero integration
mrm_main.c	mrmtest.c mrmtest_ora.pc mrmtest_tbr.tbc	compile mr mrmtest	MRM (Oracle + Tibero integration)
mservice.c mtmc.c	msvr.c	compile mt msvr	Multi threaded&contexted program

Client

Server

Compilation

Remarks

sdltoupper.c

sdltolower.c

svr1.c

compile sdl svr1

STRUCT buffer

toupper.c

tolower.c

svr2.c

compile c svr2

STRING buffer

fdltoupper.c

fdltolower.c

svr3.c

compile c svr3

FIELD buffer

cli_ucs.c

svr_ucs

compile ucs svr_ucs

UCS program

toupper_conv.c

svr_conv.c

compile c svr_conv

Interactive service

toupper_rq.c

cli_rq.c

svr_rq.c

compile c svr_rq

RQ service

cli_sq.c

svr_sq.c

compile c svr_sq

SQ service

hmscall.c

hmsrecv.c

svr_hms.c

compile c svr_hms

HMS program

fdl_main.c

fdltest.pc

compile pc fdltest

FIELD buffer, Oracle integration

sdl_main.c

sdltest.pc

compile psdl sdltest

STRUCT buffer, Oracle integration

tbr_main.c

tbrtest.tbc

compile tbc tbrtest

CARRAY buffer, Tibero integration

mrm_main.c

mrmtest.c

mrmtest_ora.pc

mrmtest_tbr.tbc

compile mr mrmtest

MRM (Oracle + Tibero integration)

mservice.c

mtmc.c

msvr.c

compile mt msvr

Multi threaded&contexted program

6. Uninstallation

To uninstall Tmax using the Full installer, run the file in the following path to remove the Tmax engine, installation directory, and environment variables.

$TMAXDIR/UninstallerData/Uninstall

Manually remove files created after the Tmax installation because they are not removed automatically.

The following are the steps for uninstalling Tmax.

Execute Uninstall.exe. Check the uninstallation information.

tmaxh4@QA:/EMC01/QA/tmax/UninstallerData>./Uninstall
Preparing CONSOLE Mode Installation...

================================================================
Tmax50_SP2_Fix5                  (created with InstallAnywhere by Macrovision)
----------------------------------------------------------------



================================================================
Uninstall Tmax50_SP2_Fix5
--------------------------

About to uninstall...

Tmax50_SP2_Fix5

This will remove features installed by InstallAnywhere.  It will not remove
files and folders created after the installation.

PRESS <ENTER> TO CONTINUE:

Press <ENTER> to begin the uninstallation.

===============================================================================
Uninstalling...
---------------

...*
*
*************************
*************************
*************************
************************
...*
*
*************************
*************************
*************************
************************
...*
*
*************************
*************************
*************************
************************
...*
*
*************************
*************************
*************************
*************************



===============================================================================
Uninstall Complete
------------------

Some items could not be removed.

Verify that Tmax has been successfully uninstalled.

6.1. Verifying the Uninstallation

Verify the uninstallation by checking the following.

Files and directories

Verify that all files and subdirectories under the $TMAXDIR (default value: $HOME/tmax) directory have been removed. Manually remove files created after the Tmax installation because they are not removed automatically.
Environment variables

Verify that Tmax-related environment variables have been removed.
PATH

Verify that Tmax paths such as $HOME/tmax/bin have been removed.