Importing BIAR file using BICONFIG utility
CA Business Intelligence also includes BIConfig, a utility that can be used to add, modify, delete,
and otherwise affect various BusinessObjects objects. BIConfig is generally used during a CA
product’s installation or maintenance process and is run in a batch mode.
Install BIConfig Utility
The BiConfig utility takes inputs from the command line and an XML file that describes the
configuration updates to be performed on the Business Objects environment.
To run the BiConfig utility
1. Create the directory c:\BIConfig on your local machine where BOXI is installed.
2. Copy and Unzip the contents of the BIConfig folder from the Business Intelligence
Embedding Kit
[<ServiceDeskManager_Installation_CD>\ca_tps.nt\CABO\biconfig.zip] to C:\BIConfig.
3. Add "JAVA_HOME" user environment variable and set to the path of JRE folder delivered by
CA as below (If BOXI is installed in C: drive):
"C:\PROGRA~1\CA\SC\CommonReporting\jre\"
4. Add "C:\PROGRA~1\CA\SC\CommonReporting\jre\bin\" to "%PATH%" system variable.
Configure BIConfig Utility
• Copy “xml_biar_import.xml” file from “binconfig\samples” utility folder to “binconfig”
folder.
• Edit “xml_biar_import.xml” file and specify necessary values for path of the biar file
located, DB Username, DB password, System DSN (data source name) specified under
Windows Administrative Tools -> Data Sources (ODBC drivers). Below is an example
on a system where BOXI are installed:
The BIConfig utility is run from the command line, can be invoked silently, and requires the JRE.
Invoke BIConfig by executing the BIConfig.bat file using the syntax and example shown below.
Log messages are written to the BIConfig.log file.
Syntax:
biconfig.bat -h "<BOXI-hostname>" –u "<BOXI username>" –p "<BOXI pwd>" -f
xml_biar_import.xml
Example:
C:\biconfig>biconfig.bat -h "itcse-r121" –u "Administrator" –p "BOXI1" -f
xml_biar_import.xml
Help on BIConfig command:
BIConfig -h host [-n port] -u username [-p password] [-s secEnterprise | secLDAP |
secWindowsNT | secWinAD] –f “XML-input-file” [-i “BIAR-file” | -if “BIAR-file”] [--help]
-h name
(Required) Specifies the BusinessObjects Central Management Server host.
-n port
(Optional) Specifies the BusinessObjects Central Management Server port.
Default: 6400
-u username
(Required) Specifies the BusinessObjects user name for log in.
-p password
(Optional) Specifies the password for the BusinessObjects user specified in -u.
secEnterprise
The user name specified in –u should be authenticated to BusinessObjects using Enterprise
security (BusinessObjects validates against its internal user store).
secLDAP
The user name specified in –u should be authenticated to BusinessObjects using LDAP security
(BusinessObjects validates against a mapped LDAP user store).
secWindowsNT
The user name specified in –u should be authenticated to BusinessObjects using Windows NT
security (BusinessObjects validates against a mapped Microsoft Windows NT user store).
secWindowsAD
The user name specified in –u should be authenticated to BusinessObjects using Windows AD
security (BusinessObjects validates against a mapped Microsoft Windows AD user store).
Default: Empty string (blank)
-s secEnterprise | secLDAP | secWindowsNT | secWinAD
(Optional) Specifies the BusinessObjects security authentication to be used to authenticate the
user specified in -u.
Default: secEnterprise
-f “XML-input-file”
(Required) Specifies the path and name of the XML file to be used as the input file to BIConfig.
If the path is not specified, the BIConfig folder will be searched for the file.
-i “BIAR-file” | -if “BIAR-file”
(Optional) Specifies the path and name of the BIAR file to be imported intoBusinessObjects. If
the path is not specified, the BIConfig folder will be searched for the file. The –if parameter will
import the BIAR file first, before processing the –f XML-input-file. The –i parameter will
process the
–f XML-input-file first then import the BIAR file. This order is important if the XML-input-file
contains settings for the objects referenced in the BIAR file. In this case, you should use the –if
parameter.
--help
(Optional) Displays the invocation syntax for BIConfig. This parameter should be used in
isolation.
