Running the xgtd server
The server component of the xGT application is called xgtd.
It is a linux daemon and is launched automatically at linux boot.
You can examine and control the daemon using standard linux utilities:
sudo systemctl status xgtd
sudo systemctl stop xgtd
sudo systemctl start xgtd
sudo systemctl restart xgtd
Data considerations
The default location for xgtd to read and write data is the /srv/xgtd/data directory.
You can copy data to the this home directory or organize data into subdirectories.
The load() method in the xgt python module will accepts a path name as one of the parameters.
When the path is a relative path, the server will look for the file name (or names, if
wildcards are provided) in the default location.
The save() command uses the same default location.
To learn more about loading and saving, read the data management guide.
Configuring xgtd
Some parameters of xGT can be configured with a JSON-formatted .gemsconfig file located in the home directory of the user running the server process.
The folowing variables for configuring xGT are supported:
worker_threads: unsigned integer - Controls the number of worker threads xGT uses. Defaults to the number of cores in the system.pin_threads: true/false - Controls whether the worker threads are pinned to a specific core. This means they won't be able to move around. Defaults to false.max_memory: unsigned integer - Controls the maximum amount of memory xGT will use. Defaults to the available system RAM.mir_optimizations: true/false - Enables the use of the degree cycle-based code generator. Defaults to false.locale: string - Locale for comparing strings. Defaults to C.s3_key_id: string - Used for S3 authentication if an .aws/credentials file does not exist for the profile.s3_key: string - Used for S3 authentication if an .aws/credentials file does not exist for the profile.
Example .gemsconfig file:
{
"worker_threads" : 4,
"pin_threads" : false,
}
To configure xGT on AWS you would login to the ec2 instance and add a .gemsconfig file to the /home/xgtd directory.
Then you would restart xGT daemon:
sudo systemctl restart xgtd
S3 Credentials
When loading a file using the load method and an s3: protocol prefix, xGT will check the ~/.aws/credentials file for the two variables aws_access_key_id and aws_secret_access_key.
(These values may also be specified at runtime in user code by passing them to a Connection object.)
When reading an ~/.aws/credentials file, xGT also supports profile selection via the AWS_PROFILE environment variable.
If no environment variable is found, xGT will use the default profile.