Setting Up Vanguard for Production
You’re here because you’re interested in running a Vanguard Production System
on your own. If that’s the case and you have not yet contacted ▨▨▨▨▨ ▨▨▨▨▨
▨▨▨▨@us.ibm.com), please do that first to make arrangements.
If you have questions or concerns during installation, you can contact
To update an existing installation, see the updates page.
You can install a complete Vanguard system on one computer or distribute the load across computers. These instructions are organized and written such that you can use them in either scenario.
To decide which setup is right for you, review the system requirements below and assess how the hardware you have available can handle your organization’s build and test needs.
If you distribute across computers, each of the following groups of components can exist on its own server:
- IDWB build, accessibility and link checking (tests output folders).
- IEHS, IEHSc, and KC can exist in any combination on any number of servers. When a user requests an individual infocenter or KC collection, you (the admin) can specify which server will host it.
- NL package return processing.
Except for the database server, each of the other servers requires an instance of the Vanguard web application and its software dependencies. The Vanguard web application handles the communication between the server components.
It is recommended that you install the system on fresh clean computers. The Vanguard
system has many
software dependencies, some of which have PATH entries, and you don’t want some things
colliding with others (for example, CMVC has a
file command and there is
also a Unix
file command, which might have been installed with MKSTools or Cygwin).
If you don’t have a fresh computer available, read through these instructions first
to assess if there might be conflicts. For example, you’ll probably want Vanguard to
run on the default web server port 80; Jenkins runs on port 8080.
As you install, you might wonder why the PHP, Apache, and MySQL versions are 32-bit. Vanguard is built on CakePHP Version 1.3, an old version which is not compatible with PHP later than versions 5.3.x. And, well, we haven’t found 64-bit pre-built binaries of PHP 5.3.x, Apache, and MySQL that play together nicely.
A rough estimate of what would be required for a standalone system with ~5 projects (200 total build items), 1 KC instance with 5 collections, 5 review ICs, 5 translation and returns projects, and an active queue size of 5 jobs:
- 64-bit Windows 7
- 4 processor cores
- 8 GB RAM
- 100 GB total disk space (including OS and required apps)
To give a general recommendation for a heavy workload production server, it might be overkill, but this is what the ▨▨▨ team provisioned for an all-in-one standalone Vanguard server (that would have enough to backup the primary production system):
- 64-bit Windows Server 2008 R2 Enterprise
- Xeon 2.7 GHz processors: 2 x 16 core processors for a total of 32 cores
- 192 GB RAM
- 500 GB available RAID 5 disk space
Current Vanguard primary distributed production system
To give you an idea of what resources could be taken up by a large production system, here’s the current resource breakdown for the Vanguard system used by our group:
64-bit Windows Server 2008 R2 Enterprise
CPU: 10 concurrent IDWB builds uses 100% of an 8 core Xeon 2.7 GHz processor, then add hits from KC, IC, and MySQL
Memory and disk space for the Vanguard web application are minimal, but total space depends on a number of factors:
- Each IC uses about 200 MB.
- Our KC instance uses about 2.5 GB to host about 30 collections x ~3 versions each
- 10 concurrent IDWB builds take about 2 GB
- Our MySQL instance takes up about 1.5 GB
Disk space: Total disk usage on all our servers (not including OS and app installations):
- 30 x ~3 KC collections (16 GB)
- 397 ICs (16 GB)
- 291 project directories (130 GB)
- The MySQL database for all those projects, including IDWB build logs (45 GB)
The load is distributed across multiple servers:
- Server 1: All IDWB builds, accessibility and link tests, some IEHS and IEHSc infocenters. 90% of the users hit this primary server for all Vanguard web application work (creating and maintaining projects, infocenters, etc.).
- Server 2: Hosts KC and the majority of IEHS and IEHSc infocenters
- Server 3: Hosts the master database and handles NL package return processing
- Server 4: A backup server that hosts an actively slave-replicated database and IDWB builds should the primary server become bogged down or go offline
Prepare for Installation
Ready? Let’s get started. :O) Follow these steps on each computer where you will install Vanguard or MySQL server.
Create an Administrator user on the server. Log in with that user and use it for every step of the installation.
During this set up, commands need to be entered from an Administrator command window. To prevent from having to enter Cmd-Shift-Enter every time you open a command window, you can set up your default command prompt to always open as Administrator. If you want to do this:
In File Explorer, right-click on your Admin user’s Command Prompt shortcut in:
Click Advanced on the Shortcut tab, check Run as administrator, and save.
Download and install Mozilla Firefox in its default location.
Open this page in Firefox to access remaining links.
Work with your UT/Design L1 support group to request a license for the server host names that will use ID Workbench (those servers that will download from IDCMS and build or create pakpaks). If you do that now, you can continue with installation while you wait.
Create the folder
C:\Apps, where most of the software will be installed. The idea is to keep the PATH environment variable as short as possible for command-line apps, since so many apps will be installed and the ID Workbench has a limit on the length of the PATH environment variable. Also, by using the exact same paths specified in this document, you can cut and paste most of the examples, and it makes maintaining and debugging systems a bit easier.
As you follow along, if you want to easily cut and paste certain example code snippets, set a
vanguard_setupenvironment variable to this folder. For example:
setx vanguard_setup C:\vanguard_setup
Because we won’t use setx to set the PATH, whenever the instructions say to append to the PATH environment variable, you can quickly access the system properties window by typing
sysdm.cplat a command prompt or the Start Menu search box.
Download and unzip vanguard_setup.zip to become your
Choose values for the following names and save them somewhere.
Computer Name Value Vanguard Server Admin user Vanguard Server Admin password Database MySQL root user password Database &
MySQL vanguard user password
Install Helpful Software
This software is optional, but recommended for each Vangaurd computer, including the database server.
Notepad++ - better than Notepad
C:\Apps\Notepad++. Otherwise, accept the default installation settings.
7-Zip 64-bit beta - better than Windows archive folders
C:\Apps\7-Zip. On the Custom Setup page, click Browse to change the directory. Otherwise, accept the default instllation options.
Process Hacker - better than Windows Task Manager, especially when you need to determine which IEHS instance is which.
- Log into iRAM, Search for Process Hacker (G2GO - IUA - Process Hacker)
- The installer is in the binaries folder of the downloaded zip.
- It’s a GUI application only, so you can accept the default location.
- Might as well select a Full Installation.
- Creating a desktop icon for all users is helpful.
- No need to select other options. It’s useful enough as an application that you manually open only when needed. Sometimes Task Manager is useful rather than replacing it with Process Hacker, especially if you’re not yet used to its interface.
HeidiSQL - Highly recommended for database maintenance, whether from the local database server or remotely.
- Under continuous development, get the latest version by clicking Installer.
- You can accept the defaults, including the path since it’s a GUI app.
Install the Database Server
In a standalone environment, you install MySQL and the Vanguard database on the same computer as Vanguard and everything else.
Or, you can choose install the database on a separate computer. If you do, then MySQL need only be installed on that computer and none of the other Vanguard computers. Likewise, Vanguard need not be installed on the database server. Note, however, that the database server and the web application server that users will access most often (for builds, tests, and records management) should be close to each other on the network for faster response times. The web application sometimes makes many database hits per page request.
.NET Framework 4.0 - When the popup opens, choose No thanks, continue.
- MySQL Community Server 5.5.38 32-bit (from MariaDB archives)
- Choose Custom. Accept the default selections, but change the path
- When the installation wizard finishes, walk through the advertisement wizard, and then launch the MySQL Server Instance Configuration Wizard.
- Detailed Configuration. Next
- Server Machine, if you expect to support over 50 build projects. Next
- Transactional Database Only. (We use InnoDB.) Next, Next
- Manual Setting with 100 concurrent connections. Next, Next
- Standard character set (Latin1) for the default. Next
- Install as service, and check include Bin in path. Next
- Enter a root password. Recommend not enabling remote root access or an anonymous account. Next, Execute
- Choose Custom. Accept the default selections, but change the path to
Create a user and database both named
▨▨▨▨, and grant the user full access to the database. First start the MySQL CLI:
mysql -u root -p <enter your mysql root user password>
mysql>prompt, enter each of these commands:
CREATE DATABASE `▨▨▨▨`; CREATE USER '▨▨▨▨'@'%' IDENTIFIED BY '<your chosen password>'; GRANT ALL PRIVILEGES ON `▨▨▨▨`.* TO '▨▨▨▨'@'%' WITH GRANT OPTION; FLUSH PRIVILEGES; \q
Strawberry Perl - Get the latest recommended version. 64-bit is okay for perl. Accept the default folder of
Perl is used in the next step for configuration. If you are not installing vanguard on the same computer as your database, then proceed to the next step.
Otherwise, initialize CPAN, and install the
XML::Twigmodule, which is used by Vanguard link checking. The first installation of the CPAN bundle can take up to 20 minutes (or 45 minutes on a wireless connection, if this is a test installation). Be patient.
perl -MCPAN -e shell cpan> install Bundle::CPAN cpan> reload cpan cpan> install XML::Twig
Customize the data SQL file for your installation by running the following script and answering the questions.
cd %vanguard_setup% perl update_mydb.pl
Create tables and add initial data into the
mysql -u▨▨▨▨ -p ▨▨▨▨ < %vanguard_setup%\vanguard_tables.sql <enter your ▨▨▨▨ user password> mysql -u▨▨▨▨ -p ▨▨▨▨ < %vanguard_setup%\vanguard_data_mydb.sql <enter your ▨▨▨▨ user password>
[mysqld], and under that label, add the following line (or change to 16M if the value is already listed in the file):
Stop and restart the server:
net stop MySQL net start MySQL
Install and Configure Vanguard
This software is required to run a the base Vanguard web application. Software required to build, package, view information centers and Knowledge Center collections is described later (for example, if you want to distribute the load on multiple servers) and would be installed in addition to the Vanguard web application software described here.
Visual C++ 2010 32-bit redistributable - Easy. Download and install.
Visual C++ 2010 64-bit redistributable - Easy. Download and install.
Visual C++ 2008 SP1 32-bit redistributable - Easy. Download and install.
Apache HTTP Server 2.2.x 32-bit from Apache Lounge - Use 32-bit 2.2.x because it is built with VC 9, which PHP 5.3 requires. Scroll down to find the latest 2.2.x version (httpd-2.2.29-win32.zip as of this writing).
Unzip the archive into
Install it as a service named Apache2.2 and set the path to its bin folder (
httpd -vis used by Vanguard to show the Apache version on the home page):
C:\Apps\Apache2\bin\httpd -k install -n "Apache2.2"
;C:\Apps\Apache2\binto your PATH environment variable. (
httpd -vis used by Vanguard to show the Apache version on the home page.)
Now that you have access to the
openssl.exethat is provided with Apache, you can use it to create a certificate request so that you can request a certified SSL certificate from the IBM certificate authority.
Once you request an SSL certificate, you must wait for manager approval. If you do that now, you can continue with installation while you wait. Request and later download a certificate for each server on which you want to run Vanguard.
Optionally, you can create a self-signed certificate (second set of details below), but users will see a warning from their browser and it’s not as “official”. :O)
IBMCA-certified certificate details:
Create the Certificate Request. Substitute
<host.domainname>with your full host and domain name. For example: ▨▨▨.▨▨▨.ibm.com.
cd C:\Apps\Apache2\conf set OPENSSL_CONF=C:\Apps\Apache2\conf\openssl.cnf ..\bin\openssl req -nodes -newkey rsa:2048 -sha256 -keyout <host.domainname>.key -out <host.domainname>.csr
Answer the questions. Below is an example with some values we use.
Label Value Country Name (AU) US State or province (S) CA Locality Name (L) San Jose Organization (O) IBM Organization unit (OU) Analytics, UTS Common Name (CN) <host.domainname> Email Address same as owner of profile below Challenge password blank Optional company name blank
The result is a private KEY file and CSR (certificate request) file in your Apache configuration folder.
Create a certificate profile for the server. Use the same values as used in the certificate request. Also, choose the
SERVERtype and specify the ITSC104 environment that the server is registered as in MAD. (No problem if you choose the wrong value; you’ll get an error and can try a different value.) For the MAD reference, try entering your host.domainname and hopefully it’s already registered and will be found.
From the profile page, Request a certificate by uploading the CSR file, selecting an approver, and selecting SERVER authorization.
Later, when approved, you’ll download the certificate, which will be used for Apache SSL configuration. For now, continue.
Self-signed certificate details:
Do this only if you didn’t request a certificate as described above. You will create the certificate rather than just a request. The syntax is a bit different than the CA-certified certificate, but provide the same answers to the questions as specified above:
cd C:\Apps\Apache2\conf set OPENSSL_CONF=C:\Apps\Apache2\conf\openssl.cnf ..\bin\openssl req -x509 -nodes -days 3650 -newkey rsa:2048 -sha256 -keyout <host.domainname>.key -out <host.domainname>.crt
The CRT file is your self-signed certificate. You’ll use this and the
.keyfile (private key) in your Apache SSL configuration later.
PHP 5.3.29 vc9 32-bit thread safe - This is an old version in the archives, but use it because it has been tested with Apache2 and Vanguard. Use the following info as you go through the wizard.
- Install it into
- Select the Apache 2.2.x Module
- Apache Configuration Directory
C:\Apps\Apache2\conf\. We’ll let PHP add it’s module information to httpd.conf.
- Select LDAP as an additional extension to the defaults. Verify that Curl, MySQL, MySQLi, PDO>MySQL, and OpenSSL are also selected.
- Install it into
- Java 7.1 built by IBM - Get the latest 64-bit 7.1 version. When
registering, it’s for personal use, not product use.
Change the path, replacing Program Files with Apps:
Select Custom and choose both JRE and SDK.
Install it as your system java. Let this be your server’s only Java installation. We’ve had problems with multiple java installations, especially with Jenkins.
Set the JAVA_HOME environment variable:
setx JAVA_HOME C:\Apps\IBM\Java71 /M
Strawberry Perl - If you did not already install perl on this computer when you installed the database, get the latest recommended version. 64-bit is okay for perl. Accept the default folder of
Initialize CPAN, and install the
XML::Twigmodule, which is used by Vanguard link checking:
perl -MCPAN -e shell cpan> install Bundle::CPAN cpan> reload cpan cpan> install XML::Twig
Note that reloading CPAN takes about 15 minutes (or even 40 minutes if you’re installing Vanguard as a proof-of-concept on your laptop from a home VPN). Be patient.
Apache Ant 1.8.4 - This version has been tested.
Unzip the archive into
C:\Appsand rename the folder
Ant184, resulting in
Set the ANT_HOME environment variable:
setx ANT_HOME C:\Apps\Ant184 /M
;C:\Apps\Ant184to your PATH environment variable.
ant-contrib - Go to the latest stable version, download and open the
*.bin.zipfile and copy the jar file from its
Jakarta Commons 3.x library for Ant - Download and open the
bin.zipfile and copy its jar files into
HttpComponents HttpClient library 4.x for Ant - Download and open the non-OSGi zip file and copy the jar files from its
- Jenkins - Get the latest Windows native package.
- Unzip it and run the
- Install it into
- Afterward, it will try to start in a browser. Close the browser for now.
- Unzip it and run the
The Vanguard application code. Extract it to the C drive root folder. It will result in a folder named
unzip %vanguard_setup%\p.zip -d C:\
pfolder is a legacy name to keep the path name as short as possible. It is short for production, there is also a subfolder,
C:\p\p, short for projects.
Install Rational Policy Tester single page scanner.
cd %vanguard_setup%\RPT ASESinglePageScannerSetup_8.5FP2.exe
Follow the prompts and install it into
extension_dir, make sure it’s uncommented, and set to the
extension_dir = "ext"
Find each of the following parameters, uncomment if required, and set as shown:
error_log=C:\Apps\PHP\php-errors.log max_execution_time = 60 post_max_size = 17M upload_max_filesize = 17M date.timezone = America/Los_Angeles
If you requested an IBMCA-certified certificate, then when your manager approves the SSL certificate request, go back to http://▨▨▨.ibm.com/▨▨▨/▨▨▨, view your certificates, and under Actions, select CRT File and click the arrow to download
Rename it to your host.domainname.crt and copy it to the Apache configuration folder where the request and private key are already, resulting in:
C:\Apps\Apache2\conf\<host.domainname>.crt C:\Apps\Apache2\conf\<host.domainname>.csr C:\Apps\Apache2\conf\<host.domainname>.key
bluepages.certto the configuration folder for LDAP authentications.
copy %vanguard_setup%\bluepages.cert C:\Apps\Apache2\conf
ServerRootto your Apache installation directory:
LoadModuleand uncomment each of the following modules:
Below where the modules are loaded, add the following entries for bluepages authentication:
LDAPTrustedGlobalCert CA_BASE64 "C:/p/www/bluepages.cert"
ServerAdminto your email address:
Uncomment and change the
ServerNameto your server’s host.domainname at port 80:
Change the DocumentRoot to the vanguard app folder
<Directory>that’s currently set to htdocs to point to the new
DocumentRootand specify that this directory allow all overrides (instead of None):
<Directory "C:/p/www"> ... AllowOverride All ... </Directory>
Make the PHP index the first choice in the
<IfModule dir_module> DirectoryIndex index.php index.html </IfModule>
Right after the
LogLeveldirective outside of any
<IfModule/>sections, add JSON and AJAX requests to an environment that you can filter later in the custom log setting.
SetEnvIf Request_URI "(\.json)$" no_log SetEnvIf Request_URI "(\.ajax)$" no_log SetEnvIf Request_URI "(\\/jobs\/active)$" no_log
Combined logs are nice. In the
log_config_modulesection, comment out the common one and uncomment the combined one. Whichever one you use, add
env=!no_logafter it to filter the AJAX and JSON hits.
#CustomLog "logs/access.log" common CustomLog "logs/access.log" combined env=!no_log
Toward the bottom of the file are other configuration file includes. Uncomment the SSL configuration file include:
At the very bottom of the httpd.conf file, the PHP installer should have added some lines in the
httpd.conffile to point to its module, and it should have added the x-httpd-php mime type to the mime.types file. If it did, great. If not, add the following lines to your httpd.conf file. I’d put it up just below where the other LoadModule statements are.
LoadModule php5_module "C:/Apps/PHP/php5apache2_2.dll" <IfModule php5_module> PHPIniDir "C:/Apps/PHP" AddType application/x-httpd-php .php DirectoryIndex index.php index.html </IfModule>
SSLSessionCacheto the following:
<VirtualHost>opening element to match your host.domainname:
VirtualHostelement, find each of the following directives and set them to the values shown (using your hostname and email address):
DocumentRoot "C:/p/www" ServerName <host.domainname> ServerAdmin <your.email.address> ErrorLog "C:/Apps/Apache2/logs/error.log" TransferLog "C:/Apps/Apache2/logs/access.log" SSLProtocol -SSLv2 -SSLv3 SSLCertificateFile "C:/Apps/Apache2/conf/<host.domainname>.crt" SSLCertificateKeyFile "C:/Apps/Apache2/conf/<host.domainname>.key" SSLCertificateChainFile "C:/p/www/IBMca.crt" CustomLog "C:/Apps/Apache2/logs/ssl_request.log"
Test the syntax of the configuration files and correct any errors found:
Configure it to run as the Administrator user that you are logged in as and restart it:
Find Apache2.2 > Properties > Log On > This account > Enter credentials > OK > Start
C:\p\vgnlv\web\config.phpfile and change the relevant values for your database:
$dbcfg = array( 'driver' => 'mysql', 'persistent' => false, 'host' => '<yourdbhostname>', 'login' => '<yourdbuser>', 'password' => '<yourdbpass>', 'database' => '<yourdbname>', 'port' => '3306' );
C:\p\www\app\config\database.phpfile and change the relevant values for your database:
var $default = array( 'driver' => 'mysql', 'persistent' => false, 'host' => '<yourdbhostname>', 'login' => '<yourdbuser>', 'password' => '<yourdbpass>', 'database' => '<yourdbname>', 'port' => '3306' );
C:\p\www\app\config\vanguard.phpfile and change the following values to fit your environment:
$config['vg.host_name'] = '<yourvanguardhost.domainname>'; $config['vg.domainsuffix'] = '<domainsuffix>'; $config['vg.nlv_server'] = '<yournlprocessingserver>; $config['vg.product_name'] = '<A Server Title for the Banner>';
C:\p\www\app\config\vanguard_rarelychanged.phpfile and change the following value to a distribution list for your set of administrators (or to your email address if you’re the only one).
$config['vg.support_distribution_list'] = '<your support email address>';
Enough has been installed to test and see if the Vanguard web application displays. Open
http://localhost. It should redirect to
https://localhostask you to log in, register your user ID, and display the vanguard interface.
Stop jenkins and assign a quarter of your available memory to it, but not more than the maximum of 2 GB.
net stop jenkins perl -pi.bak -e "s/-Xmx(.*?)\s+/-Xmx2g /;" C:\Apps\Jenkins\jenkins.xml
Configure it to run as the Administrator user that you are logged in as:
Find Jenkins > Properties > Log On > This account > Enter credentials > OK
(The reason you run the Jenkins service under a Windows user ID is so that the
Filenet.credentialsof that Windows User ID is available to Jenkins when it attempts an IDCMS login.)
mkjenkinsjob.plperl script to easily create the jobs necessary for running vanguard queues for builds, IC & KC posting, health checks, and NL package processing.
You run the script with various arguments to generate a job folder and associated
config.xmlfile for the job:
-d: creates a jenkins job for the default build queue (build server)
-h <server>: create a jenkins job for the health checks queue (build server)
-i <server>: create a jenkins job for the IC-posting queue (IC-hosting server)
-k <server>: create a jenkins job for the KC-posting queue (KC-hosting server)
-n <server>: create a jenkins job for the NL package processing queue (NL-processing server)
-s <server>: create a jenkins job for the system queue (each server requires at least one)
For example, if you are running everything on the same server and you want the server to be able to run four builds at a time (the default queue), you would run the script as follows. (The required
-xflag provides a distinguishing number for the queue.)
cd %vanguard_setup% mkjenkinsjob.pl -d -x 1 mkjenkinsjob.pl -d -x 2 mkjenkinsjob.pl -d -x 3 mkjenkinsjob.pl -d -x 4 mkjenkinsjob.pl -h <host.domainname> -x 1 mkjenkinsjob.pl -h <host.domainname> -x 2 mkjenkinsjob.pl -i <host.domainname> -x 1 mkjenkinsjob.pl -i <host.domainname> -x 2 mkjenkinsjob.pl -k <host.domainname> -x 1 mkjenkinsjob.pl -k <host.domainname> -x 2 mkjenkinsjob.pl -n <host.domainname> -x 1 mkjenkinsjob.pl -s <host.domainname> -x 1
It’s recommended to run at least 3-4 build queues, a couple of health check, IC, and KC queues. But, only one NL package processing queue and one system queue is required. The Analytics Platform vanguard server runs 13 default build queues, one NL packaging queue, and four of each of the other types of queues.
When you run the script, the jobs are created in
%vanguard_setup%\jenkins_jobs. Copy the contents of this folder into the
C:\Apps\Jenkins\jobsfolders on the servers where these job queues are required.
Open Jenkins and do the initial set up:
Start the Jenkins service.
net start jenkins
Open Jenkins in a browser:
SDS requires us to set up security on Jenkins. We use Project-based matrix security. You set up a single admin user. Give the admin user global permissions. And give anonymous users only read access and nothing else. Here is a good write-up on setting up Project-based matrix authorization.
Install and Configure Conditional Software
The rest of the software you choose to install depends on its purpose and on which server it will run. You will need to choose at least one build server, of course, but some software you might not need to install, such as when you need only IDCMS repositories for builds to KC. In such a case, you can skip CMVC, CVS, RTC, and information centers.
On each server that will download source and run builds or create pakpaks
Prerequisite: Install and configure Vanguard, as previously described.
ObjectRexx - Another Green2Go download where the installer is in the binaries folder. Use
ooRexx-4.2.0.winX64.exefor a 64-bit OS. The IDWB page says to accept the defaults, so don’t change the path, even though it’s long. The only thing I changed was the path to the editor, Notepad++ instead of Notepad.
Start > Computer > Properties and next to your computer name, click Change settings. On the Computer Name tab, click Change > More and add your domain suffix (for example,
▨▨▨.ibm.com). Leave Change primary DNS suffix when membership changes unchecked.
REBOOT - Changing the domain should force a reboot, but you must reboot between installing Rexx and the workbench anyway.
- ID Workbench - Download the latest Windows Client Package and
unzip it to a folder, and run
- Most likely you’ll choose Custom setup and select only DITA Tools Core and ID Workbench. Vanguard does not require Oxygen, Arbortext, or DITA Architect.
- When installed, reboot.
- After rebooting, Start > Search:’Product Information’ and Check for Updates to install all patches and updates.
- Start > Search:’Plugin install tool’ and install and update any plugins that you think your writers might use.
- Start > Search:’Configure’:
- authenticate with a user ID that
has access to all the IDCMS folders that the server will build.
For example, the Vanguard development team has a functional intranet
user ID that is in the bluegroup that has read access to the parent
/IMpath and all child folders in IDCMS. - Choose an AIX server to build PDFs.
FILENET_WORKenvironment variable to
setx FILENET_WORK src\en /M
Download CMVC, unzip it, and run the included
CMVCDC_5.0_Win_Installer.EXEfile. It will install CMVC in
Download CMVC CLI, unzip the
cmvccli_WIN_5.0_20120330.1301.zipfile, and drag the
C:\CMVCDC5.0. Then, set the following environment variables:
setx PATH "%PATH%;C:\CMVCDC5.0\bin" /M setx CMVC_AUTH_METHOD PW /M
Test it by opening a separate command window and attempting to log in. No error message or response indicates a successful login.
cvmclog -in <your_cmvc_user_id> -family <an_authorized_family>
C:\>cmvclog -in utinfra1 -family ▨▨▨@▨▨▨.ibm.com@▨▨▨▨ Enter the cmvc password for login utinfra1 on family ▨▨▨@▨▨▨.ibm.com@▨▨▨▨: ******** C:\>
If you have RTC repositories, install your repository’s required version of RTC and set up the scmtools command line:
Download RTC into
;C:\Apps\jazz\scmtoolsto your PATH environment variable.
If you have CVS repositories, install cvs and cvsutil from cygwin. Set the CVS password.
Download cygwin (
setup-x86_64.exe) and launch it.
Progress through the wizard until you can select packages. Search for the
cvsutilpackages, select them, and proceed to install.
;C:\cygwin\binto the PATH.
Set the CVS password for the user ID used to log in to the CVS repository:
mkdir C:\cygwin\home\<userID> cd /d C:\cygwin\home\<userID> cvs -d :pserver:<userID>@<server.domain.address>:/cvsroot login
If you have users who build Windows HTMLHelp, get HTMLHelp Workshop 1.3, install it in a folder of your choosing and add the folder to your PATH environment variable, such as
C:\Apps\hhc. If you see a message after installation that says a newer version is installed, just ignore it. The message refers to the included viewer component, not the Workshop itself.
If Jenkins is running and if you installed anything in this section that required you to modify your PATH, restart Jenkins so that the new PATH takes effect in the job environment.
On each server to host Eclipse information centers
Prerequisite: Install and configure Vanguard, as previously described.
The Eclipse Help System - Extract the provided zip files into
C:\ibm_help. Use this location because it is where the Vanguard database expects the IEHS installations to be when it sets up and interacts with the information centers.
mkdir C:\ibm_help unzip %vanguard_setup%\IBM-Help-Win32_18.104.22.168.v20130905-1554.zip -d C:\ibm_help unzip %vanguard_setup%\iehs_nlpackage_22.214.171.124.v20130905-1554.zip -d C:\ibm_help move C:\ibm_help\ibm_help C:\ibm_help\3.6.2 unzip %vanguard_setup%\IBM-Help-Win32_126.96.36.199.v20130905-1554.zip -d C:\ibm_help unzip %vanguard_setup%\iehsc_win_internal_plugin_188.8.131.52.v20130905-1554.zip -d C:\ibm_help unzip %vanguard_setup%\iehsc_nlpackage_184.108.40.206.v20130905-1554.zip -d C:\ibm_help move C:\ibm_help\ibm_help C:\ibm_help\3.6.2.c_internal
Run the Jenkins job queue perl script to create ICJob queues if you haven’t already, to install in Jenkins running on this IC hosting server.
On each server to host KC collections
Prerequisite: Install and configure Vanguard, as previously described.
Follow ▨▨▨▨ ▨▨▨▨’s instructions verbatim to install a KCHosted environment.
kc.propertiesfiles by running this little script and specifying the same KC root folder that you specified when you modified the database DML script:
cd %vanguard_setup% update_kcfiles.pl
Copy the following files, where
<kcroot>is the folder specified in the previous step.
mkdir C:\KCHosted\<kcroot> copy %vanguard_setup%\kc\kc.properties C:\KCHosted\<kcroot> copy %vanguard_setup%\kc\kc_welcome_template C:\KCHosted\<kcroot> copy %vanguard_setup%\kc\server.xml C:\WASLiberty\wlp\usr\servers\kc copy %vanguard_setup%\kc\server.env C:\WASLiberty\wlp\usr\servers\kc
Add the following location to the
# Proxy path for kc so that port number isn't required <Location "/kc"> ProxyPass http://localhost:9090/kc ProxyPassReverse http://localhost:9090/kc ProxyPassReverseCookiePath http://localhost:9090/kc /kc </Location>
Create a Windows scheduled task to start KC when the computer boots. Create the task as an Administrator user:
- On the General tab, specify that it Run whether user is logged on or not and run as the Administrator user.
- On the Triggers tab, add a trigger to begin
- On the Action tab, specify:
- Action: Start a program
- Add arguments:
- Start in:
Run the perl script that creates Jenkins job queues to create KCJob queues on this computer if you haven’t already.
On each server that will process returned NL packages
Create a file named
C:\openldap\sysconf\ldap.confwith the following contents:
TLS_REQCERT never TLS_CACERT C:\Apps\Apache2\conf\bluepages.cert
(The OpenLDAP implementation in PHP 5.3.x uses this static location for the OpenLDAP configuration settings. OpenLDAP is used by the Vanguard SOAP Server to authenticate the credentials in the header.)
httpd.conffile, add the following to the
<IfModule alias_module>section, and restart Apache.
Alias /DVT "C:/p/vgnlv/web" <Directory "C:/p/vgnlv/web"> Options Indexes FollowSymLinks AllowOverride All Order allow,deny Satisfy Any Allow from all </Directory> Alias /proc "C:/p/vgnlv/proc" <Directory "C:/p/vgnlv/proc"> Options Indexes FollowSymLinks AllowOverride All Order allow,deny Satisfy Any Allow from all </Directory>