Instructions for Installing webMethods Product Suite v9.

Date: March 2016

Software: webMethods v9.8

This document contains proprietary and confidential information related to the Procurement Desktop Defense (PD²)
product of CACI Enterprise Solutions, Inc., as defined in the Software License Agreement (SLA) between CACI
Enterprise Solutions, Inc. and the Department of Defense (DoD), at Section J, Attachment #6, of Contract Number
W91QUZ-12-D-0010. This information includes, but is not limited to, icons and software screen prints.
Distribution of this document is restricted to employees of the DoD or to third parties who require access on behalf
of the DoD and who have executed an appropriate non-disclosure agreement as described in the SLA.
 Table of Contents

1. Introduction .............................................................................................................. 1
1.1 Purpose .......................................................................................................... 1
1.2 Audience ......................................................................................................... 1
1.3 Assumptions ................................................................................................... 1
2. Download webMethods Components .......................................................................... 2
2.1 Download the Software AG Installer ............................................................... 2
2.2 Unpack the Software AG Installer ................................................................... 2
2.3 Download the CACI webMethods Installer for SR17 ....................................... 2
2.4 Unpack the CACI webMethods Installer for SR17 ........................................... 3
2.5 Download the webMethods Image Files .......................................................... 3
2.6 Unpack the webMethods Image Files .............................................................. 4
3. Run CACI webMethods Installer for SR17 .................................................................. 5
3.1 Before Executing the CACI webMethods Installer for SR17 ............................ 5
3.1.1 webMethods Setup Parameters................................................................. 5
3.1.2 PD2 Adapter Setup Parameters ................................................................. 6
3.2 Run the CACI webMethods Installer for SR17 ................................................. 8
4. Install webMethods Product Suite v9.8.................................................................... 20
4.1 Execute the webMethods v9.8 Installer ........................................................ 20
4.2 Configure Broker Server ............................................................................... 26
4.3 Configure Integration Server ........................................................................ 29
4.4 Apply webMethods Updates .......................................................................... 33
4.5 Configure My webMethods Server ................................................................. 43
4.5.1 Create MWS Instance with External RDBMS ..............................................43
4.5.2 Create MWS Instance with Internal RDBMS ...............................................45
4.5.3 Initialize New MWS Instance ...................................................................45
5. webMethods Post Installation Tasks ........................................................................ 48
5.1 Modify the Windows Service for webMethods Integration Server ................. 48
5.2 Modify the Windows Service for My webMethods Server .............................. 48
5.3 Update the webMethods Logging Level ......................................................... 49
5.4 Update Resources Configuration ................................................................... 52
5.5 Restart My webMethods Server .................................................................... 58
6. Update Dispatch File For IPV6 Environments ........................................................... 59
7. CDR Package ............................................................................................................ 60
Appendix A: Shut Down webMethods Integration Server .................................................... 61
Appendix B: Shut Down webMethods Broker Service .......................................................... 63
Appendix C: Start webMethods Broker Service ................................................................... 65
Appendix D: Start webMethods Integration Server ............................................................. 66
Appendix E: Log into webMethods Administrator ................................................................ 67

Instructions for Installing ii March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

Appendix F: Configure Integration Server for HTTPS .......................................................... 68
Appendix G: Shut Down My webMethods Server ................................................................. 69
Appendix H: Start My webMethods Server .......................................................................... 70
Appendix I: Log into My webMethods Server ...................................................................... 71
Appendix J: Assigning an Accessible Temporary Folder to the Windows User Variables ..... 73
Appendix K: Start a Command Prompt as an Administrator ................................................ 74
Appendix L: Uninstall webMethods v9.6 ............................................................................. 75
Appendix M: Update Dispatch File For IPV6 Environments .................................................. 83

Instructions for Installing iii March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

1. Introduction

The webMethods Product Suite v9.8 components provide the run-time environment for the PD2
Document Transfer Utility, PD2 Archiving Utility, and PD2 Adapter. This document is designed
to guide sites through the installation process for webMethods Product Suite v9.8.

The installation process uses the following components:

 CACI webMethods Installer for v4.2 Increment 2 SR17

 Software AG Installer

Note: The address bar and the title bar in the browser screen shots may look different from the
actual screens depending on the user’s input in the address bar.

1.1 Purpose

The purpose of this document is to detail procedures and tasks involved in installing webMethods
Product Suite v9.8.

1.2 Audience

This guide is intended for skilled System Administrators (SAs) proficient with the use of
Windows Server 2008, Windows Server 2012, and webMethods Product Suite v9.8.

1.3 Assumptions

Sybase Open Client 16 is installed on the target machine, prior to the execution of these
instructions. Refer to the PD2 v4.2 Increment 2 SR17 Sybase Open Client 16 SP01 PL02
Installation Guide for additional information.

Instructions for Installing 1 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

2. Download webMethods Components

2.1 Download the Software AG Installer

 To download the Software AG Installer:

1. Launch Internet Explorer and log into the SPS web site (http://sps.caci.com).
2. From the Downloads tab, select the webMethods check box.
(The Downloads list displays the entries related to the webMethods category.)
3. Click the Software AG Installer v9.8 for SR17 link.
(The Software AG Installer v9.8 for SR17 page displays.)
4. Click [Download].
(The File Download window opens.)
5. Click [Save As].
(The Save As window opens.)
6. In the Save As window, indicate the appropriate file path and click [Save].
(The file saves as “SoftwareAGv98ForSR17Download.zip” and the Download Complete
window opens.)

2.2 Unpack the Software AG Installer

 To unpack the Software AG Installer:

1. Double-click the “SoftwareAGv98ForSR17Download.zip” file.
2. Open the “Password.txt” file and copy the password.
3. Extract the “SoftwareAGv98ForSR17.zip” into the same directory entering the password
when prompted and clicking [OK].
4. Double-click the “SoftwareAGv98ForSR17.zip” file.
5. Extract the “SoftwareAGInstaller20150415.exe” into the same directory.
6. After successful extraction, delete the “SoftwareAGv98ForSR17Download.zip” file.

2.3 Download the CACI webMethods Installer for SR17

 To download CACI webMethods Installer for SR17:

1. Launch Internet Explorer and log into the SPS web site (http://sps.caci.com).
2. From the Downloads tab, select the webMethods check box.
(The Downloads list displays the entries related to the webMethods category.)

Instructions for Installing 2 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 3. Select the CACI webMethods Installer for SR17 link.
(The CACI webMethods Installer for SR17 page displays.)
4. Click [Download].
(The File Download window opens.)
5. Click [Save As].
(The Save As window opens.)
6. In the Save As window, indicate the appropriate file path and click [Save].
(The file saves as “CACIwebMethodsForSR17Download.zip” and the Download
Complete window opens.)

2.4 Unpack the CACI webMethods Installer for SR17

 To unpack the CACI webMethods Installer for SR17:

1. Double-click the “CACIwebMethodsInstallerForSR17Download.zip” file.
2. Open the “Password.txt” file and copy the password.
3. Extract the “CACIwebMethodsInstallerForSR17.zip” into the same directory entering the
password when prompted and clicking [OK].
4. Double-click the “CACIwebMethodsInstallerForSR17.zip” file.
5. Extract the “CACIwebMethodsInstallerForSR17.exe” into the same directory.
6. After successful extraction, delete the
“CACIwebMethodsInstallerForSR17Download.zip” file.

2.5 Download the webMethods Image Files

 To download the webMethods images for a 64-bit Operating System:

1. Launch Internet Explorer and log into the SPS web site (http://sps.caci.com).
2. From the Downloads tab, select the webMethods check box.
(The Downloads list displays the entries related to the webMethods category.)
3. Select the WIN64_SINST_BASE_SR17 link.
(The WIN64_SINST_BASE_SR17 page displays.)
4. Click [Download].
(The File Download window opens.)
5. Click [Save As].
(The Save As window opens.)
6. In the Save As window, indicate the appropriate file path and click [Save].

Instructions for Installing 3 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 (The file saves as “WIN64_SINST_BASE_SR17_DOWNLOAD.zip” and the Download
Complete window opens.)
7. Select the Back link above the Results column.
8. Select the WIN64_SUM_UPDATE01_SR17 link.
(The WIN64_SUM_UPDATE01_SR17 page displays.)
9. Click [Download].
(The file download window opens.)
10. Click [Save As].
(The Save As window opens.)
11. In the Save As window, indicate the appropriate file path and click [Save].
(The file saves as “WIN64_SUM_UPDATE01_SR17_DOWNLOAD.zip” and the
Download Complete window opens.)

2.6 Unpack the webMethods Image Files

The CACI webMethods Installer for SR17 assumes that all webMethods image files and the
Software AG Installer are in the same directory. Extract all required images and place them in
the same directory as the Software AG Installer.
 To unpack the images for a 64-Bit Operating System :
1. Double-click the “WIN64_SINST_BASE_SR17_DOWNLOAD.zip” file.
2. Open the “Password.txt” file and copy the password.
3. Extract “WIN64_SINST_BASE_SR17_PACKAGE.zip” into the same directory by
entering the password when prompted and clicking [OK].
4. Double-click the “WIN64_SINST_BASE_SR17_PACKAGE.zip” file.
5. Extract the “WIN64_SINST_BASE_SR17.zip” into the same directory as the Software
AG Installer.
6. After successful extraction, delete the
“WIN64_SINST_BASE_SR17_DOWNLOAD.zip” file.
7. Double-click the “WIN64_SUM_UPDATE01_SR17_DOWNLOAD.zip” file.
8. Open the “Password.txt” file and copy the password.
9. Extract “WIN64_SUM_UPDATE01_SR17_PACKAGE.zip” into the same directory by
entering the password when prompted and clicking [OK].
10. Double-click the “WIN64_SUM_UPDATE01_SR17_PACKAGE.zip” file.
11. Extract the “WIN64_SUM_UPDATE01_SR17.zip” into the same directory as the
Software AG Installer.
12. After successful extraction, delete the
“WIN64_SUM_UPDATE01_SR17_DOWNLOAD.zip” file.

Instructions for Installing 4 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

3. Run CACI webMethods Installer for SR17

The CACI webMethods Installer for SR17 configures scripts and batch files based on the input
gathered on each screen.

Warning: If technical failure (power outage, system outage, etc.) is experienced during the
installation process, the application must be uninstalled prior to starting the installation
process again.

3.1 Before Executing the CACI webMethods Installer for SR17

The following information is necessary for the installation and configuration of webMethods.

3.1.1 webMethods Setup Parameters

The following information is needed for the webMethods setup: Table 1: webMethods Setup
Parameters

webMethods
directory
location: ______________________________________________
Location of webMethods directory. Example: C:\SoftwareAG

webMethods
Broker Monitor ______________________________________________
Port Number: webMethods Broker Monitor port. Example: 6850

webMethods
Broker Server ______________________________________________
Port Number: webMethods Broker Server port. Example: 6849

webMethods IS
Port Number: ______________________________________________
webMethods Integration Server port. Example: 5555

webMethods
MWS http Port ______________________________________________
Number: webMethods MWS http port. Example: 8585

Host Name
______________________________________________
Machine name of the host machine. Example:
wmserver.domain.com

Instructions for Installing 5 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 3.1.2 PD2 Adapter Setup Parameters

The following information is necessary if the user is setting up PD2 Adapter on this instance of
webMethods.

3.1.2.1 My webMethods Server Sybase User

Prior to installing the webMethods, a Sybase login (e.g., mwsuser) is required. The login
is used by the webMethods Integration Server to connect to the My webMethods Server
database. If the login does not exist, it needs to be created.

The login must have the Sybase sps_srv_conn_role. To verify, log into the Sybase server
as the user with sso_role (e.g., sa) and execute:

sp_displaylogin <LOGIN_NAME>
go

where <LOGIN_NAME> is the login to be verified. The result should include

"sps_srv_conn_role (default ON)" in the output.

If the sps_srv_conn_role is missing for the login, grant the role by executing:

exec sp_role 'grant','sps_srv_conn_role', '<LOGIN_NAME>'

exec sp_modifylogin '<LOGIN_NAME>', 'add default role',
'sps_srv_conn_role'
go

where <LOGIN_NAME> is the login to be granted the role.

3.1.2.2 MWS Setup Parameters

The following information is needed for the MWS setup:

Table 2: MWS Setup Parameters

My webMethods
Server Sybase ______________________________________________
Alias Name: (from the sql.ini file, e.g., MWS_SYBASE_SERVER)

My webMethods
Server Sybase ______________________________________________
Host Name: (Name of the machine or IP address of the Sybase ASE Server)

My webMethods
Server Sybase ______________________________________________
Port Number: (from the sql.ini file, e.g., 5980)

Instructions for Installing 6 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 My webMethods
Server Sybase ________________________________________________
Super User ID (“sa” ID and password)
and Password:

My webMethods
Server Sybase ______________________________________________
Database Name: (For a Fresh install this should be created by the site, e.g.,
SPS_MWS_<site identifier>_DB)

My webMethods
Server Sybase
Database Login ______________________________________________
Name and (An existing Sybase login and password to be used by MWS to
Password: connect to the MWS Database)

My webMethods
Server Sybase
Data device path
or directory My webMethods Sybase Server Data device path or directory
location 1: location. Example: C:\sybase\data

My webMethods
Server Sybase
Data device My webMethods Sybase Server Data device size. Refer to
size2: Section 7.1.2.4 of the PD2 Adapter v3.4 Functional User's Guide to
estimate the size of the data device. The minimum size allowed is
2048.

My webMethods
Server Sybase
Log device path
or directory My webMethods Sybase Server Log device path or directory
location1: location. Example: C:\sybase\logdev

My webMethods
Server Sybase
Log device size2: My webMethods Sybase Server Log device size. Refer to Section
7.1.2.4 of the PD2 Adapter v3.4 Functional User's Guide to
estimate the size of the log device. The minimum size allowed is
512.

1
This path or directory location should exist on the physical machine of the database server prior to running the script
2
Values in italics are defaulted values. These can be changed, as needed.

Instructions for Installing 7 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

3.2 Run the CACI webMethods Installer for SR17

 To run the CACI webMethods Installer for SR17:

1. Locate the previously saved CACI webMethods Installer for SR17 executable right-click
and select Run as administrator to launch the Installation Wizard.

Note: The Windows Security Warning/User Account Control message box may display.
Accept the warning to continue.

(The Welcome to the webMethods Installer for SR17 window opens.)

2. Click [Next].
(The webMethods directory window opens.)

Instructions for Installing 8 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 3. Click [Browse] to select an empty folder other than the default. Click [Next] after
selecting the appropriate folder.
(The Question window opens.)

4. Click [Yes].
(The webMethods Image File window opens.)

Instructions for Installing 9 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 5. The webMethods Image File window provides guidelines regarding which image file to
select. Click [Next] to select the image.
(The Select an appropriate webMethods image file window opens.)

Instructions for Installing 10 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 6. Navigate to the appropriate directory, select the file, and click [Open].
(The selected file window opens.)

7. Click [OK].
(The webMethods Broker Configuration window opens.)

8. Enter the following information:

 Mon Port – The listening port for the webMethods Broker Monitor. This must be an
unused port on the host machine. The default value is 6850. Refer to webMethods
Broker Monitor Port Number in Table 1: webMethods Setup Parameters.
 Server Port – The listening port for the webMethods Broker Server. This must be
an unused port on the host machine. The default value is 6849. Refer to
webMethods Broker Server Port Number in Table 1: webMethods Setup Parameters.

Note: Ports 6850 and 6849 have not been assessed by the Defense Information Systems Agency
(DISA). The Defense Logistics Agency (DLA) is currently in the process of working
with DISA to assess these ports.

9. Click [Next].
(The webMethods Integration and MWS Configuration window opens.)

Instructions for Installing 11 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 10. Enter the following information:
 IS Port – The listening port for the webMethods Integration Server. This must be an
unused port on the host machine. The default value is 5555. Refer to webMethods IS
Port Number in Table 1: webMethods Setup Parameters.
 MWS Port – The listening port for the My webMethods Server. This must be an
unused port on the host machine. The default value is 8585. Refer to webMethods
MWS http Port Number in Table 1: webMethods Parameters.
 Host Name – The machine name of the host machine. Refer to Host Name in Table
1: webMethods Parameters.

Note: Ports 5555 and 8585 have not been assessed by DISA. The DLA is currently in the
process of working with DISA to assess these ports

11. Click [Next].

(The webMethods Memory Configuration window opens.)

Instructions for Installing 12 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 12. Enter the Maximum and Minimum memory values for the webMethods v9.8 instance.

Note: CACI recommends setting the Maximum and Minimum memory settings to the same
value.

Note: Due to a limitation with a third-party caching component used by webMethods, it may be
desirable to configure webMethods to use less than the maximum JVM setting for
Windows (~1500 MB). In some cases, OutOfMemory and caching exceptions can be
avoided by reducing the memory assigned to the JVM, thereby allowing more of the
machine’s memory to be available for non-JVM processes.

13. Click [Next].

(The Question window opens.)

To set up PD2 Adapter on this instance of webMethods, click the [Yes] button to open the
following window. If PD2 Adapter is not required on this instance of webMethods, click
the [No] button and skip to Step 25.

(The My webMethods Server (MWS) DB Information window opens.)

Instructions for Installing 13 March 2016
webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 14. Enter the following information:
 Server: Enter the Sybase Adaptive Server name. Refer to My webMethods Server
Sybase Alias Name in Table 2: MWS Setup Parameters. The server name can be
found in the Sybase “sql.ini” file, or it may not exist in the “sql.ini”. If the server
name does not exist in the “sql.ini” file, a window opens in Step 15 to allow
specification the IP address and the port number.
 Database: Enter a database name in the Database field. Refer to My webMethods
Server Sybase Database Name in Table 2: MWS Setup Parameters. CACI
recommends “[DoDAAC] _MWS_DB”, where [DoDAAC] is the site’s six digit
DoDAAC.

Note: The maximum length of the Database field is 20 characters.

Note: If the “sql.ini” contains the server specified in Step 14, the installation wizard does not go
through Steps 15 and 16; rather it goes to Step 17.

15. Click [Next].

(The My webMethods server [MWS] DB Server Information window opens.)

Instructions for Installing 14 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 16. Enter the following information:
 IP Address: Enter the IP address or the host machine name of the MWS database
server. Refer to My webMethods Server Sybase Host Name in Table 2: MWS Setup
Parameters.
 Port: Enter the port number for the DB server. Refer to My webMethods Server
Sybase Port Number in Table 2: MWS Setup Parameters.
17. Click [Next].
(The Sybase Super Login Information window opens.)

18. Enter the following information:

Instructions for Installing 15 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

  Sybase Super User Login: Enter the Sybase Super User Login. Refer to My
webMethods Server Sybase Super User ID and Password in Table 2: MWS Setup
Parameters.

Note: The Sybase Super User Login must have sa_role and sso_role.

 Sybase Super User Password: Enter the Sybase Super User Password. Refer to My
webMethods Server Sybase Super User ID and Password in Table 2: MWS Setup
Parameters.
19. Click [Next].
(The Verifying Sybase roles, Getting Sybase Default Device Information, and finally,
My webMethods Server (MWS) Database Login windows open.)

 My webMethods Server (MWS) Database Login: Enter MWS database login.

Refer to My webMethods Server Sybase Database Login Name and Password in
Table 2: MWS Setup Parameters.
 My webMethods Server (MWS) Database Password: Enter MWS database
password. Refer to My webMethods Server Sybase Database Login Name and
Password in Table 2: MWS Setup Parameters.
20. Click [Next].
(The Verifying Sybase account followed by the My webMethods Server (MWS) DB Data
Segment windows open.)

Instructions for Installing 16 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 Note: The Directory field is populated automatically with the default data segment path of the
Sybase DB server.

21. Enter the following information:

 Directory: Enter the desired path for the MWS database data segment. Refer to My
webMethods Server Sybase Data device path or directory location in Table 2: MWS
Setup Parameters.

Note: The directory syntax MUST conform to the platform on which the database is to be
installed and NOT the workstation from which you are installing it. For example, a valid
directory entry from ASE on Windows Server 2008/2012 might be
“C:\SYBASE15\data”; for ASE Enterprise running under Sun Solaris (a UNIX
platform) the syntax might be “/data9/sybase”. Pay special attention to the direction
of “slashes” (e.g., “/” or “\”); these are very important distinctions between Windows
Server 2008/2012 and UNIX.

 Data Size: Enter the size of the MWS Database. Refer to My webMethods Server
Sybase Data device size in Table 2: MWS Setup Parameters.
22. Click [Next].
(The My webMethods Server (MWS) DB Log Segment window opens.)

Instructions for Installing 17 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 Note: The Directory field is populated automatically with default log segment path of the
Sybase DB server.

23. Enter the following information:

 Directory: Enter the desired path for the MWS database log segment. Refer to My
webMethods Server Sybase Log device path or directory location in Table 2: MWS
Setup Parameters.

Note: The directory syntax MUST conform to the platform on which the database is to be
installed and NOT the workstation from which you are installing it. For example, a valid
directory entry from ASE on Windows Server 2008/2012 might be
“C:\SYBASE15\logdev”; for ASE Enterprise running under Sun Solaris (a UNIX
platform) the syntax might be “/logdev9/sybase”. Pay special attention to the
direction of “slashes” (e.g., “/” or “\”); these are very important distinctions between
Windows Server 2008/2012 and UNIX.

 Log Size: Enter the size of the Log Segment. Refer to My webMethods Server
Sybase Log device size in Table 2: MWS Setup Parameters.
24. Click [Next] once the information is entered.
(The Start Copying Files window opens.)

Note: The screenshot may look different from the actual screen depending on the user input in
previous steps. Scroll the window to see the details.

Instructions for Installing 18 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 Note: Do not close any windows that may open during the installation process. The installer
will not be able to install the application correctly if a window is shut down before the
installer is complete. If this happens, contact the SPS Help Desk for instructions on how
to recover.

25. Click [Next].

(The InstallShield Wizard Complete window opens.)

26. Click [Finish] to complete the CACI webMethods Installer for SR17.

Instructions for Installing 19 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

4. Install webMethods Product Suite v9.8

4.1 Execute the webMethods v9.8 Installer

Warning: If technical failure (power outage, system outage, etc.) is experienced during the
installation process, the application must be uninstalled prior to starting the installation
process again.

Note: CACI recommends disabling all anti-virus and other threat protection software during the
execution of the webMethods v9.8 installer. If allowed to run, some anti-virus software
products have been shown to prevent the webMethods v9.8 installer from completing the
installation process.

 To install webMethods Product Suite v9.8:

1. Open a command prompt window as an Administrator. Refer to Appendix K: Start a
Command Prompt as an Administrator for detailed instructions.
(The DOS command window opens.)

2. Change the directory to the SPS SAG install directory, by using the following command
cd /d <WMDIR>\install\sps\sr17\sag where <WMDIR> is the fully qualified path to the
Integration Server directory (e.g., C:\SoftwareAG).
(The cd command opens.)

Note: The screenshot may look different depending on the webMethods directory the user
specified in Section 3.1.1: webMethods Setup Parameters.

Instructions for Installing 20 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 3. After entering the command, press <Enter> to execute the command.
(The current directory is changed to <WMDIR>\install\sps\sr17\sag.)

4. Execute the “00100_EXE_SAG_INSTALL.bat” file by typing

“00100_EXE_SAG_INSTALL.bat” and pressing <Enter>. Upon execution, the
“00100_EXE_SAG_INSTALL.bat” file launches the Software AG Installation Wizard.

Note: The Windows Security Warning/User Account Control message box may display.
Accept the warning to continue.

Instructions for Installing 21 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 Note: A site may experience an error message similar to the one in the following window due to
inaccessible default system temporary folder defined in the TEMP and TMP Windows
user variables.

Refer to Appendix J: Assigning an Accessible Temporary Folder to the Windows User

Variables for steps to define the TEMP and TMP Windows user variables with an
accessible temporary folder.

(The Software AG Installer window opens.)

5. Click [Advanced Options].

(The Advanced Options window opens.)

Instructions for Installing 22 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 6. Select the Use installation script check box.
(The script selection area is activated.)

Instructions for Installing 23 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 7. Ensure that the Install from script radio button is selected.
8. Click [Browse] and select the appropriate installation script. Select the
“<WMDIR>\install\sps\sr17\sag\WIN64_SINST_BASE_SR17_install.txt”.
9. Ensure that the Display Finish panel radio button is selected.
10. Click [OK].
(The Software AG Installer scripted install warning window opens.)

11. Click [Yes].

(The Software AG Installer windows open.)

12. Click [Next].

(The installer automatically goes through the user input screens based on the script.)

Instructions for Installing 24 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 Note: The installer is installing and configuring several components. It is normal for the
installer to take several minutes to complete this setup. Do not close any windows that
may open during the installation process. The installer will not install the application
correctly if a window is shut down before the installer is complete. If this happens,
contact the SPS Help Desk for instructions on how to recover.

13. Click [Close] to complete the Software AG Installer.

Instructions for Installing 25 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

4.2 Configure Broker Server

 To configure the webMethods Broker Server:

1. Open a command prompt window as an Administrator. Refer to Appendix K: Start a
Command Prompt as an Administrator for detailed instructions.
(The DOS command window opens.)

Instructions for Installing 26 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 2. Change the directory to the SPS SAG install directory, by using the following command
cd /d <WMDIR>\install\sps\sr17\sag where <WMDIR> is the fully qualified path to the
Integration Server directory (e.g., C:\SoftwareAG).
(The cd command opens.)

Note: The screenshot may look different depending on the webMethods directory the user
specified in Section 3.1.1: webMethods Setup Parameters.

3. After entering the command, press <Enter> to execute the command.

(The current directory is changed to <WMDIR>\install\sps\sr17\sag.)

Instructions for Installing 27 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 4. Execute the “00105_BROKER_SERVER_CREATE.bat” file by typing
“00105_BROKER_SERVER_CREATE.bat” and pressing <Enter>. Upon execution,
the “00105_BROKER_SERVER_CREATE.bat” file creates a broker server, a default
broker for the broker server, and displays the running broker server services.
(The 00105_BROKER_SERVER_CREATE.bat file executes.)

5. Open the Windows Services Applet and verify that the Software AG Broker Monitor and
Software AG Broker Server are “Started” or “Running”. If either service display as
“Starting”, wait for it to transfer to “Started” or “Running”.
6. Execute the “00110_BROKER_DEFAULT_CREATE.bat” file by typing
“00110_BROKER_DEFAULT_CREATE.bat” and pressing <Enter>. Upon execution,
the “00110_BROKER_DEFAULT_CREATE.bat” file creates a broker server, a default
broker for the broker server, and displays the running broker server services.
(The 00110_BROKER_DEFAULT_CREATE.bat file executes.)

Instructions for Installing 28 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

4.3 Configure Integration Server

 To configure Integration Server:

1. Open a command prompt window as an Administrator. Refer to Appendix K: Start a
Command Prompt as an Administrator for detailed instructions.
(The DOS command window opens.)

2. Change the directory to the sag install directory created by the CACI webMethods
Installer for SR17, by using the following command cd /d
<WMDIR>\install\sps\sr17\sag where <WMDIR> is fully qualified path to the
Integration Server directory (e.g., C:\SoftwareAG\install\sps\sr17\sag).
(The cd command opens.)

Instructions for Installing 29 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 Note: The screenshot may look different depending on the webMethods directory the user
specified in Section 3.1.1: webMethods Setup Parameters.

3. After entering the command, press <Enter> to execute the command.

(The current directory is changed to <WMDIR>\install\sps\sr17\sag.)

4. Execute the “00220_IS_START.bat” file by typing “00220_IS_START.bat” and pressing

<Enter>. Upon execution, the “00220_IS_START.bat” file initializes the webMethods
Integration Server’s operating environment and launches the application.
(A console window opens and shows webMethods Integration server starting.)

Instructions for Installing 30 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 Note: Informational or error type messages may be returned during the restart of the
webMethods Integration Server. If this occurs, these can be ignored.

Note: It may take several minutes for the webMethods Integration Server to start.

5. Open Internet Explorer.

(An Internet Explorer window opens.)
6. In the Address field enter “http://<server>:<port>” where <server> is the name or IP
Address of the server and <port> is the webMethods listening port. The default is 5555.
(The Enter Network Password window opens.)

Note: Port 5555 has not been assessed by DISA. The DLA is currently in the process of
working with DISA to assess this port.

Note: It may be necessary for users to add the site (http://<server>:<port>) to their trusted sites
in Internet Explorer.

Note: If the Enter Network Password window does not open, it could mean that Integration
Server is not completely started. If the Integration Server was recently started, please
wait a few minutes before trying again.

7. In the Enter Network Password window, enter the following information:

Instructions for Installing 31 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

  User Name – Enter the user name “Administrator”
 Password – Enter the password “manage”
8. Click [OK].
(The webMethods Administrator page displays.)

9. Shut down webMethods Integration server. Refer to Appendix A: Shut down

webMethods Integration Server for steps to shut down the webMethods Integration
Server instance.
10. Shut down webMethods broker services. Refer to Appendix B: Shut down webMethods
Broker Service for steps to shut down the Broker service.
11. Using the command prompt opened in step 1, execute the
“00230_IS_POST_CONFIG_REPLACE.bat” file by typing
“00230_IS_POST_CONFIG_REPLACE.bat” and pressing <Enter>. Upon execution,
the “00230_IS_POST_CONFIG_REPLACE.bat” file makes some configuration updates
to the Integration Server instance.
(The 00230_IS_POST_CONFIG_REPLACE.bat file executes.)

Instructions for Installing 32 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 12. Execute the “00240_IS_CREATE_SVC.bat” file by typing
“00240_IS_CREATE_SVC.bat” and pressing <Enter>. Upon execution, the
“00240_IS_CREATE_SVC.bat” file creates a Windows Service for the configured
webMethods Integration Server instance.
(The 00240_IS_CREATE_SVC.bat file executes.)

4.4 Apply webMethods Updates

 To validate the webMethods Integration Server installation:

1. Open a command prompt window as an Administrator. Refer to Appendix K: Start a
Command Prompt as an Administrator for detailed instructions.
(The DOS command window opens.)

Instructions for Installing 33 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 2. Change the directory to the sag install directory created by the CACI webMethods
Installer for SR17, by using the following command cd /d
<WMDIR>\install\sps\sr17\sag where <WMDIR> is fully qualified path to the
Integration Server directory (e.g., C:\SoftwareAG\install\sps\sr17\sag).
(The cd command opens.)

Note: The screenshot may look different depending on the webMethods directory the user
specified in Section 3.1.1: webMethods Setup Parameters.

3. After entering the command, press <Enter> to execute the command.

(The current directory is changed to <WMDIR>\install\sps\sr17\sag.)

Instructions for Installing 34 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 4. Execute the “00270_EXE_SUM_INSTALL.bat” file by typing
“00270_EXE_SUM_INSTALL.bat” and pressing <Enter>. Upon execution, the
“00270_EXE_SUM_INSTALL.bat” file launches the Software AG Update Manager
wizard.
(The Software AG Update Manager window opens.)

Note: If necessary, Software AG Update Manager updates itself to its latest version each time it
runs. The actual screen may differ from the screenshot depending on whether Software
AG Update Manager has already updated itself or not.

Instructions for Installing 35 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 5. Select the “Install fixes from image” Action.
6. Click [Browse] to select a Product Directory other than the default.
7. Click [Browse] to select the previously downloaded
“WIN64_SUM_UPDATE01_SR17.zip” file as the Image File Name.
(WIN64_SUM_UPDATE01_SR17.zip displays as the Image File Name.)

Instructions for Installing 36 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 8. Click [Next].
(The Select Fixes window displays.)

Instructions for Installing 37 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 9. Click [+].
(The Fix List expands.)

Instructions for Installing 38 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 10. Click [].
(All fixes are selected.)

Instructions for Installing 39 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 11. Click [Next].
(The Fix Summary window displays.)

Instructions for Installing 40 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 12. Click [Next].
(The server shutdown window opens.)

13. Click [Ok].

(The Post Install Messages window opens.)

Instructions for Installing 41 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 14. Click [OK].
(The Summary window displays.)

15. Click [Close].

(The Software AG Update Manager window closes.)

Instructions for Installing 42 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 Note: In some instances the following command prompt window for the Software AG Platform
Manager 9.8 may still remain open.

This command prompt window should be closed by clicking the X in the upper right hand corner
of the command prompt window.

4.5 Configure My webMethods Server

This section explains how to configure a My webMethods Server (MWS) instance. Each
physical machine should be configured with a single MWS instance. MWS can be configured to
use an external Relational Database Management System (RDBMS) or an internal RDBMS. If
you answered “Yes” to Section 3.2 Run the CACI webMethods Installer for SR17 Step 13, follow
the steps in Section 4.5.1 Create MWS Instance with External RDBMS. If you answered “No”,
follow the steps in Section 4.5.2 Create MWS Instance with Internal RDBMS.

4.5.1 Create MWS Instance with External RDBMS

Note: Before the MWS database can be created, ensure that the MWS Sybase Instance has been
setup based on the Sybase ASE 16.0 SP01 PL02 Configuration Guide for My webMethods
Server 9.8 guide.

Instructions for Installing 43 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 4.5.1.1 Increasing Number of User Connections for MWS Database

Note: Skip this section if the new MWS database is the first MWS database on the Sybase
instance.

The default MWS Sybase instance parameter "number of user connections" is set for a single
MWS database. For each additional MWS database on the Sybase instance, the parameter must
be increased by 15 to accommodate additional database connections.
If the new MWS database is not the first MWS database on the Sybase instance, then the
parameter must be updated.
 To update the "number of user connections" parameter:
1. Log into the MWS Sybase instance (refer to My webMethods Server Sybase Alias Name
in Table 2: MWS Setup Parameters) as “sa” (refer to Server Sybase Super User ID and
Password in Table 2: MWS Setup Parameters) using Interactive SQL.
2. Select the master database from the drop-down list box on the top right.
3. Execute the following commands to retrieve current value:
exec sp_configure 'number of user connections'
go

4. Execute commands by selecting SQL  Execute from the menu or pressing <F5>.
5. Identify the data under the Run Value column and add 15 to this value.
6. Clear the SQL Statements pane.
7. Execute the following command to increase the number of user connections, where
<NEWVAL> is the new value calculated in Step 5:
exec sp_configure 'number of user connections', <NEWVAL>
go

8. Execute commands by selecting SQL  Execute from the menu or pressing <F5>.
9. Close Interactive SQL.

4.5.1.2 Create MWS Instance

 Execute the “00302_MWS_EX_FRESH_CREATE_DB.bat” file:
1. Open a Command Prompt window as the Administrator. Refer to Appendix K: Start a
Command Prompt as an Administrator for detailed instructions. Change directory to
<WMDIR>\install\sps\sr17\sag.
2. Enter “00302_MWS_EX_FRESH_CREATE_DB.bat” in the command prompt and press
<Enter> to execute the batch file.
3. When the 00302_MWS_EX_FRESH_CREATE_DB.bat process is completed, evaluate the
following files in the <WMDIR>\install\sps\sr17\sag directory for error messages:
 step1a.out
 step1b.out

Instructions for Installing 44 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 Note: Evaluate and address any errors, as needed. Contact the SPS Help Desk with any
questions.

 Execute the “00303_MWS_EX_FRESH_ADD_TABLES.bat” file:

1. Enter “00303_MWS_EX_FRESH_ADD_TABLES.bat” in the command prompt that was
opened in the previous step and press <Enter> to execute the batch file.
2. When the 00303_MWS_EX_FRESH_ADD_TABLES.bat process is completed, close the
Command Prompt window. Evaluate the following files in the <WMDIR>\
common\db\logs\ directory for error messages:
 dcc_<TIMESTAMP>.log

Note: Evaluate and address any errors, as needed. Contact the SPS Help Desk with any
questions.

 Execute the “00304_MWS_EX_FRESH_CREATE_NEW.bat” file:

1. Open a Command Prompt window as the Administrator. Refer to Appendix K: Start a
Command Prompt as an Administrator for detailed instructions. Change directory to
<WMDIR>\install\sps\sr17\sag.
2. Enter “00304_MWS_EX_FRESH_CREATE_NEW.bat” in the command prompt that was
used in the previous step and press <Enter> to execute the batch file.
3. When the 00304_MWS_EX_FRESH_CREATE_NEW.bat process is completed, evaluate
the output in the window for error messages.

4.5.2 Create MWS Instance with Internal RDBMS

4.5.2.1 Create MWS Instance

 Execute the “00322_MWS_IN_CREATE_NEW.bat” file:
1. Open a Command Prompt window as the Administrator. Refer to Appendix K: Start a
Command Prompt as an Administrator for detailed instructions. Change directory to
<WMDIR>\install\sps\sr17\sag.
2. Enter “00322_MWS_IN_CREATE_NEW.bat” and press <Enter> to execute the batch
file.
3. When the 00322_MWS_IN_CREATE_NEW.bat process is complete, evaluate the output
in the window for error messages. If the instance was not set up, then there might be
some error messages related to not being able to connect to the data source. These can be
ignored.

4.5.3 Initialize New MWS Instance

 Execute the “00330_MWS_FRESH_START_NEW.bat” file:

1. Enter “00330_MWS_FRESH_START_NEW.bat” in the command prompt that was used
in the previous step and press <Enter> to execute the batch file.

Instructions for Installing 45 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 Note: Execution of the batch file will take approximately 20 minutes or more. When complete
the user should see something similar to the screen shot below.

2. Attempt to log into the My webMethods Server. Refer to Appendix I: Log into My
webMethods Server for the steps to log in.
3. If user is unable to log into the My webMethods Server, evaluate the log files in
<WMDIR>\MWS\server\default\logs\ directory for error messages. If no error messages
have been written to the log file wait an additional five minutes and repeat steps 2 and 3
as needed.

Note: Evaluate and address any errors, as needed. Contact the SPS Help Desk with any
questions.

 Execute the “00340_MWS_FRESH_STOP_NEW.bat” file:

1. Open a second Command Prompt window as the Administrator. Refer to Appendix K:
Start a Command Prompt as an Administrator for detailed instructions. Change directory
to <WMDIR>\install\sps\sr17\sag\.
2. Enter “00340_MWS_FRESH_STOP_NEW.bat” and press <Enter> to execute the batch
file.
3. After some time, the MWS server running on the new window as mentioned in Step 2 of
Execute 00330_MWS_FRESH_START_NEW.bat file stops and the control is returned to a
Command Prompt.
4. If necessary, close the Command Prompt window used in the Execute the
“00330_MWS_FRESH_START_NEW.bat” file.
Instructions for Installing 46 March 2016
webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

  Execute the “00350_MWS_CREATE_SVC.bat” file:
1. Open a Command Prompt window as the Administrator. Refer to Appendix K: Start a
Command Prompt as an Administrator for detailed instructions. Change directory to
<WMDIR>\install\sps\sr17\sag.
2. Enter “00350_MWS_CREATE_SVC.bat” in the command prompt that was used in the
previous step and press <Enter> to execute the batch file.
3. When the 00350_MWS_CREATE_SVC.bat process is completed, evaluate the output in
the window for error messages.

Instructions for Installing 47 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

5. webMethods Post Installation Tasks

5.1 Modify the Windows Service for webMethods Integration

Server

Execute the following steps to modify the Windows Service for webMethods Integration Server.

 To modify the Windows Service for webMethods Integration Server to use a local account:
1. From the Control Panel, select Administrative Tools  Computer Management.
2. Select Services and Applications  Services.
3. Identify the Software AG Integration Server (port) service.
4. Click on the service to select it.
5. Right-click and select Properties.
6. Click the Log On tab.
7. Select the This Account radio button.
8. Enter the local user account name.
Note: If the local user account is part of a domain, the account should be entered as
“<DomainName>\<LocalUserAccount>”; otherwise, the account should be entered as
“.\<LocalUserAccount>”.

9. Enter the password for the local user account and enter it a second time to confirm it.
10. Click [OK] to apply the changes.

5.2 Modify the Windows Service for My webMethods Server

Note: If My webMethods Server was not setup as part of Section 4.5: Configure My
webMethods Server, this section should be skipped.

Execute the following steps to modify the Windows Service for My webMethods Server.

 To modify the Windows Service for My webMethods Server to use a local account:
1. From the Control Panel select Administrative Tools  Computer Management.
2. Select Services and Applications  Services.
3. Identify the Software AG My webMethods Server 9.8 (default) service.
4. Click on the service to select it.
5. Right-click and select Properties.
6. Click the Log On tab.
7. Select the This Account radio button.
8. Enter the local user account name.

Instructions for Installing 48 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 Note: If the local user account is part of a domain, the account should be entered as
“<DomainName>\<LocalUserAccount>”; otherwise, the account should be entered as
“.\<LocalUserAccount>”.

9. Enter the password for the local user account and enter it a second time to confirm it.
10. Click [OK] to apply the changes.

5.3 Update the webMethods Logging Level

 To update the webMethods logging level:

1. Refer to Appendix D: Start webMethods Integration Server for steps to start the
webMethods Integration Server instances if not currently started.
2. Log into the webMethods Administrator if not already logged in. Refer to Appendix E:
Log into webMethods Administrator for the steps to log in.
3. Click the Settings menu in the left panel to expand that section.
4. Click the Settings > Logging link.
(The Settings > Logging page displays.)

5. Click the Server Logger link.

(The Settings > Logging > View Server Logger Details page displays.)

Instructions for Installing 49 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 6. Click the Edit Server Logger link.
(The Settings > Logging > Edit Server Logger Details page displays.)

7. Set the Logging Level of the Default Facility to Error.

(The Default Logging Level is propagated to all child Facilities.)

Instructions for Installing 50 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 8. Click [Save Changes].
(A confirmation message displays.)

Instructions for Installing 51 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

5.4 Update Resources Configuration

 To update the resources configuration:

1. Log into the webMethods Administrator if not already logged in. Refer to Appendix E:
Log into webMethods Administrator for the steps to log in.
2. Click the Settings menu in the left panel to expand that section.
3. Click the Settings > Resources link.
(The Settings > Resources page displays.)

Note: The screenshot may look different from the actual screen depending on the Server
Memory and the Server Thread Pool.

4. Click the Store Settings link.

(The Settings > Resources > Store Settings page displays.)

Instructions for Installing 52 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 5. Click the Edit Document Store Settings link.
(The Settings > Resources > Store Settings > Edit Document Store Settings page
displays.)

6. Under Default Document Store, update the Initial Store Size (MB) field to 50.

Instructions for Installing 53 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 7. Under Trigger Document Store, update the Initial Store Size (MB) field to 70.
8. Click [Save Changes].
(The Settings changed successfully message displayed.)

9. Click the Return to Resource Settings link.

(The Settings > Resources page displays.)

Note: The screenshot may look different from the actual screen depending on the Server
Memory and the Server Thread Pool.

Instructions for Installing 54 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 10. Click the Edit Resource Settings link.
(The Settings > Resources > Edit page displays.)

11. Under Server Thread Pool, update the Maximum Threads field to 300.

Instructions for Installing 55 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 Note: The appropriate setting for each operating environment may vary based on hardware,
transaction volume, transaction type, etc.. The Maximum Threads value above is
suggested based on test environments supporting the PD2 Adapter, the PD2 Archiving
Utility, and SPS Legacy Integrations. Each site should feel free to tailor this
configuration to its specific needs.

12. Under Server Thread Pool, update the Scheduler Thread Throttle field to “50.”
13. Click [Save Changes].
(The Settings changed successfully message displayed.)

Note: The screenshot may look different from the actual screen depending on the Server
Memory and the user input under the Server Thread Pool.

14. Click the Shut Down and Restart link.

(The Server > Shut Down and Restart page displays.)

Instructions for Installing 56 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 15. Select the Immediately radio button.
16. Click [Restart].
(The OK to restart this server message box displays.)

17. Click [OK].

(The Server restart confirmation message displays.)

Instructions for Installing 57 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

5.5 Restart My webMethods Server

Refer to Appendix H: Start My webMethods Server for detailed instructions on starting the My
webMethods Server.

Instructions for Installing 58 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

6. Update Dispatch File For IPV6 Environments

Note: If this instance of webMethods will be running on an machine configured for only IPV6
then this section must be completed.

Refer to Appendix M: Update Dispatch File For IPV6 Environments for detailed instructions on
modifying the dispatch.cnf configuration file.

Instructions for Installing 59 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

7. CDR Package

Note: If this instance of webMethods will not have Legacy Common Integration packages, skip
this section.

Installation of v1.0.1.68 Legacy Common file from the Q113 integrations is needed for
compatibility with the latest installation of webMethods v9.8.

Instructions for Installing 60 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

Appendix A: Shut Down webMethods Integration
Server

 To shut down the webMethods Integration Server:

1. Log into the webMethods Administrator. Refer to Appendix E: Log into webMethods
Administrator for the steps to log in.
(The webMethods Administrator page displays.)
2. Click the Shut Down and Restart link.
(The Server > Shut Down and Restart page displays.)

3. Select the Immediately radio button.

4. Click [Shut Down].
(The shutdown confirmation message box displays.)

5. Click [OK].

Instructions for Installing 61 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 (The Server shutdown is in progress message displays.)

Instructions for Installing 62 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

Appendix B: Shut Down webMethods Broker
Service

 To shut down the webMethods Broker Monitor v9.6 service:

1. Navigate to Microsoft Windows Services window.
(The Services window opens.)

2. In the Services window, locate the Software AG Broker Monitor 9.6 (port) service in
the Name column.
(The Software AG Broker Monitor 9.6 (port) service is displayed in the Services
window.)

3. Right-click the service name and select Stop from the menu.
(The Stop Other Services window opens.)

Instructions for Installing 63 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 4. Click [Yes] to stop the Software AG Broker Server 9.6 (port) service when the
Software AG Broker Monitor 9.6 (port) service stops.
(The Status column is blank.)
5. Close the Services window.
(The Services window closes.)

Instructions for Installing 64 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

Appendix C: Start webMethods Broker Service

 To start webMethods Broker Services:

1. Open the Microsoft Windows Services window.
(The Services window opens.)
2. In the Services window, locate the Software AG Broker Monitor 9.6 (port) service in
the Name column.
(The Software AG Broker Monitor 9.6 (port) service is displayed in the Services
window.)
3. Right-click the service name and select Start from the menu.
4. All broker servers associated with that Broker Monitor instance start automatically.
(The Status column for each service changes to Started.)

Instructions for Installing 65 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

Appendix D: Start webMethods Integration Server

 To start the webMethods Integration Server service:

1. Open the Microsoft Windows Services window.
(The Services window opens.)

2. In the Services window, locate the Software AG Integration Server (port) service in
the Name column.
(The Software AG Integration Server (port) service is displayed in the Services
window.)

3. Right-click the service name and select Start from the menu.
Note: It may take several minutes for the webMethods Integration Server to start completely.
The webMethods Integration Server is not completely started following the completion of
the service.

4. Close the Services window.

(The Services window closes.)

Instructions for Installing 66 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

Appendix E: Log into webMethods Administrator

 To log into webMethods Administrator:

1. Open Internet Explorer.
(An Internet Explorer window opens.)
2. In the Address field enter “http://<server>:<port>” where <server> is the name or IP
Address of the server and <port> is the webMethods listening port. The default port is
5555.
(The Enter Network Password window opens.)

Note: It may be necessary for the user to add the site (http://<server>:<port>) to their trusted
sites in Internet Explorer.

Note: If the Integration Server is not completely started, the Enter Network Password window
may not open. If the Integration Server was recently started, wait a few minutes before
trying again.

3. In the Enter Network Password window, enter the following information:

 User Name – Enter the user name “Administrator”
 Password – Enter the password “manage”
4. Click [OK].
(The webMethods Administrator page displays.)

Instructions for Installing 67 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

Appendix F: Configure Integration Server for HTTPS

 To configure Integration Server for HTTPS communication:

1. Refer to Section 7.4.8 of the PD2 Adapter v3.4 Functional User's Guide to configure
server-wide certificates.
2. Create an HTTPS port for Integration Server as described in Section 7.4.2 of the PD2
Adapter v3.4 Functional User's Guide.
3. Update the Integration Server port in MWS as described in Section 7.4.3 of the PD2
Adapter v3.4 Functional User's Guide.
4. Optional - Change the primary port to the new HTTPS port as described in Section 7.4.5
of the PD2 Adapter v3.4 Functional User's Guide.
5. Optional - Disable all HTTP ports as described in Section 7.4.6.1 of the PD2 Adapter v3.4
Functional User's Guide.

Instructions for Installing 68 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

Appendix G: Shut Down My webMethods Server

 To shut down My webMethods Server service:

1. Navigate to Microsoft Windows Services window.
(The Services window opens.)
2. In the Services window, locate the Software AG My webMethods Server 9.8 (default)
service in the Name column.
(The Software AG My webMethods Server 9.8 (default) service displays in the Services
window.)
3. Right-click the service name and select Stop from the menu.

Note: A message may display stating that windows could not stop the service, which can be
ignored by clicking [OK].

4. The My webMethods Server stops automatically.

5. Close the Services window.
(The Services window closes.).

Instructions for Installing 69 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

Appendix H: Start My webMethods Server

 To start the My webMethods Server service:

1. Navigate to Microsoft Windows Services window.
(The Services window opens.)
2. In the Services window, locate the Software AG My webMethods Server 9.8 (default)
service in the Name column.
(The Software AG My webMethods Server 9.8 (default) service displays in the Services
window.)
3. Right-click the service name and select Start from the menu.
4. The My webMethods Server starts automatically.
(The Status column changes to Started.)
5. Close the Services window.
(The Services window closes.).

Instructions for Installing 70 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

Appendix I: Log into My webMethods Server

 To log into My webMethods Server:

1. Open Internet Explorer.
(An Internet Explorer window opens.)
2. In the Address field, enter the following URL, substituting the appropriate values for
<server> and <port>: http://<server>:<port>
 <server> – hostname or IP address of the My webMethods Server.
 <port> – the port on which the My webMethods Server is running. Default port is
8585.
(The Login window opens.)

3. Enter the following

 User Name – Enter the webMethods Administrator user.
 Password – Enter the password for the Administrator user.
4. Click [Login].
(The My webMethods Home page displays.)

Instructions for Installing 71 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

Instructions for Installing 72 March 2016
webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

Appendix J: Assigning an Accessible Temporary
Folder to the Windows User Variables

 To assign an accessible temporary folder to the TEMP and TMP Windows user variables:
1. If a folder does not already exist, create a folder called “Temp” in the drive where the
webMethods Integration Server will be installed.
2. Open a Notepad.
3. Open the Control Panel and perform one of the following based on the operating system
of the machine:
 In case of Windows 2008/Windows 2012, double-click the System and then double-
click the Advanced system settings.
4. Click Advanced  Environment Variables.
5. Select TEMP under the Variable column in the User variables section.
6. Click [Edit].
7. Cut the value of the Variable value field and paste it in the Notepad opened in Step 2.
8. Fill in the Variable value field with the folder found in Step 1.
9. Click [OK].
10. Repeat Step 5 through Step 9 for the TMP Windows user variable.
11. Save the text in the Notepad opened in Step 2. Once the webMethods Integration Server
is installed successfully, the TEMP and TMP user variables should be reverted to the
values saved in this text file.
12. Restart the machine.

Instructions for Installing 73 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

Appendix K: Start a Command Prompt as an
Administrator

With User Account Control (UAC) enabled or United States Government Configuration Baseline
(USGCB) settings, it prevents programs from running administrative tasks without first
specifying that they are running as the Administrator. This topic describes how to open a
command prompt with full Administrator permissions. If your user account is a member of the
Administrators group, but is not the Administrator account itself, then, by default, the programs
that you run only have standard user permissions. You must explicitly specify that you require
the use of your administrative permissions.
Administrative Credentials
To complete these procedures, you must be a member of the Administrators group.
 To start a command prompt as an Administrator:
1. Click Start  All Programs and click Accessories.

2. Right-click Command prompt and click Run as administrator.

Note: The Windows Security Warning/User Account Control message box may display.
Accept the warning to continue.

Instructions for Installing 74 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

Appendix L: Uninstall webMethods v9.6

Note: webMethods v9.6 should only be uninstalled after all necessary product configurations
have been copied to a new installation.

 To uninstall webMethods Product Suite v9.6:

1. Open a command prompt window as an Administrator. Refer to Appendix K: Start a
Command Prompt as an Administrator for detailed instructions.
(The DOS command window opens.)

2. Launch the Programs and Features applet, by using the following command control
appwiz.cpl.
(The cd command opens.)

Instructions for Installing 75 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 3. Select the appropriate Software AG Products entry (i.e., the entry referencing the
appropriate installation directory).
4. Right-click and select Uninstall/Change.

Note: The Windows Security Warning/User Account Control message box may display.
Accept the warning to continue.

Note: A site may experience an error message similar to the following due to inaccessible
default system temporary folder defined in the TEMP and TMP Windows user variables.

Refer to Appendix J: Assigning an Accessible Temporary Folder to the Windows User

Variables for steps to define the TEMP and TMP Windows user variables with an
accessible temporary folder.

(The Software AG Installer window opens.)

Instructions for Installing 76 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 5. Click [Next].
(The Select Products to Uninstall window opens.)

Instructions for Installing 77 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 6. Click [Select All].
(All products are selected.)

Instructions for Installing 78 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 7. Click [Next].
(Broker page displays.)

Instructions for Installing 79 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 8. Click [Next].
(A list of products to be uninstalled displays.)

Instructions for Installing 80 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 9. Click [Next].
(A confirmation page displays.)

Instructions for Installing 81 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 10. Click [Close] to complete the uninstall.
11. Optionally, delete <WMDIR>, where <WMDIR> is the fully qualified path to the
webMethods v9.6 installation that was uninstalled (e.g., C:\SoftwareAG).

Instructions for Installing 82 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

Appendix M: Update Dispatch File For IPV6
Environments

Note: This section should only be executed if your webMethods environment is configured for
an IPV6 environment.

1. Shut down webMethods Integration server. Refer to Appendix A: Shut down

webMethods Integration Server for steps to shut down the webMethods Integration
Server instance.
2. Shut down My webMethods server. Refer to Appendix G: Shut Down My webMethods
Server for steps to shut down the My webMethods Server.
3. Shut down webMethods broker services. Refer to Appendix B: Shut down webMethods
Broker Service for steps to shut down the Broker service.
4. Open a command prompt window as an Administrator. Refer to Appendix K: Start a
Command Prompt as an Administrator for detailed instructions.
(The Command Prompt window opens.)

5. Retrieve the IPV6 address by executing the ipconfig command.

Instructions for Installing 83 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 6. press <Enter> to execute the command.

7. Note the full IPV6 Address as it will be used to update the dispatch.cnf file.
(ex: fe80::25f2:a9ed:57a4:a121%10 )
8. Close the command prompt window.
9. Open a command prompt window as an Administrator. Refer to Appendix K: Start a
Command Prompt as an Administrator for detailed instructions.
(The Command Prompt window opens.)

Instructions for Installing 84 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 10. Change the directory to the
<WMDIR>\ IntegrationServer\instances\<INST_NAME>\config directory by using the
following command cd /d
<WMDIR>\IntegrationServer\instances\<INST_NAME>\config where <WMDIR > is
the Software AG location and <INST_NAME> is the WebMethods Integration Server
instance name (e.g., C:\SoftwareAG\IntegrationServer\instances\default\config).

11. Enter the command and press <Enter> to execute the command.

(The directory is changed to

<WMDIR>\IntegrationServer\instances\<INST_NAME>\config.)

Instructions for Installing 85 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 12. Open the “dispatch.cnf” file using a text editor (e.g. Notepad).
(The dispatch.cnf file opens)

13. Locate and replace all occurrences of the IPV6 address with the machine name hosting
the webMethods Integration Server. The IPV6 address is embedded with in a text string.
Only the IPV6 address portion of the string is to be replaced.
(ex: Machine name is “wi2install01”

Instructions for Installing 86 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government

 The current string containing the IPV6 address in the file may look similar in format to
the following.
"fe80:0:0:0:25f2:a9ed:57a4:a121%10_5555_1458130604_AdminCli
ent"
The updated string would only have the IPV6 portion replaced with the machine name
and would like the following once updated.
"wi2install01_5555_1458130604_AdminClient")
14. Once all instances of the IPV6 address have been replaced with the machine name, save
and close the dispatch.cnf file.
15. Start the webMethods Broker Services. Refer to Refer to Appendix C: Start webMethods
Broker Service for steps to start the webMethods Broker Service.
16. Start the webMethods Integration Server. Refer to Appendix D: Start webMethods
Integration Server for steps to start the webMethods Integration Server instance.
17. Start the My webMethods Server. Refer to Appendix H: Start My webMethods Server for
detailed instructions on starting the My webMethods Server.

Instructions for Installing 87 March 2016

webMethods Product Suite v9.8

CACI Proprietary – Not for Disclosure Outside the Government