Install IXIA TEXTML Server (Linux)

This procedure describes how to install IXIA TEXTML Server in Linux.

When you install TEXTML Server, you also create a TEXTML Server instance. The instance is the service that runs the TEXTML Server software.

The name of the service is as follows:

textml.<instance_name>

For example, if the instance name is ts01, the service name is:

textml.ts01

The command to start TEXTML Server is:

service textml.ts01 start

This task assumes that you copied the .bin installation file to the Linux machine, in the /tmp folder.

Note: You must perform this procedure as user root.

To install TEXTML Server:

Open a command-line interface to the Linux machine as user root, using a secure shell client such as PuTTY.
Run the following command to install bzip2, Perl and libxslt:
```
yum install bzip2 perl libxslt
```
Go to the /tmp folder and run the following command:
```
sh <installer_name>
```
For example:
```
sh setuptextmlserver-gcc4.8-Linux-x86_64-4.4.1.5167.bin
```
The following message displays:
```
Textmlserver installation
(I)nstallation (default) or files (E)xtract only? (I/e)
```
Press Enter to launch the installation.
The following message displays:
```
Installation files will be extracted in: /tmp/25005/
```
Note: The extraction location (tmp/25005 in the example above) is a temporary folder labeled with a random numerical string.
Wait while the files extract.
When the extraction completes, you receive the following prompt:
```
(F)ull Installation (default) or (C)ustomized Installation (F/c) 
```
For the IXIA CCMS, you only need the following components:
- TEXTML Server
- Clients
- Administration Console
  Note: Install the console only if you have a graphic interface running on the Linux server; if you plan to access TEXTML Server from a console located on another machine, you do not need to install the Administration Console now.
Type C, for customized, and press Enter.
The following message displays:
```
Customized Installation...
Textmlserver Installation? (Y/n)
```
Press Enter.
The following message displays:
```
Samples files Installation? (Y/n) 
```
Type N to skip the Samples files installation and press Enter.
The following message displays:
```
Clients Installation (Perl and Java)? (Y/n)
```

Press Enter.

The following message displays.

Administration Console Installation? (Y/n)

Press Enter.
If the following message displays, press Enter.
```
Update the textml common libraries? (Y/n)
```
The following message displays:
```
Specify location for Ixiasoft folder (Default: /opt/ixiasoft)
```

Specify the location for IXIA TEXTML Server, or press Enter to install to the default location.

The installation runs; messages similar to the following are displayed, depending on the components you are installing:

Textmlserver will be installed in: /opt/ixiasoft
                    Installing Textmlserver...
                    Installing libraries...
                    Installing clients (Perl, Php, Java)
                    Installing Administration Console...

When the IXIA TEXTML Server is installed, the following message displays:

Are you ready to configure your installation? (Y/n)

Press Enter.

The following message is displayed:

Do you want to (create/update/delete) a Textml Server instance? (create)

Choose one of the following actions:
- If this is the first time that you are installing IXIA TEXTML Server, or if you are updating an existing installation but want to create a new instance of TEXTML Server, press Enter.
- If you are updating an existing installation and want to use the same instance name, enter update and press Enter.
The following message displays:
```
What is the path that will contain all TextmlServer instances?
 [/opt/ixiasoft/textmlserver]
```
Press Enter to accept the default path.
If this directory does not exist, a message similar to the following displays:
```
The path "/opt/ixiasoft/textmlserver" does not exist currently. This
program is going to create it, including needed parent directories. Is this
what you want? [yes]
```
Press Enter to accept.
A message similar to the following then displays:
```
The list of instances of Textml Server:
  (none)
End of the list

What is the name of the instance? [default]
```
Note:
If TEXTML Server instances are already installed on the server, they are listed. For example:
```
The list of instances of Textml Server:
  ts01
  ts02
End of the list
```
Enter the name of the TEXTML Server instance to create or update and press Enter.
The following message displays:
```
What user ID to use? [textml]
```
This is the name of the user that runs the TEXTML Server instance. When you create a docbase, you must give write permissions on the docbase folder to this username.
You can specify an existing user. If you specify a user that does not exist, the installation procedure creates it.
To accept textml as the username (recommended), press Enter, and then respond to the notification you receive.
- If you are updating an existing installation, you see the following message and this task is complete.
```
Done.
```
- If you are creating a new instance, the following message displays:
```
Do you want to install textmlserver as a service? [yes]
```
To configure the TEXTML Server component so that it starts automatically when the TEXTML Server service is started, press Enter.
The installation program confirms that the TEXTML Server configuration completed:
```
Done.
```
The following message displays:
```
Configuring Clients.… 
Which action do you want (install/delete) the Client APIs? [install] 
```

Press Enter.

The following message displays:

What is the path that will contain all Client APIs? 
[/opt/ixiasoft/clients]

To accept the default path, press Enter.
If this directory does not exist, a message similar to the following displays:
```
The path "/opt/ixiasoft/clients" does not exist currently. This
program is going to create it, including needed parent directories. Is this
what you want? [yes]
```
Press Enter to accept. The installation program confirms that the configuration is complete.
```
Done.
```