(Linux) Install IXIA TEXTML Server

The fourth task when you update a build is to install IXIA TEXTML Server in Linux.

About this task

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:

Procedure

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 need only 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.
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.

In response, if the following message displays, press Enter again.

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 display, depending on the components for installation.

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

When you install the IXIA TEXTML Server, the following message displays:

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

Press Enter.

The following message displays:

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

In the resulting prompt, 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]
```
Note: Use 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.
(Recommended) To accept textml as the username, 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.
```