You can install Java CAPS in either of two ways:
- In the "classic" repository-based style, where adapters are installed as SAR files.
- In the "modern" style without a repository, where adapters are accessed as JCA resources.
Quick Start Installation Steps: Repository-Based
This summary assumes you will perform a complete installation of all base products on a single Windows machine. It also assumes that you might optionally also install additional products on the same machine. Within the base products, only the Repository, NetBeans IDE, and Application Server are required for design-time operations. However, it is recommended that you install all base products. For example, installing Enterprise Manager at this point in the process will later allow you to upload eWay adapters and other SAR files, to download additional repository-based plug-ins, and to access tools for monitoring and administration.
- To install the base products, you will run JavaCAPS6.exe and, in the installation wizard, supply values for various parameters.
For steps and parameter values, refer to the base products installation procedure.
- To install additional "classic" products, you will start the Repository, start Enterprise Manager, and upload one or more SAR files.
For steps and parameter values, refer to the installation procedure for additional repository-based products.
To Install Java CAPS Base Products, Including Repository
Performing a complete installation of base components on a single Windows machine (minimum 2.0 GB RAM) requires approximately 30 minutes.
- Navigate to the [$$tbd$$] directory.
- Double-click JavaCAPS6.exe to start the installation wizard.
- Supply site-specific parameter values, and retain default parameter values, as noted below.
Default installation parameter values are as follows:
| Component |
Installation parameter name |
Default value |
| Java CAPS |
Java CAPS location |
C:\JavaCAPS6 |
| Java Developer Kit |
JDK location |
(JAVA_HOME setting, such as:)
C:\Program Files\Java\jdk1.5.0_13 |
| Repository |
Name |
repository1 |
|
Admin port numbers |
12000 through 12009 |
| Application Server |
Admin user name |
admin |
|
Admin password |
adminadmin (masked) |
|
Master password |
changeit (masked) |
|
Admin port number |
4848 |
|
HTTP port number |
8080 |
|
Secure HTTP port number |
8181 |
|
JMS port number |
7676 |
|
JMX admin port number |
8686 |
|
IIOP port number |
3100 |
|
Secure IIOP port number |
3820 |
|
Mutual authentication IIOP port |
3920 |
| Java Message Server |
OS platform |
Windows32 (or different site-specific platform) |
|
STCMS port number |
18007 |
|
Secure STCMS port number |
18008 |
|
Migration directory |
(none; or site-specific) |
| Enterprise Manager |
EM host name |
localhost (or actual machine name) |
|
EM port number |
15000 |
To Install Additional "Classic" CAPS Products and Components
The following steps are intended to summarize. For details on specific products and components, refer to the installation documentation.
- Open the C:\JavaCAPS folder.
- Start the repository by double-clicking the start_repository shortcut.
- Start a new browser session and point your browser at the URL for the Java CAPS Uploader:
http://localhost:12000
- Log in to the Uploader:
- username: Administrator
- password: STC (masked)
- Use the Administration tab to install additional products in the form of SAR files, as needed:
- The Core Products folder includes: Alert Agent and SNMP Agent, eIndex and eView, and migration tools.
- The eWay folder includes adapters for CICS, COM, LDAP, TCPIP, and many others.
- The OTD folder includes message libraries for EDIFACT, HIPAA, HL7, X12, and others.
- The eGate API Kit folder includes API Kits for many operating system platforms.
- The JMS Grid folder includes an alternative JMS for many operating system platforms.
- The Auxiliary folder contains a browser plug-in for SVG graphics displayed by Enterprise Manager.
- As needed, use the Downloads tab to load files locally so you can extract their contents.
This concludes the steps for installing "classic" CAPS products. To exercise them, you can try out any of the repository-based end-to-end scenarios supplied with Java CAPS or the various adapters.
Installation Steps: No Repository
This summary assumes you will perform a custom installation of the NetBeans IDE and Application Server on a single Windows machine. It also assumes that you might optionally also install the Adapter Pack on the same machine.
- To install the base products, you will run JavaCAPS6.exe and, in the installation wizard, supply values for various parameters.
For steps and parameter values, refer to the base products installation procedure.
- To install additional "classic" products, you will use the NetBeans IDE to load and deploy additional NetBeans plug-in (NBM) files.
For steps and parameter values, refer to the installation procedure for JCA adapters.
Quick Start Installation Steps: No Repository
Performing a custom installation of these base components on a single Windows machine (minimum 1.5 GB RAM) requires approximately 15 minutes.
To Custom-Install Java CAPS
- Navigate to the [$$tbd$$] directory.
- Double-click JavaCAPS6.exe to start the installation wizard.
- At the "Choose Install Set" step, choose the "Custom option and click Next.
- Supply site-specific parameter values, and retain default parameter values, as noted below.
Default installation parameter values are as follows:
| Component |
Installation parameter name |
Default value |
| Java CAPS |
Java CAPS location |
C:\JavaCAPS6 |
| Java Developer Kit |
JDK location |
(JAVA_HOME setting, such as:)
C:\Program Files\Java\jdk1.5.0_13 |
| Application Server |
Admin user name |
admin |
|
Admin password |
adminadmin (masked) |
| Application Server |
Admin user name |
admin |
|
Master password |
changeit (masked) |
|
Admin port number |
4848 |
|
HTTP port number |
8080 |
|
Secure HTTP port number |
8181 |
|
JMS port number |
7676 |
|
JMX admin port number |
8686 |
|
IIOP port number |
3100 |
|
Secure IIOP port number |
3820 |
|
Mutual authentication IIOP port |
3920 |
| Java Message Server |
OS platform |
Windows32 (or different site-specific platform) |
|
STCMS port number |
18007 |
|
Secure STCMS port number |
18008 |
|
Migration directory |
(none; or site-specific) |
Installing the JCA Adapter Pack
The following steps are intended to summarize. For details on specific products and components, refer to the installation documentation.
Installing the Adapter Pack requires approximately 30 minutes and comprises the following tasks:
- Locally extract the files in AdapterPack.zip
- Start the NetBeans IDE and set up the plug-in installation
- Add plug-ins from commonlib
- Add specific plug-ins for specific adapters
- (optionally) Set up resources for the application server
To Extract the Files in AdapterPack.zip
- Create or navigate to a temporary folder such as C:\temp\.
- Copy AdapterPack.zip and AdapterPack.info to the temporary folder.
- Locally extract the files in AdapterPack.zip,such as:
- Runtime\common\common\...\com.stc.*.jar
- Runtime\adapters\adapters\sun-*.rar
- NetBeansModules\*.nbm
- NetBeansModules\commonlib\*.nbm
To Set Up for the NetBeans Plug-in Installation
- Navigate to the C:\JavaCAPS folder.
- Start the NetBeans IDE by double-clicking the start_netbeans shortcut.
- In the NetBeans IDE, select Tools -> Plugins.
- In the Plugins dialog box, under the Settings tab, deactivate current update centers by deselecting all checkboxes.
To Add Plug-Ins From commonlib
- In the Plugins dialog box, under the Downloaded tab, click the Add Plugins button.
- In the Add Plugins dialog box, navigate to the ...\Adapter_Pack\NetBeansModules\commonlib\ folder.
- Select all of the *.nbm files and click the Open button.
- Click the Install button, then Next, then Install, and then Finish.
- Wait for NetBeans to restart.
Add Specific NetBeans Plug-ins for Specific Adapters
- In the NetBeans IDE, select Tools -> Plugins.
- In the Plugins dialog box, under the Downloaded tab, click the Add Plugins button.
- In the Add Plugins dialog box, navigate to the ...\Adapter_Pack\NetBeansModules\ folder.
- Select on or more *.nbm files for the adapters you want to install, and then click the Open button.
- Click the Install button, then Next, then Install, and then Finish.
- Wait for NetBeans to restart.