Unattended Installation of Webtrends Software
Explains how to prepare for and perform an unattended installation. It also provides syntax and code examples that show how to install various Webtrends Analytics components.
In an unattended installation, you issue a single command that includes all required installation parameters, rather than interact with the installation user interface in a step-by-step process. Follow these guidelines for unattended installations:
- Unattended installation procedures cannot be used for upgrading.
- Perform an unattended installation only if you are familiar with Webtrends Analytics and your local network.
- Perform the unattended installation locally from the computer where you want Webtrends installed.
- Install Webtrends on a remote computer with third-party software that allows you to execute programs on remote systems.
To ensure optimum performance, Webtrends Analytics should be installed on a dedicated host. However, you can install Webtrends components on different computers, and you don’t have to install all of the components or subcomponents (but some are required).
- Before performing the installation, make sure the computers conform to the System Requirements for Analytics and Visitor Data Mart.
- Before performing the installation, review documentation that will help you prepare for your installation Preparing to Install Webtrends Analytics and, if applicable, Preparing to Install Webtrends Visitor Data Mart.
- Make sure you have local administrator rights on the installation computer(s).
- After you install the prerequisites, install SQL Server 2008 Express, Standard, or Enterprise Edition.
- If you have a previous version of Webtrends installed, you need to follow the uninstall instructions. If you have an earlier version of Webtrends Analytics installed, uninstall that version using Windows Add or Remove Programs utility before proceeding.
- Review the information in Prerequisites for Webtrends Components to find out which prerequisites and Microsoft Installer (MSI) files that you need to install, as well as the order in which you must install the components.
Prerequisites for Webtrends Components
| Component | Prerequisites | Prerequisite file names |
|---|---|---|
| Webtrends Master Database |
|
|
| Reporting and Administration |
|
|
| Standard Analysis Engine |
|
|
| Visitor Data Mart |
|
|
| GeoTrends Data File |
|
|
| Insight Dashboard |
|
|
| Data Extraction API |
|
|
| Realtime Engine |
|
|
| Insight Alerts |
|
Installing the Prerequisites
Prerequisites are third party software programs that need to be installed before you install Webtrends Analytics. You need to install prerequisites before you install the Webtrends Analytics components that you want on your computer. Only install the prerequisites that you need. If you do not have one or more prerequisite programs, you can find them on the Webtrends software installation DVD in the MSI directory. For example, you can go to E:\MSI\prerequisite name.msi to find a prerequisite. After you install all prerequisites, you can install Microsoft SQL Server 2008 Express, Standard, or Enterprise Edition.
Performing an Unattended Installation of Webtrends
- Review the command line syntax:
msiexec.exe /i “E:\MSI\Webtrends Scheduler Agent.msi” /q [OPTIONS]
where E:\ represents the disk drive that contains the Webtrends DVD-ROM and [OPTIONS] are the MSI Public Properties for the components you want to install. For more information about [OPTIONS], see “Using MSI Public Property Parameters”.
Note: Webtrends currently supports three Microsoft Installer (MSI) user interface options: /q, /qb and /qn. These options set the User Interface level. The /q and /qn options turn off the user interface. A /qb option uses a basic user interface.Optionally, you can include a command that logs installation information for troubleshooting. For example:
msiexec.exe /i “E:\MSI\Webtrends Scheduler Agent.msi” /l*v “C:\ Webtrends Scheduler Agent.log”
- Review the information in "Installing Individual Subcomponents". This information shows you how to set the ADDLOCAL properties so you can install one or more subcomponents.
- Install Webtrends MSI files for the components you want in the following
order. The .msi files are provided in the Webtrends
Installation Package and are located in the
Webtrends_Installation_Directory\MSI folder. A
syntax example follows each component.
- Master Database.msi
msiexec /i "E:\MSI\Webtrends Master Database.msi" /qb! /l*v "C:\Program Files\Webtrends\logs\install\Webtrends Master Database.log" INSTALLDIR="C:\Program Files\Webtrends" MASTER_USER=sa SCHED_USER=sa MASTER_PASS=abcd SCHED_PASS=abcd MASTER_HOST=myComputer SCHED_HOST=myComputer DB_TYPE=SQLServer SERVICEACCT=myDomain\myUser SERVICEPASS=myPassword
- Scheduler Agent.msi
msiexec /i "E:\MSI\Webtrends Scheduler Agent.msi" /qb! /l*v "C:\Program Files\Webtrends\logs\install\Webtrends Scheduler Agent.log" INSTALLDIR="C:\Program Files\Webtrends" MASTER_USER=dbUsername MASTER_PASS=dbPassword MASTER_HOST=myComputer DB_TYPE=SQLServer SERVICEACCT=myDomain\myUser SERVICEPASS=myPassword ADDLOCAL=ALL
- System Repository.msi
msiexec /i "E:\MSI\Webtrends System Repository.msi" /qb! /l*v "C:\Program Files\Webtrends\logs\install\Webtrends System Repository.log" INSTALLDIR="C:\Program Files\Webtrends" MASTER_USER=dbUsername MASTER_PASS=dbPassword MASTER_HOST=myComputer DB_TYPE=SQLServer REPORTS_DIR="\\myComputer\myShare\reports" FASTTRENDS_DIR="\\myComputer\myShare\analysis" CONFIG_DIR="\\myComputer\myShare\config" BACKUP_DIR="\\myComputer\myShare\backup" ADDLOCAL=ALL
- Webtrends Analysis.msi
msiexec /i "E:\MSI\Webtrends Analysis.msi" /qb! /l*v "C:\Program Files\Webtrends\logs\install\Webtrends Analysis.log" INSTALLDIR="C:\Program Files\Webtrends" MASTER_USER=dbUsername SCHED_USER=dbUsername MASTER_PASS=dbPassword SCHED_PASS=dbPassword MASTER_HOST=myComputer SCHED_HOST=myComputer DB_TYPE=SQLServer SERVICEACCT=myDomain\myUser SERVICEPASS=myPassword RT_ANALSRC="\\myComputer\myShare\expressanalysis\src" RT_REPORTS="\\myComputer\myShare\expressanalysis\reports" ADDLOCAL=ASU Realtime
- Webtrends Visitor Data Mart.msi and Webtrends Management
Application.msi
msiexec /i "E:\MSI\Webtrends Visitor Data Mart.msi" /qb! /l*v "C:\Program Files\Webtrends\logs\install\Webtrends Visitor Data MartC:\Documents and Settings\pondj\Local Settings\Temp\FRM52ED.tmp.log" INSTALLDIR="C:\Program Files\Webtrends" MASTER_USER=dbUser SCHED_USER=dbUser MASTER_PASS=dbPassword SCHED_PASS=dbPassword MASTER_HOST=myComputer SCHED_HOST=myComputer DB_TYPE=SQLServer SERVICEACCT=myDomain\myUser SERVICEPASS=myPassword EX_ATTRIB_HOST=myComputer EX_ATTRIB_USER=myUser EX_ATTRIB_PASS=myPassword EX_ATTRIB_DATADIR="d:\my MDF data path" EX_ATTRIB_LOGDIR="d:\my LDF log path" ADDLOCAL=ALL
msiexec /i “E:\MSI\Webtrends Management Application.msi" /qb! /l*v "C:\Program Files\Webtrends\logs\install\Management Application.log" INSTALLDIR="C:\Program Files\Webtrends\" ADMINUSER_DOMAIN=MyDomain ADMINUSER_USERNAME=AdminUsername ADMINUSER_PASSWORD=AdminPassword ADDLOCAL=ALL
- UI Server Modules.msi
msiexec /i “E:\MSI\Webtrends UI Server Modules.msi" /qb! /l*v "C:\Program Files\Webtrends\logs\install\UI Server Modules.log" INSTALLDIR="C:\Program Files\Webtrends\" ADMINUSER_DOMAIN=MyDomain ADMINUSER_USERNAME=AdminUsername ADMINUSER_PASSWORD=AdminPassword ADDLOCAL=ALL
- Webtrends GeoTrends.msi
msiexec.exe /i "E:\MSIV12\Webtrends GeoTrends.msi" /qb! /l*v "c:\Program Files\Webtrends\logs\install\GeoTrends Server.log" INSTALLDIR="C:\Program Files\Webtrends" MASTER_USER=dbUsername MASTER_PASS=dbPassword MASTER_INSTANCE="" MASTER_HOST=myComputer SCHED_USER=dbUsername SCHED_PASS=dbPassword SCHED_HOST=myComputer SCHED_INSTANCE="databaseInstance" SCHED_PORT="databasePort" DB_TYPE=SQLServer GEOTRENDS_DAT="c:\GeoTrends.8.200809.dat" ADDLOCAL=ALL SYSTEMSERVICEACCT=myDomainAccount SYSTEMSERVICEPASS=myPassword REBOOT=ReallySuppress
- Webtrends Main Application.msi
msiexec /i "E:\MSI\Webtrends Main Application.msi" /qb! /l*v "C:\Program Files\Webtrends\logs\install\Webtrends Main Application.log" INSTALLDIR="C:\Program Files\Webtrends" MASTER_USER=dbUsername MASTER_PASS=dbPassword MASTER_HOST=myComputer DB_TYPE=SQLServer SERVICEACCT=myDomain\myUser SERVICEPASS=myPassword UI_PORT=80 UI_DESC="My Description" UI_URL="https:\\myComputer:80" IPADDRESS=10.10.10.10 ADDLOCAL=ALL
- Webtrends Data Scheduler Service.msi
msiexec.exe /i "e:\msi\Webtrends Data Scheduler Service.msi" /qb! /l*v "C:\Program Files\Webtrends\logs\install\Data Scheduler Service.log" INSTALLDIR="C:\Program Files\Webtrends" STANDALONE="false" MASTER_HOST="myComputer" MASTER_INSTANCE="WTSYSTEMDB" MASTER_PORT="" CACHE_ENABLED="false" CACHE_PROVIDER="Memcached" CACHE_NAME="DX2" CACHE_HOSTS="" SERVICEACCT=myDomain\myUser SERVICEPASS=MyPassword IGNORE_SYSTEMCHECK=TRUE REBOOT=ReallySuppress
- Master Database.msi
- If you installed the UI Server component, you need to stop and start the
wtui service:
- NET STOP wtui
- NET START wtui
Installing Individual Subcomponents
You can install individual subcomponents for the Reporting and Administration UI, Analysis Engine, and Visitor Data Mart by setting the ADDLOCAL property. The ADDLOCAL property lists subcomponents separated by commas in a command-line installation, and are to be installed locally. If you want to install all of the subcomponents, you need to set the ADDLOCAL property to ALL by specifying
ADDLOCAL=ALL
in the installation command. These rules apply to the ADDLOCAL=ALL property:
- Subcomponents are case sensitive.
- Specify multiple features using a comma-delimited list with no spaces between the subcomponents
- If an MSI file requires an ADDLOCAL property when you install the file, you need to specify ADDLOCAL=ALL, unless the MSI file installs subcomponents.
Specifying Reporting and Administration UI Subcomponents (Webtrends Main Application.msi)
You can specify one or more of the following subcomponents for the Reporting and Administration UI:
- MC (UI Server): Installs the Reporting and Administration UI component that serves reports to Webtrends users.
- ODRC (Report Cache Server): Installs the Reporting and Administration UI component that stores reports requested by Webtrends users.
- RDE (Report Exporter): Installs the Reporting and Administration UI component that converts HTML reports to other formats.
- Tools: Installs Administrative tools including utilities for backing up Webtrends and cleaning up deleted profiles.
- Mail (Email Notification Service): Installs the Email Notification Service
For example, to use all of these options:
ADDLOCAL=MC,ODRC,RDE,Tools,Mail
Specifying Analysis Engine Subcomponents (Webtrends Analysis.msi)
You can specify one or more of the following subcomponents for the Analysis Engine:
- ASU (Standard Analysis Engine): Installs the Standard Analysis Engine.
- Realtime (Express Analysis Engine): Installs the Express Analysis Engine.
For example, to use both of these options:
ADDLOCAL=ASU,Realtime
Specifying Visitor Data Mart Subcomponents (Webtrends Visitor Data Mart.msi)
You can specify one or more of the following subcomponents for Visitor Data Mart:
- EventDBServerLoader (Event Database Server/Loader): Analyzes SmartSource Data Collector log files and moves processed data into the Visitor Data Mart.
- EventDBSplitter (Log File Management): Installs the Event Database Splitter, which is required for the Webtrends Visitor Data Mart.
- ExtendedAttribDB (Configuration Database): Installs the Extended Attributes database, which is required for the Webtrends Visitor Data Mart. Make sure you only install one instance of the Extended Attributes Database per distributed architecture.
For example, to use all of these options:
ADDLOCAL=EventDBServerLoader,EventDBSplitter,ExtendedAttribDB
Installing Subcomponents After You Install the Component
You can install subcomponents after the component has been installed by installing the component and specifying the new subcomponent as a parameter for ADDLOCAL. For example, if you want to install the Report Cache Server after you have installed the Reporting and Administration UI, you can type
ADDLOCAL=ODRC
in the installation command.
Performing an Unattended Uninstallation
When you perform an unattended uninstallation of Webtrends Analytics 8.7d or later, you must uninstall the components in a certain order. If you no longer have the Webtrends Analytics installation DVD-ROM, please contact support for the MSI files or product codes that you can use when uninstalling.
- Uninstall Webtrends Data Scheduler Service:
msiexec /x "E:\MSI\Webtrends Data Scheduler Service.msi" /qb! /l*v "C:\Program Files\Webtrends\logs\uninstall\Webtrends Data Scheduler Service.log"
- Uninstall UI Server/Main Application:
msiexec /x "E:\MSI\Webtrends Main Application.msi" /qb! /l*v "C:\Program Files\Webtrends\logs\uninstall\Webtrends Main Application Uninstall.log"
- Uninstall GeoTrends
msiexec /x "E:\MSI\Webtrends GeoTrends.msi" /qb! /l*v "C:\Program Files\Webtrends\logs\uninstall\Webtrends GeoTrends Uninstall.log"
- Uninstall UI Server Modules:
msiexec /x "E:\MSI\Webtrends UI Server Modules.msi" /qb! /l*v "C:\Program Files\Webtrends\logs\uninstall\Webtrends UI Server Modules Uninstall.log"
- Uninstall Management Application:
msiexec /x "E:\MSI\Webtrends Management Application.msi" /qb! /l*v "C:\Program Files\Webtrends\logs\uninstall\Webtrends Management Application Uninstall.log"
- Uninstall Visitor Data Mart:
msiexec /x "E:\MSI\Webtrends Visitor Data Mart.msi" /qb! /l*v "C:\Program Files\Webtrends\logs\uninstall\Webtrends Visitor Data Mart.log"
- Uninstall Analysis Engine:
msiexec /x "E:\MSI\Webtrends Analysis.msi" /qb! /l*v "C:\Program Files\Webtrends\logs\uninstall\Webtrends Analysis.log"
- Uninstall Webtrends System Repository:
msiexec /x "E:\MSI\Webtrends System Repository.msi" /qb! /l*v "C:\Program Files\Webtrends\logs\uninstall\Webtrends System Repository.log"
- Uninstall Master Database:
msiexec /x "E:\MSI\Webtrends System Database.msi" /qb! /l*v "C:\Program Files\Webtrends\logs\uninstall\Webtrends Master Database Uninstall.log" DROP_MASTER_DB=TRUE
- Uninstall Scheduler Agent:
msiexec /x "E:\MSI\Webtrends Scheduler Agent.msi" /qb! /l*v "C:\Program Files\Webtrends\logs\Webtrends Scheduler Agent.log"