The QWFIX Repository Server configuration tool is installed with the repository server Windows service. The configuration tool is automatically launched at the last step of the installation process.
A repository storage is a local directory resides on the host machine of the QWFIX Repository Server service.
The QWFIX Repository Server also opens a TCP port to provide services to repository clients.
The QWFIX Repository Server employs role based security. Clients is requires to provide valid user name / password to pass authentication process. Upon client request, the QWFIX Repository Server authorizes the proper access permissions to different resources in the repository storage based on the "access control list" configuration on the server side.
The QWFIX Repository Server configuration tool can only be used to configure location of the repository storage, server port, and administrator's user ID and password.
Once the QWFIX Repository Server is configured with the Repository Server configuration tool. User can use FIX Enterprise Manager to connect to Repository Server with a single server URI (which contains server IP/port and administrator's user ID / password). The FIX Enterprise Manager can read from or write to the repository and assign permissions (access control list) to any resource in the repository.
Note: Currently the role based security is not available through GUI. Only the user ID "administrator" is available.
It's suggested that the FIX Enterprise Manager be the only client that has write permissions to the QWFIX Repository Server. Other clients should only be given read-only permissions.
Once a new QWFIX Repository Server is installed. It needs to be configured for the first time. The configuration includes setting up a server TCP port number, administrator password and the location of local repository storage.
The QWFIX Repository Server configuration tool is always installed with the QWFIX Repository Server. To launch the configuration tool, in Windows Start menu, choose "All Programs" -> "QWFIX" -> "Repository Server" -> "Repository Server Manager".
The configuration tool will restart the server if any modification of configuration is applied.
The first step of the set up process is to mount a repository. If this is the first time the repository server is installed, the default repository will be mounted. The default repository comes with the installation package, and it contains some standard FIX schemas as well as other configurations used as tutorials.
REMEMBER: The super user ID for default repository is "Administrator"; there is no password (empty string). Password can be changed using "Repository Server Manager".
Sometimes there is a need to mount an exisiting repository to a new QWFIX Repository Server. For example, users may need to migrate the QWFIX Repository Server to a new machine while all exisiting data on the old repository need to be kept. It can be accomplished by simply copying the entire folder (directory) that represents the repository storage from the old machine to the new machine and mounting the copied storage to the new instance of QWFIX Repository Server.
To mount a repository click "Browse" button of the "Repository". Then choose a directory in the dialog box. If the directory points to an existing repository, the existing repository will be mounted; otherwise, the default repository will be copied to the directory to create a new repository then the new repository will be mounted.
QWFIX Repository Server write event logs into a file instead of the Windows system event log. The log implementation of QWFIX system is much more efficient. User needs to provide a directory to store the log files.
The configuration checks %WINDOWS%\system32\etc\drivers\services file for conflicts in TCP ports. Once the TCP port is setup, an entry will be written to the services file. Note that entry will be removed during uninstall process. Do not manually modify that entry in the services file. For more information about the services file, please refer to NetworkService class.
The default TCP port is 60000. The TCP port can be reset using the configuration tool.
The Repository Server can use system memory to cache most recently used items. The size of the cache (in megabytes) is configurable.
Note: It's recommended that repository server runs on a 64 bit machine with at least 8 GB of system memory to serve hundreds of intra-day processes for a large organization.
"Administrator" is a built in account name for super user. That user name can not be deleted. Only the password can be changed. Use configuration tool to change the password.
The "Repository Server" is a Windows Service. After the service is installed and properly configured, the service should automatically start when WIndows starts. However, the installer and configuration tool will not start the service for the first time after the installation. Users need to go to "Control Panel" -> "Administrative Tools" -> "Service" and manually start the "QWRepositoryServer" service (only for the first time).