Configuration

The configuration comprises the factory and configuration interfaces described above. Those interfaces must be instantiated before the client adapters are configured, enabled and unlocked.

The recommended way to instantiate the configuration interfaces is to use the config.ini file that is used by Fulfillment Provisioning. Such a configuration file may look like this:

# 
# server configuration interfaces
#

[ ca.tcp.server.config : provca::Config ]
name                      = ca.tcp.server.config
sessionManagerFactoryName = ca.tcp.server.smf
sessionFactoryName        = ca.tcp.server.sf
orderQueueFactoryName     = ca.tcp.server.oqf
recvFlowConfigName        = ca.tcp.server.rfc

[ ca.tcp.server.smf : provca::SessionManagerFactory ]
name                      = ca.tcp.server.smf
numberOfSessions          = 10

[ ca.tcp.server.sf : provca::SessionFactory ]
name                      = ca.tcp.server.sf
reserveMode               = SkipReserve
errorMode                 = CancelOnError

[ ca.tcp.server.oqf : provca::OrderQueueFactory ]
name                      = ca.tcp.server.oqf
controllerName            = fc

[ ca.tcp.server.rfc : provca::FlowProxyConfig ]
name                      = ca.tcp.server.rfc
flowName                  = conf/ca_tcp_server_rfc.xml
entryPointName            = ca_tcp_server_rfc_framer

#
# client configuration interfaces
#

[ ca.tcp.client.config : provca::Config ]
name                      = ca.tcp.client.config
sessionManagerFactoryName = ca.tcp.client.smf
sessionFactoryName        = ca.tcp.client.sf
orderQueueFactoryName     = ca.tcp.client.oqf
sendFlowConfigName        = ca.tcp.client.sfc

[ ca.tcp.client.smf : provca::SessionManagerFactory ]
name                      = ca.tcp.client.smf
numberOfSessions          = 10

[ ca.tcp.client.sf : provca::SessionFactory ]
name                      = ca.tcp.client.sf
reserveMode               = SkipReserve
errorMode                 = CancelOnError

[ ca.tcp.client.oqf : provca::OrderQueueFactory ]
name                      = ca.tcp.client.oqf
controllerName            = fc

[ ca.tcp.client.sfc : provca::FlowProxyConfig ]
name                      = ca.tcp.client.sfc
flowName                  = conf/ca_tcp_client_sfc.xml
entryPointName            = ca_tcp_client_sfc_formatter
    

Once the configuration interfaces are instantiated, client adapters must be configured. This configuration process is usually done using a provadmin command like:

provadmin configure ca nodename=[Fulfillment Provisioning-node] caname=[client-adapter-name] configname=[config-name]

for example:

provadmin configure ca nodename=MyNode caname=ca.tcp.server configname=ca.tcp.server.config