Configure the TEXTML Server components

This procedure lets you create a TEXTML Server instance and specify the user ID under which this TEXTML Server instance will run.

To configure the TEXTML Server components:

Note: You must perform this procedure as user root.

Navigate to the TEXTML Server setup folder; for example:
```
cd /opt/ixiasoft/bin/[XXXX]/setup 
```
Note: The number XXXX in the example above represents the build version number variable.

Launch the setup command:

sh setup.textml.sh

The following message is displayed:

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

Do one of the following:
- If this is the first time that you are installing 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 is displayed:
```
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 is displayed:
```
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 is then displayed:
```
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 is displayed:
```
What user ID to use? [textml]
```
This is the name of the user that will run the TEXTML Server instance. (When you create a docbase, you will need to 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 will create it.
To accept textml as the username (recommended), press Enter.
Do one of the following:
- If you are updating an existing installation, you see the following message and you have completed this procedure.
```
Done.
```
- If you are creating a new instance, the following message is displayed:
```
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.

Note: For a cluster installation, enter no. TEXTML Server will be started manually.
The installation program confirms that the TEXTML Server configuration is complete:
```
Done.
```
Note: The next steps depend on the components that you are installing. This procedure assumes that you have installed all components. Simply skip the steps that do not apply.

The following message is displayed:
```
Configuring MetaServices...
Do you want to: (create/update/delete) a MetaService instance? [create]
```
Do one of the following:
- If this is the first time that you are installing TEXTML Server, or if you are updating an existing installation but want to create a new Meta Service instance, 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 is displayed:
```
What is the path that will contain all the MetaServices instances?
[/opt/ixiasoft/metaservices]
```
Press Enter to accept the default path.
The following message is displayed:
```
The list of instances of Meta Service:
  (none)
End of the list

What is the name of the instance? [default]
```
Note: If Meta Service instances are already installed on the server, they are listed.
Enter the name of the TEXTML Server instance to create or update and press Enter.
The following message is displayed:
```
What user ID to use? [textml]
```
Press Enter to accept the default Metaservices user ID, textml:
The following message is displayed:
```
Do you want to install MetaServices as a service? [yes]
```
To install the Metaservices component as a service (starts automatically), press Enter:.
The following message is displayed:
```
Done.
Configuring Clients...
Which action do you want (install/delete) the Client APIs? [install]
```
To install the client components, press Enter.
The following message is displayed:
```
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 is displayed:
```
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.
```