1. Map out where the following components will be installed.
a. VA2 Database (Repository): Installed on MSSQL, MSDE, Oracle, DB2 or MySql environment. MSDE is recommended. Step by step instructions for installing MSDE for VA2 available here.
b. Central Server - The VA2 Central Server host should be on a separate machine from the Siebel Gateway and Siebel servers. For testing and development purposes the Central server can be co-located with Siebel components, such as the Siebel Server. The Central Server must be installed on NT, Windows 2000, Windows XP or Windows 2003. If the Central Server does not have a static IP address, the host name should be used in configuration files. Hardware requirements at minimal; 1 300 mhz cpu and 128 MB of RAM. VA2 does use multiple processes, so multiple CPUs will be levarged if present on the host.
c. LSM: A Local Server Monitor will be installed on each Siebel Application Server.
d. Siebel SADMIN adminitrative account.
e. Administrative user: A domain account that has administrative rights to all monitored hosts should be created. The domain user account created for Siebel can usually be reused for these purposes. This administrative user account will be entered in the NT Services for the LSM and Central Service.
f. The administrative console (MMC) should be installed on the same host machine that is supporting the Central Service.
1. MMC 1.2+ Microsoft Management Console
a. MMC 2.+ comes default with Windows 2000, XP, Windows 2003
b. MMC 1.2 can be downloaded for NT 4.0
a. MSSQL Server 7 and 2000, and MSDE are supported. MSDE is free, and tested with VA2 in production environments. To minimize DBA work, MSDE is recommended. Step by step instructions for installing MSDE for VA2 availible here.
b. Oracle Oracle 8.1.5 have been tested any Oracle version will probably work.
1. If the link does not work, do a search in the download section of msdn.microsoft.com for WMI core. Find the download for NT.
You should have at this point downloaded VA2 (vadmin2.zip) and unzipped it into a temporary location. The paths for install below are referring to the unzip location. The folders in the unzipped directory should include:
i. Start Query Analyzer: log in with sa or equivalent user (capable of creating databases)
ii. Choose File > Open and browse to the \dbinstall\mssql\schmVadmin21.sql file.
iii. Press F5 to run the script. The output should indicate the database was successfully created.
1. Create a schema and users for a VA2 database
2. Create a table space for VA2. (Default 10mb will be sufficient. However, DB usage will vary depending on the number of events generated by the system and the Statistics collected for historical analysis.) Auto extend table spaces are recommended.
3. Run the scripts to create the tables for VA2, included int the \VA\centralservice\dbinstall\mydatabsetype\schmVadmin21.sql
You will want to install the MMC on the same machine targeted for the VA2 Central Service. You can also install it on any administrators PC. For each machine where you install the VA2 MMC, you will have to create an ODBC data source to connect to the VA2 Repository as noted in the Database section..
1. VA2 Console install
a. Run setup.exe in \va2snapinmmc directory. Walk through the Setup Steps to install the MMC console.
b. Access the console from Start > Programs > VA2 MMC.
c. A VA2 option box will pop up the first time you run it. You must enter a valid ODBC data source and user name and password for the console, created in the database section.
If you are able to successfully set the ODBC password and browse the folders in the VA2 MMC (there will be very little data), you are ready for the next step install the Central Service.
Before installing the Central Service, ensure that you have created the VA2 Repository Database, and you have created an ODBC data source on the VA2 Central Server machine as seen in the steps above.
a. CENTRALSERVER: Change this to be the Machine name of the host or a static IP address. It must match the values in future LSM config files.
b. The Ports can be left as default values unless there is some network/conflicting application reason you can not use those ports.
c. VODBC: Set to the ODBC name created in that connects to the VA2 repository.
d. USERNAME, PASSWORD: Username and password Created for the VA2 Repository database.
e. Set DBTYPE parameter. Valid entries include MSSQL, ORACLE, DB2 and MYSQL. (Default is MSSQL)
f. Save and close the vconfig.txt file.
The siebelsetup.exe application takes the information from your Siebel environment and imports it into VA2. Before you run it you should locate your siebns.dat. siebns.dat is found in the (\gtwysrvr\ADMIN) directory on your Siebel Gateway server. You will need you Siebel Username and Password for this step. This Username and Password must have administrative rights in Siebel. Use the SADMIN account - DO NOT USE THE SIEBEL DATABASE OWNER ACCOUNT.
siebelsetup.exe SIEBELUSERNAME SIEBELPASSWORD [optional: FULLPATHTOSIEBNS.DAT]
LSM: A Local Service Monitor must be installed on each Siebel Server host (or other host monitored by Siebel). It is responsible for communicating with Siebel, tracking performance and monitoring log files. It sends its information back to the VA2 repository and the VA2 Central Service for analysis.
1. Create LSM ODBC datasource to connect to the VA2 repository.
2. Run the \lsm\v2lsmsetup.exe for every Siebel Application server. It will install the Local Server Monitor Service. Edit the vconfig.txt file below before starting the LSM agent.
3. Edit vconfig.txt (c:\program files\VA2\lsm\bin). This file is similar to the Central Servers vconfig.txt. For the LSM, the IP address and Port that the Central Server is running on must be entered. The ODBC data source created in step 2 must be entered. Most of the parameters wont need to be changed, but make sure you change the CENTRALSERVER parameter to equal the host name or static IP address of the VA2 Central Server. Also, the ODBC username and password should be set.
4. Start the LSM agent. Open the log files in c:\program files\VA2\lsm\log and look for obvious error messages.
At this point, VA2 should be collecting Siebel information.
Verify the Siebel and VA2 objects have been created
correctly. Open the VA2 MMC. You should see 2 Software management
systems, including a Virtual Administrator 2 system, and Software Management
System representing your Siebel system. Under each software management system
the objects can be expanded.
The most common install problem is not useing the correct Siebel username and password. The Siebel username should be a SADMIN account, or any administrative account with access to the Siebel Server Administration screens. This Username and Password must have administrative rights in Siebel. Use the SADMIN account - DO NOT USE THE SIEBEL DATABASE OWNER ACCOUNT. If you did not enter a Siebel Username and Password with siebelsetup.exe, need to verify it, or did not enter it correctly, see the setting siebel password guide.
You may want to refer to the MMC verification steps. It has a graphical version of the instructions below. Note that the problem with the Snapin.dll should have been corrected with the current MMC version. MMC verification
After installation of the VA2 components, several important steps need be taken before the system is operational. You may want to refer to the MMC verification steps before proceeding further: MMC verification
1. ODBC Datasources VA2 can access any ODBC data source. The requirement for that is the ODBC Data source is present on the VA2 Central Server machine. VA2 siebelsetup imports an ODBC name to connect to your Siebel environment. For this reason, if your VA2 Central Server Machine is not the same machine as your Siebel Server, you should recreate an ODBC data source on the VA2 Central Server to connect to your Siebel environment. To find out what name of ODBC to use, edit the siebeldata object in VA2. If the MMC console is running on the Central Server, you can verify the ODBC datasource is setup correctly.
2. If you are using Oracle, read the Oracle notes below. Note, when creating a new ODBC datasource, the VA2 central server should be restarted.
See the documentation and tutorials on the documentation page to begin setting up your VA2 environment.
1. The ODBC Driver Siebel uses for Oracle systems is provided by Merant Corporation. The license is limited to Siebel and can not be used by VA2. Siebelsetup.exe imports the ODBC definition into the VA2 repository. You should create a new ODBC Data source that connects to your Oracle Siebel environment on the Central Server machine. The Microsoft driver for Oracle works, as well Oracle ODBC driver provided by an Oracle client. Once establishing an ODBC data source using a useable driver, change the Data source imported to use the new ODBC driver.