QUICK START WITH
WEBMETHODS INSIGHT
This document consists of detailed steps of webMethods Insight
Installation,configuration and Instrumentation with webMethods
products on different platform.
By Sabreen Irfana, Software Engineer I, Software AG
1
©2016 Software AG. All rights reserved.
TABLE OF CONTENTS
INSIGHT INSTALLATION
INSIGHT INSTALLATION FOR WINDOWS
3
3
INSIGHT SERVER INSTALLATION
3
INSIGHT AGENT INSTALLTION
8
INSIGHT INSTALLATION FOR LINUX
13
INSIGHT SERVER INSTALLATION
13
INSIGHT AGENT INSTALLATION
14
DB CONFIGURATION FOR INSIGHT
16
PRE REQUISITES
16
DATABASE CONFIGURATION
16
EMBEDDED DERBY
16
SQLServer
17
ORACLE 17
CONFIGURE INSIGHT SERVER AND INSIGHT AGENT
18
INSIGHT SERVER CONFIGURATION VIA WIZARD
19
INSIGHT AGENT CONFIGURATION VIA WIZARD
27
INSTRUMENTATION
INSTRUMENTATION OF WEBMETHODS INTEGRATION SERVER( IN WINDOWS)
30
INSTRUMENTATION OF WEBMETHODS INTEGRATION SERVER (IN LINUX )
32
INSTRUMENTATION OF WEBMETHODS BROKER AND UNIVERSAL MESSAGING
33
INSIGHT UNINSTALLATION
34
INSIGHT UNINSTALLATION FOR WINDOWS
34
INSIGHT UNINSTALLATION FOR LINUX
35
INSIGHT TROUBLESHOOT
2
30
©2016 Software AG. All rights reserved.
36
INSIGHT INSTALLATION
INSIGHT INSTALLATION FOR WINDOWS
INSIGHT SERVER INSTALLATION
1. Installer available on the Empower.softwareag.com website.
Select Releases->Software AG Product Suite 9.10, Product->Insight )Actional Server and
Agent( )v2015 SP1 HF5(, Product Items based upon platform.
2. Double-click on INSIGHT_SERVER_2015.0.1.5_WIN.exe to invoke Installer
3. After a splash screen you we see the Introduction screen for the Installation.Click Next.
4. In license screen, read the License Agreements, click I accepts... and then click Next.
3
©2016 Software AG. All rights reserved.
5. Next screen will ask you to choose the Install set you wish to install.Make sure that the
Standalone radio button under Insight server is checked .After you do this, click Next.
6. Next screen select a Java VM.Please select to Choose a Java VM already installed on the
system. Select Choose a Java Executable and browse to provide location.Click Next.
4
©2016 Software AG. All rights reserved.
7. Next screen, enter the folder where you want the Insight Server product to be installed.Change the
default folder location to C:\Insight\InsightServer.
8. On the Service Configuration screen,select that you would like to run Insight Server as a Windows
service and click Next.
5
©2016 Software AG. All rights reserved.
9. Click Next to choose defaults on the Choose Shortcut Folder screen.
10. Click Install to proceed with install.
6
©2016 Software AG. All rights reserved.
11. When the install is finished you will see a screen that tells you what happened.Click Done to finish.
12. If not already started,start Insight server service using Start ->Services->Insight Server
Run Insight Server Service (Note: Insight Server service should already be started
after installtion).
7
©2016 Software AG. All rights reserved.
INSIGHT AGENT INSTALLTION
1. Installer available on the Empower.softwareag.com website.
Select Releases->Software AG Product Suite 9.10, Product->Insight )Actional Server and
Agent( )v2015 SP1 HF5(, Product Items based upon platform.
2. Double-click INSIGHT_AGENT_2015.0.1.5_WIN.exe.
3. After a splash screen you we see the Introduction screen for the Installation.Click Next.
8
©2016 Software AG. All rights reserved.
4. In license screen, read the License Agreements, click I accepts... and then click Next.
5. To install webMethods Insight Interceptors,scroll down untill you see the required
interceptor,select checkbox, all th sub checkboxes will be selected automatically and
click Next.
9
©2016 Software AG. All rights reserved.
6. In next screen select a Java VM.Please select to Choose a Java VM already installed
on this system. Select Choose a Java Executable and browse to location.Click Next.
7. Next screen, enter the folder where you want the Insight Agent to be installed.Change the default
folder to location C:\Insight\InsightAgent as shown in the screen.
10
©2016 Software AG. All rights reserved.
8. On the Service Configuration screen,select that you would like to run Insight Agent
as a Windows service and click Next.
9. Click Next to choose defaults on the Choose Shortcut Folder screen.
11
©2016 Software AG. All rights reserved.
10. Click Install to proceed with installation.
11. When the install is finished you will see a screen that tells you what happened.Click Done to finish.
12
©2016 Software AG. All rights reserved.
INSIGHT INSTALLATION FOR LINUX
Installer available on the Empower.softwareag.com website.
Select Releases->Software AG Product Suite 9.10, Product->Insight )Actional Server and
Agent( )v2015 SP1 HF5(, Product Items based upon platform.
INSIGHT SERVER INSTALLATION
Insight server Installation in Linux can be done directly by executing the command with some or all
parameters or we can specify these parameters in an “server.property” file
1
Command to do silent installation of Insight server.
Insight Server Installation with default options
./INSIGHT_SERVER_2015.0.1.5_LNX.bin -i silent -DUSER_INSTALL_DIR=
/home/<Any LinuxUser>/Insight/InsightServer -Ddebug.file=
/home/<AnyLinuxUser>/InsightServer/log/Server_install.log
Insight Server Installation with parameters defined
./INSIGHT_SERVER_2015.0.1.5_LNX.bin -i silent -DUSER_INSTALL_DIR=
/home/<Any LinuxUser>/Insight/InsightServer -Ddebug.file=
/home/<AnyLinuxUser>/InsightServer/log/Server_install.log
-Ddebug.mode=true -Dlgserver=true -Ddocs.all.docs=true
2
Installtion using server.property file
Create a server.property file and add following options in server.property file
INSTALLER_UI=silent
debug.mode=true
USER_INSTALL_DIR=/home/Insight/InsightServer
debug.file=/home/<AnyLinuxUser>/InsightServer/log/server_install.log
lgserver=true
docs.all.docs=true
and then run the command
sh ./INSIGHT_SERVER_2015.0.1.5_LNX.bin -f server.property
Note:
13
If Inisght Server is installed with default options directly under /home/ then
default Insight server installation debug file log is present under /var directory,
else in the custom defined location
©2016 Software AG. All rights reserved.
INSIGHT AGENT INSTALLATION
Insight Agent Installation in Linux can be done directly by executing the command with some or all
parameters or we can specify these parameters in an “Agent.property” file
1. Command to do silent installation of Insight Agent
Insight Agent Installation with default options
./INSIGHT_AGENT_2015.0.1.5_LNX.bin -i silent -DUSER_INSTALL_DIR=
home/<Any LinuxUser>/Insight/InsightAgent
Insight Agent with specific parameters defined
./INSIGHT_AGENT_2015.0.1.5_LNX.bin -i silent -DUSER_INSTALL_DIR=
/home/<Any LinuxUser>Insight/InsightAgent -Dlgagent=true
-Ddebug.file=/home/<AnyLinuxUser>/InsightServer/log/Agent_install.log
-Ddocs.all.docs.int=true -Dinterceptors.ws.int=true
Note: If Inisght Server is installed with default options directly under /home/ then
default Insight server installation debug file log is present under /var directory,
else in the custom defined location
2
Installtion using Agent.property file
Create a Agent.property file and add following options in Agent.property file
INSTALLER_UI=silent
debug.mode=true
USER_INSTALL_DIR=/home/Insight/InsightAgent
debug.file==/home/<AnyLinuxUser>/InsightServer/log/Agent_install.log
lgagent=true
docs.all.docs=true
docs.all.docs.analyzers=true
interceptors.ws.int=true
and then run the command
sh ./INSIGHT_AGENT_2015.0.1.5_LNX.bin -f Agent.property
14
©2016 Software AG. All rights reserved.
To configure Analyzer

If Analyzer is not configured properly, we will get exception while provisioning (ANALYZER0038:
Unable to create the configuration directory /var/opt/actional/LG.Interceptor.)

So we have to create a new file post-custom.sh , under
/<InsightAgentInstallation>/Common/scripts/
and edit post-custom.sh file to add the parameter mentioned below .
ACTIONAL_INTERCEPTOR_CONFIG_DIR=/<InsightAgentInstalltion>/LG.Interceptor
Start both Agent and server
Navigate to cd /home/InsightServer/DefaultProfile/bin/
./StartActionalServer.sh
Navigate to cd /home/InsightAgentcd/DefaultProfile/bin/
./StartActionalAgent.sh
15
©2016 Software AG. All rights reserved.
DB CONFIGURATION FOR INSIGHT
PRE REQUISITES
1. Create an empty database (Example: INSIGHT) in SQL SERVER.
2. Create a new user (Example: Insight) with password (Example: Pasw0rd@12345).
3. Make sure that the user ID (Insight) has permissions to create and update tables in the new
database (Insight).
4. Execute the following database script.
C:\<Insight Server Installation folder>\config\SQL\SQLServer\ActionalServerCreationScript.sql
DATABASE CONFIGURATION
EMBEDDEDD ERBY
Select Database Type: Embedded Derby
If we select DB type as Embedded type then DB user,password,URL will be
autocreated
Click VERIFY DATABASE to validate a successful connection to the external
16
©2016 Software AG. All rights reserved.
SQLServer
Following are the details used for configuration:
Database Type:External JDBC Driver
Database Functionality: Server
User name: <DB User Name>
Password : <DB Password>
URL: jdbc:sqlserver://<db-server-host>:<Port>;DatabaseName=<DB Name>
(Example: jdbc:sqlserver://vmasku02:1433;DatabaseName=INSIGHT)
JDBC driver name: com.microsoft.sqlserver.jdbc.SQLServerDriver
Upload New Jar File: sqljdbc4.jar
Click VERIFY DATABASE to validate a successful connection to the external
ORACLE
Following are the details used for configuration:
Database Type:External JDBC Driver
Database Functionality: Server
User name: <DB User Name>
Password : <DB Password>
URL: jdbc:oracle:thin:<db-Username>/<db-Password>/@<hostname>:<port>:<serviceName>
(Example: jdbc:oracle:thin:actional/actional@localhost:1522:ORCL)
JDBC driver name: com.microsoft.sqlserver.jdbc.SQLServerDriver
Upload New Jar File: sqljdbc4.jar
Click VERIFY DATABASE to validate a successful connection to the external
17
©2016 Software AG. All rights reserved.
CONFIGURE INSIGHT SERVER AND INSIGHT
AGENT

Start Insight server service using Start->All programs->Insight Server->Run Insight Server
Service(Note: Insight Server service should already be started after installtion for windows).

Start Insight Agent service using Start->All programs->Insight Agent->Run Insight Agent
Service(Note: Insight Server service should already be started after installtion for windows).

Open the Insight server console type clicking Start->All Programs->Insight Server->Administration
Console (for windows).

Open the Insight server console type clicking Start->All Programs->Insight Agent->Administration
Console (for windows).
InsightServer URL as http://<hostname>/4040
InsightAgent URL as http://<hostname>/4041
18
©2016 Software AG. All rights reserved.
INSIGHT SERVER CONFIGURATION VIA WIZARD
1. Navigate to Insight Server URL ,start with the registration process. Click Start begin.
2. On the License Information screen, Update the Insight License file.
19
©2016 Software AG. All rights reserved.
3. Choose the actional-license.txt file as license and upload it,after uploading verify tha status
accepted has to be visible.
20
©2016 Software AG. All rights reserved.
4. Provide Administrator user name as Administrator and password as manage for the Insight
Server. Click Next.
21
©2016 Software AG. All rights reserved.
5. Next Screen ,you will provide the credentials that the Agent will use to authenticate themselves
with the server.Provide the Username as Administrator and password as manage and click
Next.
Subscriber URL consists of Agent Url which is automatically displayed.
you can change the subscriber URL if the other hostname Agent you need to use.
6. In Next Screen configure for the mail server.
If hMailServer and Mozilla Thunderbird is installed in your localhost and configured
then provide the server name: localhost
Port:25
Sender Email:<Email id>
Username: <Email id>
password: manage
Test Email Address: <Provide the same Email ID or diffrent one>
After entering click Test Email Address,This will verify a Email is working and a test email will be
send to your account
22
©2016 Software AG. All rights reserved.
7. In Next screen, configure for Database as shown below and upload Sqljdbc jar,if External JDBC
Driver is used and click verify the database connection, connection should be successfull.click
Next button
23
©2016 Software AG. All rights reserved.
24
©2016 Software AG. All rights reserved.
If there is no specification of DB type is required and if we dont to want to store & verify tha tables
contents we can create derby database
In this case we need to provide the Database Type: Embedded Derby and click verify Database.
25
©2016 Software AG. All rights reserved.
8. Click Finish on the summary screen to complete the installation and you will be asked to log into
the Insight Server Screen.Enter Administrator as the user name and manage as password click
OK to proceed to Insight Server Console
NOTE: Before Loging in to the Insight server, install Adobe Flash Player
26
©2016 Software AG. All rights reserved.
INSIGHT AGENT CONFIGURATION VIA WIZARD
1. Now you will configure for InsightAgent,
Click on Start->All Programs->Insight Agent and select “Administration console” in windows or
in browser provide InsightAgent URL as http://<hostname>/4041
2. 4041 is the default port for InsightAgent.
3. You will see the screen that indicates that the installation completed successfully.Click Start
button to begin.
4. You can skip the license key step.
5. When provisionning the first node to the Insight,Insight Server will also publish a corresponding
license key.This license key is part of the file we imported while configuring Insight Server.
(Note: Provisioning is the process by which an instance of Insight Server pushes configuration to
the agents it has under management.A node is scheduled for provisioning when it is taken under
management by InsightServer. When provisioning occurs, ths configuration data is transferred and
written to the Insight Agent’s configuration file.)
or you can also provide the License Number which is provided below #Insight Flex Point in Insight
Licnse file
27
©2016 Software AG. All rights reserved.
6. Enter the username and password as Administrator and manage and click Finish.
now you will be asked to log in to the Insight Agent,provide the username and password, then
Insight Agent console will appear.
28
©2016 Software AG. All rights reserved.
29
©2016 Software AG. All rights reserved.
INSTRUMENTATION
INSTRUMENTATION OF WEBMETHODS INTEGRATION
SERVER )IN WINDOWS(
For Integration Server information to appear in the managed node,you need to Instrumenet the Integration
server.
Steps are listed below:
1. Stop Integration Server Application,if running.
2. Navigate to <SoftwareAg product Installtion Directory>\profiles\IS_default\bin and identify
runtime.bat file.
3. open the file and look for the line, Add your code before this line.
set JAVA_RUN=%JAVA_EXEC% %JAVA_MEMSET% -server
4. Add the following line
call <InsightAgent Installtion path>\interceptors\sag-is\actionalinstrument.cmd -tanuki –all
here option “all” is used to monitor everything (all incomming and outgoing calls) in
Integration Server
5. Start the Integration Server
30
©2016 Software AG. All rights reserved.
6. To make sure the Instrument is successfully happened or not, place navigate to IS logs
<SoftwareAgProducts>\IS_default\logs\wrapper.log file and search for word Actional...
31
©2016 Software AG. All rights reserved.
INSTRUMENTATION OF WEBMETHODS INTEGRATION
SERVER )IN LINUX(
1.
2.
3.
4.
Shutdown the server (Integration server, Insight Agent) if running.
Navigate to /<SoftwareAGproductInsatalltionFolder> /profiles/IS_default/bin
Edit sag910 file .
Inside start function, Add these lines of configuration within start function.
start()
{
ACTIONAL_HOME=/home/Insight/InsightAgent/interceptors/sag-is/
source $ACTIONAL_HOME/actional-instrument.sh
actional_instrument -tanuki -all
***rest of the contents in start function remains same
}
5. Restart Integration server.
6. Locate Integration server wrapper log and look for the message Actional logging to System.err.
32
©2016 Software AG. All rights reserved.
INSTRUMENTATION OF WEBMETHODS BROKER AND UNIVERSAL
MESSAGING
Intrumentation of Broker and UM is same in both Windows and Linux


Point to location <InsightAgent Directory>/interceptors/sag-is/ (Note: In Linux)
Point to location <InsightAgent Directory>->interceptors->sag-is (Note: In Windows)
place the interceptor actional-webmethods-broker-client-interceptor.jar in
 <Borker Installtion Directory>/lib
 <UM installation Directory>/lib
and restart the Broker and UM server.
33
©2016 Software AG. All rights reserved.
INSIGHT UNINSTALLATION
INSIGHT UNINSTALLATION FOR WINDOWS
1. Launch Insight Agent Uninstaller
2. Click Next and select complete Uninstall
34
©2016 Software AG. All rights reserved.
3. Click Next and before proceding further make sure Insight Agent is stoped, then click continue
Action of Uninstalling Insight Agent is triggered.
Please wait untill complete Uninstalltion of Insight Agent happens and then click Done
after successfull installtion if Insight Agent
Repeat the same steps for Uninstalling Insight Server
INSIGHT UNINSTALLATION FOR LINUX
Navigate to cd /<Insight_Server_Install_Directory>/ Uninstall_Actional_Server/
./Uninstall_Actional_Server
Navigate to cd / Insight_Agent_Install_Directory / Uninstall_Actional_Agent/
./Uninstall_Actional_Agent
Then delete Insight Server,Agent Folder,Registery Files,.InstallAnywhere File for successfull completion
of Insight Uninstallation in linux
Registery Files of Insight are: “.com.actional.registry.xml, .com.zerog.registry.xml”
and these register files can be found in userdirectory where Inisght is installed or in /var directory
35
©2016 Software AG. All rights reserved.
INSIGHT TROUBLESHOOT
Various problems such as options that are unavailable during installation even when
a feature is no longer installed on the target computer, incorrectly installed product (several parts
missing), may be a result of incorrect or outdated installer registry files that prevent the java installer
from working properly.
These issues are generally resolved by removing the “registry” files that list the software installed
by the ZeroG InstallAnywhere installer. Note that these registry files may contain information about
non-Actional products installed using InstallAnywhere or other ZeroG installer products.
Windows Registry Files
If any of these happens on a Windows system, you should delete two folders on the machine that
is experiencing the problematic installation:
C:\Program Files\Actional\Registry
(this folder contains the .com.actional.registry.xml file)
C:\Program Files\Zero G Registry
(this folder contains the .com.zerog.registry.xml file).
Once these two files are deleted, the installer will run correctly on that particular machine.
UNIX Registry Files
If any of the above mentioned problems happens on a Unix system, you should locate and delete
the following registry files that have been created during a previous installation:
.com.actional.registry.xml
.com.zerog.registry.xml
These files may be created in different locations depending on the login used when the software
has been installed. If the software has been installed by an unprivileged user, both files will be
written to the user's home directory. If the software has been installed directly by the root user,
both files will be written to the /var directory.
Important: These two registry files are hidden files, so when looking for them in the respective
folders, make sure you are able to view hidden files.
36
©2016 Software AG. All rights reserved.
37
©2016 Software AG. All rights reserved.
Download PDF
Similar pages