Setting up network repository services

QMF for Workstation users can connect to shared repositories by using a centralized machine that runs the QMF network repository service.

About this task

To set up the QMF network repository service:

Procedure

  1. During the installation of QMF for Workstation, all *.jar files are placed in the API installation directory. Copy them to a required directory on the server machine.
  2. Copy the product license files to the directory on the server machine referred to in 1. The product license files are located under WEB-INF/config in QMF for WebSphere® or in the QMF for Workstation installation directory.
  3. Copy the repositories.xml and .bi.jdbc.drivers files to the directory on the server machine referred to in 1. These files are created at installation and populated when you configure repositories with repository connection information and set up JDBC drivers. If you use the QMF for Workstation administrator component, you find the files in the QMF for Workstation installation directory. If you use the QMF for WebSphere Administrator application you find the files in the QMF for WebSphere installation WEB-INF/config directory.
  4. To start the network repository service, run the following lines as one command: 
    java -cp CLASSPATH com.ibm.bi.qmf.core.repository.RepositoryService 
PORT_NUMBER PATH_TO_REPOSITORIES.XML
    Where:
    • CLASSPATH: Contains the location of the files that were copied to the directory on the server in step one.
    • PORT_NUMBER: The port on which the network repository service must operate. It can be any free TCP/IP port of your choosing.
    • PATH_TO_REPOSITORIES.XML: Provides the path containing the repositories.xml and .bi.jdbc.drivers files. If omitted, the files are assumed to be in the current directory.
    Sample command line (issue the following lines as one command): 
    java -cp "$qmf_jar_file_name.jar"
 com.ibm.bi.qmf.core.repository.RepositoryService
8889
  5. QMF for Workstation users connect to the network repository service by using the machine name and designated port as defined in the Network Repository connection information.