This section provides information on steps to follow after the installation.
Securing Communication Between CentraSite Application Server Tier and CentraSite Registry Repository
By default, the CentraSite installation procedure installs the Software AG Runtime on the CentraSite Application Server Tier.
You can configure your Software AG Runtime environment by adding or modifying Java system properties for Software AG Runtime. The procedures for doing this are given in the following sections.
After changing any Java system properties, the Software AG Runtime has to be restarted.
The following topics summarize the configuration possibilities.
The Java system properties are contained in the file wrapper.conf that is located in <SuiteInstallDir>/profiles/CTP/configuration.
In this file, there is a list containing properties with the syntax:
wrapper.java.additional.<n>=<value>
or
wrapper.java.additional.<n>.<string>=<value>
where <n> is an integer and <value> is the value that is assigned to the property. If a line contains <string>, it represents a qualifier for the value of wrapper.java.additional.<n> given in the previous line.
To add a new system property, you extend this list with a new entry, using the syntax without the <string> qualifier. Ensure that the value you assign to <n> is one higher than the highest value so far. The <value> that you specify is described in the following paragraphs.
Assume that the wrapper.conf file already contains
various entries of the form
wrapper.java.additional.<n>=<value>
,
and the highest value of <n> so far is 5, and
you want to add a property with the value -Dhttp.proxyPort=12345
.
In this case, you would increment the value of
<n> to 6, and the line would look like this:
wrapper.java.additional.6=-Dhttp.proxyPort=12345
If an HTTP proxy is being used to access the Internet, add the following Java system properties:
-Dhttp.proxyHost=httpprox.<3rd-level-domain>.<2nd-level-domain> -Dhttp.proxyPort=<proxy_port_number> -Dhttp.nonProxyHosts="*.<3rd-level-domain>.<2nd-level-domain>|*.<domain_1>.<extension>|*.<domain_2>.<extension>"
The <non_proxy_host_list> should contain at least the name of the host on which the CentraSite Application Server Tier is running. If there is more than one entry in the <non_proxy_host_list>, the entries are separated by the vertical bar character "|".
The following are cases of particular interest in which you may need to set the proxy settings:
In order to have access to or to import WSDL files from the Internet.
In the Software AG Runtime where CentraSite Control is running.
If you call the importer from the command line or embed the importer in an application, then these setting will also apply.
If an HTTPS proxy is being used to access the Internet, add the following Java system properties:
-Dhttps.proxyHost=<sslproxy> -Dhttps.proxyPort=<port>
Without this setting, any operation requiring HTTPS, such as importing a WSDL/BPEL/XSD file via HTTPS, may fail with messages like: "The WSDL file is unreachable. Make sure the input information is correct".
If you want to change the amount of available memory, modify the value
for -XX:MaxPermSize
, for example:
-XX:MaxPermSize=256M
Using the print feature on UNIX and Linux platforms requires Java AWT to be set to headless mode.
Examples would be for instance printing or previewing BIRT reports with the CentraSite Application Server Tier running on a Linux platform.
The parameter setting is as follows:
java.awt.headless=true
If a web application shows unexpected behavior such as
"hanging" or refuses to proceed, you should first check the
Software AG Runtime log file. The location of the current Software AG Runtime
log file is given in the logging property
"wrapper.logfile
" of the
wrapper.conf file.
You can configure a secure communication between the CentraSite Application Server Tier and the CentraSite Registry Repository by executing the following commands in the command line interface CentraSiteCommand.cmd (Windows) or CentraSiteCommand.sh (UNIX) of Command Central. The tool is located in <CentraSiteInstallDir>/utilities.
If you start this command line tool with no parameters, you receive a help text summarizing the required input parameters.
The parameters of the command are case-sensitive, so for example the parameter "-file" must be specified as shown and not as "-FILE".
To secure the CentraSite Application Server Tier, use a command of the following form:
CentraSiteCommand set AST security -file <CONFIG-FILE>
The following table describes the complete set of input parameters that
you can use with the set AST security
utility:
Parameter | Description |
---|---|
-file |
The URI (file: or http:) of the configuration file. |
For example:
CentraSiteCommand set AST security -file "config.xml"
To secure the CentraSite Registry Repository, use a command of the following form:
CentraSiteCommand set RR security -file <CONFIG-FILE>
The following table describes the complete set of input parameters that
you can use with the set RR security
utility:
Parameter | Description |
---|---|
-file |
The URI (file: or http:) of the configuration file. |
For example:
CentraSiteCommand set RR security -file "config.xml"
Terracotta BigMemory is a separately-licensed add-on product that allows you to use vast amounts of off-heap cache memory for the storage of application data. By significantly reducing the dependency on disk-based processing, applications that use BigMemory can run with huge speed increases.
For general information about Terracotta BigMemory usage within the webMethods Suite, refer to the System Requirements, Installation, and Upgrade section of the webMethods Suite on the Software AG documentation web site.
To activate BigMemory processing for CentraSite, you need to carry out the following steps:
In CentraSite, Terracotta BigMemory can be used in 3 places:
in web applications (CentraSite Control, Importers etc.) all residing in Software AG Runtime
in Eclipse/Software AG Designer environments
in client applications
Web applications in Software AG Runtime use internal mechanisms to locate the license file, so you do not need to modify anything here.
For Eclipse/Software AG Designer and client applications, you need to specify the location of the license file explicitly. The license file can be placed in any directory, but Eclipse/Software AG Designer or the client application must be started with the following Java property:
-Dcom.tc.productkey.path=<path to license file>
For example:
-Dcom.tc.productkey.path=C:\SoftwareAG\common\conf\terracotta-license.key
You need to perform some steps in order to configure CentraSite to use BigMemory.
To configure CentraSite to use BigMemory
On the CentraSite Registry Repository node, open a command line and go to the CentraSite bin directory (<SAGInstallDir>/CentraSite/bin).
Execute the script centrasite_setenv.
Execute the command:
java -jar CentraSiteCacheConfiguration.jar <CentraSite_URL> <AdministratorID> <Password> SET maxMemoryOffHeap <Size><Unit>
where Unit can be any of : k, K, m, M, g, G, t, T (for kilobytes, megabytes, gigabytes, terabytes)
For example, the command for setting a BigMemory cache of 20 gigabytes with an administrator account "INTERNAL\Admin" and password "AdminPW" would be:
java -jar CentraSiteCacheConfiguration.jar "http://localhost:53307/CentraSite/CentraSite" "INTERNAL\Admin" "AdminPW" SET maxMemoryOffHeap 20G
In order to have access to or to import WSDL files from the internet, the following Java system properties should be set for the Java Service Wrapper:
Syntax Example:
-Dhttp.proxyHost=httpprox.<3rd-level-domain>.<2nd-level-domain> -Dhttp.proxyPort=8080 -Dhttp.nonProxyHosts="*.<3rd-level-domain>.<2nd-level-domain>|*.<domain_1>.<extension>|*.<domain_2>.<extension>"
There are two occurrences in which you may need to set the proxy settings:
In the Application Server Tier (Software AG Runtime by default) where CentraSite Control is running.
If you call the WSDL importer from the command line or embed the importer in an application, then these setting will also apply.
The default behavior of the UDDI processing in CentraSite can be configured using global and local properties. These properties are set on the CentraSite Application Tier Server (CAST) where the UDDI Registry web application runs that handles UDDI client requests to CentraSite. If your environment contains more than one CAST, you can modify the properties on each CAST.
For information about setting up these properties, refer to the section Configuring the UDDI Environment in the document Access via UDDI.
The CentraSite distribution kit includes Eclipse plug-ins that allow you to use Eclipse as an alternative to CentraSite Control. You can either use the plug-ins with the Eclipse kit that is included in the CentraSite kit, or, if you already have an installed Eclipse environment, you can add the plug-ins to that environment.
The plug-ins follow the paradigms of the Eclipse Workbench: Views, editors, and a perspective are provided for displaying the contents of a CentraSite registry and repository. Actions can be carried out from context menus and toolbars. The working environment can be customized using standard Eclipse Workbench functions. For detailed information on the Eclipse Workbench, refer to the Workbench User Guide which comes with Eclipse.
The CentraSite Eclipse plug-ins include report design features which make use of the Business Intelligence and Reporting Tools (BIRT) provided by the Eclipse Foundation. You can find examples in the tutorials, which are in the Software AG documentation web site: http://documentation.softwareag.com/.
For general information about Eclipse, see http://www.eclipse.org/.
The CentraSite installation procedure includes an option to install the Software AG Designer component, which is an Eclipse installation tailored for CentraSite. If you did not select this option during the CentraSite installation, you can run the CentraSite installation procedure again, selecting just this option.
If the Software AG Designer has not yet been installed, run the Software AG Installer and select the Software AG Designer plus the CentraSite specific plug-ins as shown in the following screenshot. If you wish to perform CentraSite reporting using BIRT, select "SOA Governance" also.
Installing the Software AG Designer will, among other actions, add a suitable entry to the Windows Start menu.
If you already have an Eclipse working environment, you can install the CentraSite plug-ins in the existing environment rather than installing a new Eclipse from the CentraSite kit.
The distribution of CentraSite includes a set of Eclipse plug-ins for development purposes. The CentraSite Eclipse plug-ins provide a graphical user interface that you can use to create and manage the information in a CentraSite registry and repository.
The CentraSite Eclipse plug-ins can be used with Eclipse on any of the supported platforms.
Note:
Software AG recommends using the same version of Eclipse as Software AG Designer
uses.
The first prerequisite for Eclipse is a Java runtime environment (JRE), which can be downloaded from http://www.oracle.com/technetwork/java/index.html.
Eclipse (with the BIRT Report Designer plug-in) can be downloaded from eclipse project downloads (http://www.eclipse.org/downloads/). If you wish to use the CentraSite reporting feature (based on BIRT), you require the Eclipse IDE for Java and Report Developers. The Eclipse download page offers integrated packages that contain both BIRT and the required Eclipse software. If you do not wish to use the CentraSite reporting feature, you can use the Eclipse IDE for Java Developers.
Installing Eclipse simply copies a folder called eclipse into the file system. Consequently, uninstalling Eclipse simply means deleting this folder including all its subfolders.
The files that are created when working with Eclipse are contained in projects, which in turn are bundled in workspaces. An Eclipse workspace is a folder at an arbitrary location in the user's file system, though Eclipse suggests placing the workspace in a folder imaginatively called workspace under Documents and Settings/<userid> on the drive where Eclipse was installed. When you create an Eclipse project, the corresponding folder is created in the current workspace.
This software package includes plug-ins for the Eclipse environment (supported on Windows platforms only). These are unpacked to the installation directory and from there can be installed into your Eclipse platform. In order to use these plug-ins, the Eclipse SDK must be available as a prerequisite. Check the webMethodsSystem Requirements for the supported version of Java (http://documentation.softwareag.com/).
To install the CentraSite plug-ins in the Eclipse environment
Start the Eclipse in which the plug-ins are to be installed.
From the menu entry
, select the item to install new software. This can be for example or , depending on the Eclipse version you are using.This takes you to the Available Software dialog. On some Eclipse versions, you might instead see the Software Updates and Add-ons dialog; if so, select the tab Available Software.
Choose
or . This takes you to the dialog, where you specify the location of the plug-ins.Choose
and navigate to the following location: <SuiteInstallDir>/eclipse/updates. There you will find the zip file CentraSiteUpdateSite.zip. Select this file, and click to return to the dialog, then click .The archive location can also contain optional language packs. If you need a language pack, install it using the same method as described here.
Back in the Available Software dialog, you now see the SOA Governance category under which the plug-ins are listed.
Click
, then click .You may be asked to confirm that you want to perform the installation, and that you agree to license conditions. Select the appropriate option to confirm. When the
button is enabled, click it to start the installation.In some cases you might need to restart Eclipse after the installation has completed, in order to activate the plug-in.
You can now test that the installation was successful.
To do this, first create a report project using
, then open the perspective.Now create a BIRT report using
.Open the view
.Right-click New Data Source dialog now displays the CentraSite data sources that you can use to create the XQuery for generating CentraSite reports.
, then choose from the context menu. TheCentraSite
CentraSite XQuery
Select
from the list of data source types. Use the default data source name, then choose .Connection information about the CentraSite data source appears.
Important:
Before running the plug-ins, you must restart the Eclipse
environment.
To be able to connect the CentraSite data storage, it is necessary to establish a connection configuration. This is achieved in the Eclipse Preferences Dialog (reachable from the
menu entry). This dialog automatically pops up when connection to the data storage is first requested.In the
dialog, expand the node and click . Then click to create a new connection. In the next popup, enter the following information:Name
The name that will appear in your list of connections. If you intend
to create several connections, choose a name that will allow you to easily
identify this connection.
Host
The URL (host and port) of the Software AG Runtime, for example
http://localhost:53307.
User
The ID of a user who has permission to access the CentraSite
Registry Repository.
When you have entered these 3 fields, click OK. You will be asked to provide the password for the given user.
Choosing "Save password" avoids having to enter your password for future Eclipse sessions, but is not recommended in a security-sensitive environment.
You can check that a connection to CentraSite is possible by clicking the
button.In most scenarios the Eclipse environment's "Native" settings should provide for a flawless connection.
However, should you experience connection problems check the network connection settings (
> > > ).The proxy settings should be the same as for the Application Server Tier. In this respect pay particular attention to the non-proxy host settings (see previous chapters of this section).
We recommend starting to work with the CentraSite Eclipse plug-ins by opening the CentraSite perspective. You can do this, for example, in the following way:
Select CentraSite perspective.
in the main menu of the Eclipse Workbench, then select theYou can work with the CentraSite perspective just as you would work with any other perspective in the Eclipse Workbench. The Workbench remembers which views and perspectives you have opened, and how you have customized your working environment. The next time you open the Workbench, it appears as you have left it. For detailed information, refer to the Eclipse Workbench User Guide.
In the same way as the CentraSite Eclipse plug-ins are integrated in the Eclipse Workbench, their documentation is integrated in the help system of the Eclipse Workbench. The documentation is provided in a separate plug-in which is installed along with the software.
You can get help in the following ways:
Select
.This displays the books of the Eclipse help system. Here, you can find the CentraSite Plug-Ins User's Guide, which describes in detail how to work with the CentraSite Eclipse plug-ins.
Select a view, menu option, dialog, property page or wizard of the CentraSite Eclipse plug-ins and press F1 on the keyboard. This displays context-sensitive help for the selected element with references to the CentraSite Plug-Ins User's Guide.
The graphical Impact Analysis feature of CentraSite requires the Adobe Flash Player, which is a third party web browser plug-in. If you do not already have the Flash Player version 8 or later installed, please install it from the Adobe web site at http://www.adobe.com/.
For viewing the online documentation, a browser capable of supporting Java, JavaScript, and Cascading Style Sheets (CSS) is recommended. The documentation has been successfully tested with these products:
Microsoft Internet Explorer version 8.x.
Microsoft Internet Explorer version 7.x.
Mozilla Firefox version 3.x.
These browsers are freely available for download.
The documentation has been successfully tested with the following browser plug-ins:
Sun JVM 1.6.0
Caution:
Using Sun Java 6 update 10 may lead to problems.
We recommend going to the Java website to acquire a free Java browser plug-in.
For viewing the PDF documentation:
A PDF reader such as the Adobe Reader must be installed.
The Adobe Reader is freely available for download.
Software AG documentation uses active content (JavaScript and Java applets). With Service Pack 2 (SP2) for Windows XP, Microsoft introduced a range of powerful new security features. One effect of these security features is that warning messages appear whenever you try to display HTML pages that use active content, for example Software AG documentation, in the Internet Explorer. A typical warning message that appears in the Internet Explorer information bar is:
![]() |
Warning: To help protect your security, Internet Explorer has restricted this webpage from running scripts or ActiveX controls that could access your computer. Click here for options... |
To continue using the documentation, you can do one of the following:
Use a different web browser. This problem only affects Microsoft's Internet Explorer.
Note:
Software AG does not endorse or recommend any web browser.
Change the Internet Explorer options to allow active content to run in files on your computer.
To unblock active content
In the Microsoft Internet Explorer:
Choose
> .Choose the tab Advanced.
Scroll down to the section Security.
Check (tick) the box Allow active content to run in files on My Computer.
Choose
.Restart the Internet Explorer.
The warning messages should now no longer appear.
Click on the information bar and choose the option
. You will have to do this for each affected page.