XLIO - Configuration Migration Guide

            

            
export XLIO_USE_NEW_CONFIG=1
        

            

            
export XLIO_TCP_NODELAY=1
export XLIO_TCP_QUICKACK=1
export XLIO_LOG_LEVEL=3
export XLIO_LOG_FILE="/var/log/xlio.log"
        

            

            
export XLIO_USE_NEW_CONFIG=1
        

            

            
{
  "network": {
    "protocols": {
      "tcp": {
        "nodelay": { "enable": true },
        "quickack": true
      }
    }
  },
  "monitor": {
    "log": {
      "level": "info",
      "file_path": "/var/log/xlio.log"
    }
  }
}
        

            

            
 export XLIO_INLINE_CONFIG="network.protocols.tcp.nodelay.enable=true, network.protocols.tcp.quickack=true, monitor.log.level=info, monitor.log.file_path=/var/log/xlio.log"
        

            

            
export XLIO_RING_ALLOCATION_LOGIC=1
export XLIO_RING_TX_NUM=32
export XLIO_TX_BUFS=100000
export XLIO_CQ_DRAIN_INTERVAL=5
        

            

            
export XLIO_USE_NEW_CONFIG=1
        

            

            
{
    "performance": {
        "rings": {
           
            "tx": {
                "allocation_logic": "per_ip_address",
                "max_count": 32
            }
        },
        "buffers": {
            "tx": {
                "global_array_size": 100000
            }
        },
        "completion_queue": {
            "rx_drain_rate_nsec": 500000000
        }
    }
}
        

            

            
export XLIO_INLINE_CONFIG="performance.rings.allocation_logic=ring_per_ip, performance.rings.tx.max_count=32, performance.buffers.tx.global_array_size=100000, performance.cq.rx_drain_rate=5"
        

            

            
export XLIO_NGINX_WORKERS_NUM=8
export XLIO_DISTRIBUTE_CQ=1
export XLIO_TCP_NODELAY=1
        

            

            
export XLIO_USE_NEW_CONFIG=1
        

            

            
{
    "applications": {
        "nginx": {
            "workers_num": 8,
            "distribute_cq": true
        }
    },
    "network": {
        "protocols": {
            "tcp": {
                "nodelay": {
                    "enable": true
                }
            }
        }
    }
}
        

            

            
export XLIO_INLINE_CONFIG="applications.nginx.workers_num=8, applications.nginx.distribute_cq=true, network.protocols.tcp.nodelay.enable=true"
        

            

            
#!/usr/bin/env python3
import os
from functools import reduce
import json
import mappings # available in the repo at:src/core/config/mappings.py
 
def migrate_to_json():
    config = {}
    for key, env_var in mappings.config_mapping:
       if os.getenv(env_var):
           reduce(lambda d, k: d.setdefault(k, {}), keys[:-1], config)[keys[-1]] = os.getenv(env_var)
    return config
 
if __name__ == "__main__":
    config = migrate_to_json()
    if config:
        print(json.dumps(config, indent=2))
    else:
        print("No legacy configuration found to migrate")
        

            

            
 export XLIO_INLINE_CONFIG="monitor.log.level=debug, monitor.log.details=3"  
./your_application 2>&1 | grep -E "(Config|Parameter|Loading)"
        

            

            
# Legacy
unset XLIO_USE_NEW_CONFIG
export XLIO_TCP_NODELAY=1
./test_app
 
# New (default config)
export XLIO_USE_NEW_CONFIG=1
./test_app  
        

            

            
export XLIO_USE_NEW_CONFIG=1
export XLIO_CONFIG_FILE=/tmp/nodelay_conf.json
./test_app
        

            

            
export XLIO_INLINE_CONFIG="monitor.log.level=trace, monitor.log.details=3"
./your_application 2>&1 | grep -E "(Parameter|Config|Loaded)" | head -20
        

            

            
pip install jsonschema
jsonschema -i /etc/libxlio_config.json /etc/xlio_config_schema.json