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:
The following message displays:sh setuptextmlserver-gcc4.8-Linux-x86_64-4.4.1.5167.bin
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 ConsoleNote: 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.
The following message displays:Update the textml common libraries? (Y/n)
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:
When the IXIA TEXTML Server is installed, the following message displays:Textmlserver will be installed in: /opt/ixiasoft Installing Textmlserver... Installing libraries... Installing clients (Perl, Php, Java) Installing Administration Console...
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:
Press Enter to accept.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]
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]
- If you are updating an existing installation, you see
the following message and this task is
complete.
-
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:
The following message displays:Done.
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:
Press Enter to accept. The installation program confirms that the configuration is complete.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]
Done.