Installing Secure Trading Agent

This manual provides instructions on how to install Sun ONE Integration Server, Secure Trading Agent on Solaris™ and Windows platforms. It also provides configuration information for your Secure Trading Agent installation and shows you how to uninstall Secure Trading Agent.

Secure Trading Agent Distribution

---

The Secure Trading Agent installation program and related installation files are available either on CD ROM or by download from the following location:

http://wwws.sun.com/software/download/

The installation files are the same, whether you are installing from a CD ROM or downloading the files. Table 3 lists the installation files for Secure Trading Agent.

Table 3    Installation Files for Secure Trading Agent 

File	Platform	Description
S1ISSTA-1_0_0-win.exe	Windows	Executable file that installs Secure Trading Agent on supported Windows platforms.
j2sdk-1_4_0_01-windows-i586.exe	Windows	Executable file that installs the supported version of the Java™ 2 SDK on Windows platforms.
S1ISSTA_1_0_0_sol8.tar	Solaris 8	Archive file that contains the files needed to install Secure Trading Agent on Solaris 8 platforms. You must extract the contents of this file before beginning the installation.
S1ISSTA_1_0_0_sol9.tar	Solaris 9	Archive file that contains the files needed to install Secure Trading Agent on Solaris 9 platforms. You must extract the contents of this file before beginning the installation.

Secure Trading Agent Components

---

The Secure Trading Agent installer installs the components listed in Table 4.

Table 4    Secure Trading Agent Components  

Module	Description
Message Handler	Secure Trading Agent service that listens for inbound messages and forwards outbound messages to destinations specified in ebXML agreements.
Java 2 Software Development Kit (Java 2 SDK), Standard Edition	Refer to Table 8 for the supported versions of the Java 2 SDK. The Solaris installation program includes the installer for the SDK. For Windows installations, you must download the SDK separately. You must install the Java 2 SDK prior to installing Secure Trading Agent.
Apache Tomcat, version 4.0.1 (Solaris) Apache Tomcat, version 4.0.3 (Windows)	Web server that hosts Secure Trading Agent. The installer installs Apache Tomcat if it is not installed on your system. If Apache Tomcat had previously been installed on your system, then the installer installs a Tomcat instance for Secure Trading Agent.
HSQL Database engine, version 1.7.0	Default database service used by Secure Trading Agent. Refer to the chapter, "Secure Trading Agent Administration" in the Secure Trading Agent User's Guide for information on configuring Oracle as the database service for Secure Trading Agent.
Sun Management Center	Web server that launches the Secure Trading Agent Communications Center.
Secure Trading Agent Communications Center	Secure Trading Agent web-based application for importing and deploying ebXML agreements, and for sending and receiving messages based on the agreements. This application also launches an Agreement Editor for creating and editing ebXML agreements.
ebScript utility	Secure Trading Agent scripting utility that provides a command-line equivalent to the Secure Trading Agent Communications Center.
Secure Trading Agent Control Panel	Configuration tool available as a command line utility. A read-only version of the Control Panel is available from the Secure Trading Agent Communications Center.

Installed Directory Structure

---

This section describes the key directories created when you install Secure Trading Agent. Table 5 contains paths to the default installation locations for Solaris. Table 6 contains paths to the default installation locations for Windows. Table 7 describes key directories and files installed under your Secure Trading Agent installation for both platforms.

Table 5    Default Installation Paths for Solaris Platforms 

Directory Path	Description
/opt/SUNWebXML/S1ISSTA	Default installer location for Solaris. You can specify an alternate location during install time.
/opt/SUNWtcatu	The root of your Apache Tomcat installation. This is where the installer places Apache Tomcat.

Table 6    Default Installation Paths for Windows Platforms 

Directory Path	Description
C:\Sun\S1ISSTA	Default installer location for Windows. You can specify an alternate location at install time.
C:\Sun\S1ISSTA\tomcat	This is where the installer places Apache Tomcat.

Table 7 lists significant child directories to the Secure Trading Agent S1ISSTA directory. The permissions of S1ISSTA and most of its contents allow access by the Secure Trading Agent administrator only.

Table 7    Child Directories to Secure Trading Agent's S1ISSTA Directory 

Directory	Contents
bin	Executable files for Secure Trading Agent and its utilities. These include: Secure Trading Agent Control Panel (ebctl) Message Handler (ebmsh) ebScript Utility (ebscript)
conf	Stores user and password information.
config	Internal configuration files for Secure Trading Agent.
docs	Directories for examples, manuals, and online help files.
etc	Holds files generated and used by the registration procedure.
install	Contains scripts and web applications used by Secure Trading Agent.
install/scripts	Internal scripts used by Secure Trading Agent.
install/webapps	Directories and files used by Secure Trading Agent web applications.
jdbc	Repository for the HSQL database service.
lib	Jar files used internally by Secure Trading Agent.
log	Log files for tomcat servers and HSQL database service.
smc	Used by the installer when installing the Sun Management Center.
tmp	Log files generated from Secure Trading Agent services.
tomcat	The root directory of the Apache Tomcat instance for Secure Trading Agent applications.

Requirements

---

Table 8 lists the minimum platform and hardware requirements for operation of Secure Trading Agent.

Table 8    Secure Trading Agent Requirements 

Component	Windows Requirement	Solaris Requirement
Operating system	Windows 2000 Professional Service Pack 3 Windows 2000 Server Service Pack 3 Windows 2000 Advanced Server Service Pack 3 Windows-XP Professional Service Pack 1	Solaris 8 or Solaris 9 (SPARC® platforms) See Release Notes for required patches.
CPU	500 Mhz	Sun Ultra™ 1 (or compatible) workstation
RAM	256 Mbytes	256 Mbytes
Disk space	30 Mbytes for Secure Trading Agent and associated applications. 60 Mbytes for Sun Management Center and associated packages, which include Java 2 Platform, Standard Edition (J2SE™ Platform), Sun ONE Application Framework software, and Apache Tomcat If you use HSQL as a database, then you have additional disk space requirements for your installation. This additional space requirement is dependent on the number and size of messages you plan to send. Refer to the Secure Trading Agent Release Notes for more information	20 Mbytes for Secure Trading Agent and associated applications 130 Mbytes for Sun Management Center and associated packages, which include J2SE, Sun ONE Application Framework software, and Apache Tomcat If you use HSQL as a database, then you have additional disk space requirements for your /var partition. This additional space requirement is dependent on the number and size of messages you plan to send. Refer to the Secure Trading Agent Release Notes for more information
/tmp partition	(not applicable)	120 Mbyte minimum size for /tmp partition
Java 2 Software Development Kit (Java 2 SDK), Standard Edition	Version 1.4.0_01 required for Windows platforms. Install this version of the Java 2 SDK before running the Secure Trading Agent installer. This version is available from the same location you downloaded Secure Trading Agent.	Version 1.4.0_00 required for Solaris platforms. The Secure Trading Agent installer for Solaris prompts you to install the correct version of the Java 2 SDK if it cannot find it on your system.
Oracle® database: Oracle 8i, Oracle 9i (if overriding the default HSQL database)	(Database requirement is not platform dependent)	(Database requirement is not platform dependent)
Web browser	Netscape Navigator™ 7.01 Internet Explorer 6.0	Netscape Navigator 7.01

Secure Trading Agent Administrator

There must be a user on your system that you can designate as the Secure Trading Agent administrator before you install Secure Trading Agent. The administrator is the only user that has permission to start and stop the Secure Trading Agent message handling service.

After installation, to change the Secure Trading Agent administrator, run the Control Panel as root on Solaris platforms or with Windows administrator privileges on Windows platforms. For more information on using the Control Panel, refer to the "Secure Trading Agent Administration" chapter in the Secure Trading Agent User's Guide.

Installation Procedure for Solaris Platforms

---

This section describes the procedure to install Sun ONE Integration Server, Secure Trading Agent on Solaris. This procedure installs both the Sun Management Center and Secure Trading Agent.

Before Installing Secure Trading Agent

Before installing Secure Trading Agent do the following:

• Obtain the Secure Trading Agent distribution either on CD ROM or by downloading as described in "Secure Trading Agent Distribution".
• Make sure you have a user on your system that you can designate as the Secure Trading Agent administrator, as explained in "Secure Trading Agent Administrator".
• Make sure you have root access on your system.

You must be root to perform the installation procedure.

• Make sure your DISPLAY variable is correctly set, and that root has access to your display
• Uninstall any previous installed version of Secure Trading Agent before you begin the installation procedure.

Refer to "Uninstall Procedure for Solaris Platforms" for information on how to uninstall Secure Trading Agent.

Alternate Procedures for Solaris Platforms

The procedures for installation in this manual use a graphical dialog to guide you through the installation process. Solaris platforms provide the following alternate procedures that do not use a graphical dialog to guide you through installation:

• Full installation (Sun Management Center and Secure Trading Agent)

Uses the setup.sh script with the --nogui option.

• Solaris package commands

Uses pkgadd and pkgrm to install and uninstall Secure Trading Agent as the SUNWebXML package

For information on these procedures, refer to the "Secure Trading Agent Administration" chapter in the Secure Trading Agent User's Guide.

Installation Procedure

The following procedure first installs the Sun Management Center and then provides a dialog to guide you through the Secure Trading Agent installation process.

To install Secure Trading Agent on Solaris platforms

1. Login as root.

You must have root privileges to perform this procedure.




---

Note	If you use su to become root on your system, make sure you allow root access to your display using xhost. For example, specify xhost + to grant access to all users.

---




2. Make sure your DISPLAY environment variable is correctly set.

The install fails if it cannot open a window on your display.

3. Extract the installation files for the Secure Trading Agent distribution to a directory on your system, as described below:

For example, if you are installing into a Solaris 9 environment, then do the following to extract the distribution:

tar -xvf S1ISSTA_1_0_0_sol9.tar

The Secure Trading Agent distribution is available either on CD ROM or by downloading as described in "Secure Trading Agent Distribution".

4. From the extracted files, execute the following command:

./setup.sh

The setup program installs the Sun Management Center and then opens the Secure Trading Agent Installer.

Figure 1    Secure Trading Agent Installation Program



5. Select Next to continue, and then read and accept the Software License Agreement.

After accepting the Software License Agreement, the installer displays the types of installations.

Figure 2    Select Installation Type



6. Select an installation type and select Next.

• Select Typical to install Secure Trading Agent using default startup values.

A Typical install automatically starts Secure Trading Agent services when the installation completes. A Typical install also configures Secure Trading Agent to automatically start Secure Trading Agent at system startup.

• Select Custom to install Secure Trading Agent and disable automatic startup of Secure Trading Agent services. (The Custom options appear after Step 9.)




---

Note

The Custom Option dialog allows you to disable automatic startup of Secure Trading Agent services. If you disable automatic startup of services, you must manually start Secure Trading Agent's services before you can use Secure Trading Agent. For information on manual operation of services, refer to the "Secure Trading Agent Administration" chapter of the Secure Trading Agent User's Guide.

---




The Installer prompts you for a location for your Secure Trading Agent installation.

Figure 3    Select Installation Directory



7. Accept the default location or specify another location and select Next.

All components must be installed, so continue through the Installer to the Ready to Install screen.

Figure 4    Ready to Install



8. Select Install Now to begin the installation.

The Installer prompts you for the user name of the Secure Trading Agent administrator.

Figure 5    Administrator User Id



9. Enter the user name for the Secure Trading Agent administrator, who should be a valid user on your system, and select Next.




---

Caution

The Secure Trading Agent installer does not validate the administrator user Id that you specify here. If you specify a user that is not on your system, you will not have administrator access to start up or stop the message handler service. The section "Configuration of Secure Trading Agent" discusses how to reconfigure Secure Trading Agent should this situation occur.

---




(Custom Install only) If you selected the Custom Install option in Step 6, the installer displays the Custom Option dialog. Select or deselect the Automatically Start Services toggle and select Next.

Figure 6    Custom Installation Startup Option



The installer then prompts you to continue with the configuration process.

Figure 7    Configure Secure Trading Agent



10. Select Next to configure Secure Trading Agent and complete the installation.

The installation may take several minutes to complete.

When the installation is complete, the Installer displays a summary of the installation process.

Figure 8    Installation Summary



11. Select Details to view the installation log, then select Close to exit the installer.

If you selected the Typical installation option in Step 6, Secure Trading Agent services are automatically started.

If you plan to use Oracle as a database service, you should configure access to Oracle before you import or deploy any agreements. For information on configuring your system to use Oracle as a database service, see the "Secure Trading Agent Administration" chapter of the Secure Trading Agent User's Guide.

After you complete your installation, your Secure Trading Agent installation is ready for use. If you selected a Typical installation, you can point a browser to the following URL to login to the Sun Management Center:

https://<Server>:6789

Server is the machine on which you installed Secure Trading Agent.

From the Sun Management Center, you can launch the Secure Trading Agent Communications Center.

If you performed a Custom installation and disabled automatic startup of Secure Trading Agent services, you must manually start Secure Trading Agent's services before you can access the Secure Trading Agent Communications Center.

If this is your first time installing Secure Trading Agent, proceed to the sections "Configuration of Secure Trading Agent" and "Secure Trading Agent Services".

The section, "What to Do Next", provides information on how to get started using Secure Trading Agent.

Uninstall Procedure for Solaris Platforms

---

When you run the Secure Trading Agent installer, the setup script installs the Sun Management Center and the Secure Trading Agent applications. There are several ways you can uninstall Secure Trading Agent:

• Uninstall the Sun Management Center and Secure Trading Agent.
• Uninstall Secure Trading Agent only

Does not remove the Sun Management Center. This procedure provides a dialog to guide you through the uninstall process.

• Uninstall Secure Trading Agent using the package remove (pkgrm) utility

Refer to the "Secure Trading Agent Administration" chapter of the Secure Trading Agent User's Guide for information on using the pkgrm utility.

Uninstall the Sun Management Center and Secure Trading Agent

The following procedure uninstalls both Secure Trading Agent and the Sun Management Center.

To uninstall Secure Trading Agent and the Sun Management Center

1. Login as root.

You must have root privileges to perform this procedure.

2. Navigate to the location where you downloaded the Secure Trading Agent distribution.
3. Execute the following command:

./setup.sh -u

You are prompted to confirm removal of the SUNWebXML package. After responding with yes to continue, the uninstall program first removes the Sun Management Center packages and then removes Secure Trading Agent.

Uninstall Secure Trading Agent Only

The following procedure uninstalls Secure Trading Agent only, leaving the Sun Management Center installed on your system.

To uninstall Secure Trading Agent only (interactive)

1. Login as root.

You must have root privileges to perform this procedure.




---

Note	If you use su to become root on your system, make sure you allow root access to your display using xhost. For example, specify xhost + to grant access to all users.

---




2. Make sure your DISPLAY environment variable is correctly set.

The uninstall fails if it cannot open a window on your display.

3. Navigate to the location where you installed Secure Trading Agent.

During installation, the installer creates the uninstall_S1ISSTA.class file in the installation directory.

The default installation directory is:

/opt/SUNWebXML/

4. Run the uninstaller, as illustrated below:

java -cp . uninstall_S1ISSTA

Figure 9    Secure Trading Agent Uninstall Program



5. Follow the prompts of the Uninstall program until the uninstall is complete.

Installation Procedure for Windows Platforms

---

This section describes the procedure to install Sun ONE Integration Server, Secure Trading Agent on Windows platforms. This procedure installs both the Sun Management Center and Secure Trading Agent.

Before Installing Secure Trading Agent

Before installing Secure Trading Agent do the following:

• Obtain the Secure Trading Agent distribution either on CD ROM or by downloading as described in "Secure Trading Agent Distribution".
• Make sure you have a user on your system that you can designate as the Secure Trading Agent administrator, as explained in "Secure Trading Agent Administrator".
• Make sure you have administrator privileges on your system.

You must have administrator privileges to perform the installation procedure.

• Uninstall any previous installed version of Secure Trading Agent before you begin the installation procedure.

Refer to "Uninstall Procedure for Windows" for information on how to uninstall Secure Trading Agent.

• Make sure you have the supported version of the Java Software Development Kit (JDK) installed.

Many systems may have multiple versions of the JDK installed. If the installer finds an unsupported version of the JDK on your system, it opens a file chooser that allows you to navigate to the supported version. If you do not have the supported version on your system, exit the Installation program and install the supported version.

Table 8 lists the supported version of the JDK. The installer for this JDK is available from the Secure Trading Agent CD ROM or the location where you downloaded the Secure Trading Agent distribution.

Installation Procedure

The following procedure installs both the Sun Management Center and Secure Trading Agent.

To install Secure Trading Agent on Windows platforms

1. Make sure you have installed the supported version of the JDK, as described in "Before Installing Secure Trading Agent".

If the installer finds an unsupported version of the JDK on your system, it opens a file chooser that allows you to navigate to the supported version. Use this chooser to navigate to the directory in which you installed the supported version of the JDK.

If you do not have the supported version on your system, exit the Installation program and install the supported version.

2. Login as an administrator on your system.

You must have administrator privileges to perform this procedure.

3. Quit any other programs you are running and close any open windows.
4. From the Secure Trading Agent distribution, run the S1ISSTA-1_0_0-win.exe program.

The program extracts the necessary files and launches the Secure Trading Agent Installer.

Figure 10    Secure Trading Agent Installation Program



5. Select Next to continue, and then read and accept the Software License Agreement.

After accepting the Software License Agreement, the installer displays the types of installations.

Figure 11    Select Installation Type



6. Select an installation type and select Next

• Select Typical to install Secure Trading Agent using default startup values.

A Typical install automatically starts Secure Trading Agent services when the installation completes. A Typical install also configures Secure Trading Agent to automatically start Secure Trading Agent at system startup.

• Select Custom to install Secure Trading Agent and disable automatic startup of Secure Trading Agent services. (The Custom Option dialog appears after Step 9.)




---

Note

The Custom Option dialog allows you to disable automatic startup of Secure Trading Agent services. If you disable automatic startup of services, you must manually start Secure Trading Agent's services before you can use Secure Trading Agent. For information on manual operation of services, refer to the "Secure Trading Agent Administration" chapter of the Secure Trading Agent User's Guide.

---




The Installer prompts you for a location for your Secure Trading Agent installation.

Figure 12    Select Installation Directory



7. Accept the default location or specify another location and select Next.

All components must be installed, so continue through the Installer to the Ready to Install screen.

Figure 13    Ready to Install



8. Select Install Now to begin the installation.

The Installer prompts you for the user name of the Secure Trading Agent administrator.

Figure 14    Administrator User Id



9. Enter the user name for the Secure Trading Agent administrator, who should be a valid user on your system, and select Next.




---

Caution

The Secure Trading Agent installer does not validate the administrator user Id that you specify here. If you specify a user that is not on your system, you will not have administrator access to start up or stop the message handler service. The section "Configuration of Secure Trading Agent" discusses how to reconfigure Secure Trading Agent should this situation occur.

---




(Custom Install only) If you selected the Custom Install option in Step 6, the installer displays the Custom Option dialog. Select or deselect the Automatically Start Services toggle and select Next.

Figure 15    Automatic Startup Option



The installer then prompts you to specify the Tomcat web server home directory.

Figure 16    Specify Tomcat Web Server Home Directory



10. Specify a path to the Tomcat web server directory and select Next.

The installer prompts you with the default location. After you specify the location for the Tomcat web server directory, the installer prompts you to continue with the configuration process.

Figure 17    Configure Secure Trading Agent



11. Select Next to configure Secure Trading Agent and complete the installation.

When the installation is complete, the Installer displays a summary of the installation process.

Figure 18    Installation Summary



12. Select Details to view the installation log, then select Close to exit the installer.

If you typically log into a Windows domain, after installation you must first use the Secure Trading Agent Control Panel to specify the Windows domain name before you can log into Secure Trading Agent. For information on running the Secure Trading Agent Control Panel, see the "Secure Trading Agent Administration" chapter of the Secure Trading Agent User's Guide.

If you plan to use Oracle as a database service, you should configure access to Oracle before you import or deploy any agreements. For information on configuring your system to use Oracle as a database service, see the "Secure Trading Agent Administration" chapter of the Secure Trading Agent User's Guide.

After you complete your installation, your Secure Trading Agent installation is ready for use. If you selected a Typical installation, you can point a browser to the following URL to login to the Sun Management Center:

https://<Server>:6789

Server is the machine on which you installed Secure Trading Agent.

From the Sun Management Center, you can launch the Secure Trading Agent Communications Center.

You can also launch the Secure Trading Agent Communications Center from the Windows Start > Programs > Sun Microsystems > Secure Trading Agent menu.

If you performed a Custom installation and disabled automatic startup of Secure Trading Agent services, you must manually start Secure Trading Agent's services before you can access the Secure Trading Agent Communications Center.

If this is your first time installing Secure Trading Agent, proceed to the sections "Configuration of Secure Trading Agent" and "Secure Trading Agent Services".

The section, "What to Do Next", provides information on how to get started using Secure Trading Agent.

Uninstall Procedure for Windows

---

To uninstall Secure Trading Agent on Windows

1. From the Start > Programs > Sun Microsystems menu, select: Secure Trading Agent > Utilities > Uninstall

The Secure Trading Agent uninstall program window appears.

Figure 19    Windows Uninstall Welcome Screen



2. Select Next.

The screen shows all Secure Trading Agent components to uninstall.




---

Note	The Secure Trading Agent uninstall utility does not uninstall the Java 2 SDK.

---




Figure 20    Windows List of Components to Uninstall



3. Select Uninstall Now.

The Secure Trading Agent uninstall utility prompts you to stop services and continue the uninstall procedure.

Figure 21    Windows Uninstall Stop Services



4. Select Next to continue the uninstall procedure.

When the uninstall is complete, the Uninstall utility displays a summary of the uninstall process.

Figure 22    Windows Uninstall Details



5. Select Details to review details of the uninstall, then select Close to exit the uninstall utility.

Configuration of Secure Trading Agent

---

During the installation of Secure Trading Agent, the installer creates default configuration settings for Secure Trading Agent. You can use the Secure Trading Agent Control Panel to modify the configuration after installation.

Use the Control Panel to modify the following settings:

• Secure Trading Agent Administration User
• HTTP and HTTPS proxy ports to configure access to Secure Trading Agent through a firewall
• Windows domain names (Windows platforms only)
• Communication Ports for receiving ebXML messages
• Ports used by Secure Trading Agent or Apache Tomcat
• Database specifications

For information on running the Control Panel, see the "Secure Trading Agent Administration" chapter of the Secure Trading Agent User's Guide.

Secure Trading Agent Services

---

Secure Trading Agent provides the following services:

• Message Handler

The Secure Trading Agent message handler manages three services. It is responsible for sending and receiving messages between you and your trading partners. It also starts the Configuration Server, which manages users and passwords for Secure Trading Agent, and the HSQL database, which is the default database installed with Secure Trading Agent.

• Sun Management Center service.

The Sun Management Center service manages the web server that runs the Secure Trading Agent Communications Center web application. This service is not necessary to run the ebScript utility, which is the command line equivalent of the Communications Center.

Details for managing Secure Trading Agent services vary by platform. For information about managing Secure Trading Agent services, see the "Secure Trading Agent Administration" chapter of the Secure Trading Agent User's Guide.

Registration for Secure Trading Agent

---

Secure Trading Agent contains a registration process that ensures that the product has been installed properly. The registration procedure should be run after Secure Trading Agent is installed and properly configured on your system. You should be logged in as the Secure Trading Agent administrator when running the registration process.

When you run the registration process, the installer creates the following ebXML agreements:

• installation_verification.cpa

An agreement between you and the Sun registration server. This agreement contains a Send action that the Sun registration server uses to send an installation verification message to you. The installation_verification.cpa agreement contains the endpoints of your message handler, which the registration server needs to send the message.

• sun_registration.cpa

An agreement that contains a Send action that sends the installation_verification.cpa to the Sun registration server as an attachment. When the Sun registration server downloads the agreement, it deploys it and then invokes the Send action that sends the installation verification message to you.

The registration process also creates the following ebScript file:

• sun_registration.ebs

This script imports and deploys the agreements listed above into your Secure Trading Agent system, sends the installation_verification.cpa to the Sun registration server, and then listens for a response from the registration server.

The Secure Trading Agent Installer creates certificate and keystore files that are needed to deploy agreements and to send and receive messages between you and the Sun registration server. The generated scripts reference these certificates during the registration process.

Registration Procedure

The details of the registration procedures for Solaris and Windows platforms differ slightly.

To register Secure Trading Agent on Windows platforms

1. Login as the Secure Trading Agent administrator.

You should be the user with Secure Trading Agent administration privileges when running the registration process.

2. Open a command window and navigate to the ebregister.exe utility.

You may want to enable scroll bars for the command window to view messages that the utility generates.

The default location for this utility is:

C:\Sun\S1ISSTA\bin\ebregister.exe

Your location may differ.

3. Run the ebregister program:

C:\Sun\S1ISSTA\bin>ebregister

When you run this program, it asks you a series of questions. The utility uses your responses to help generate CPA Ids, local party Ids, and unique certificate names that are used in the registration process.

Use the --help to print help for the registration utility to the screen.

Use the --defaults option to bypass the series of questions and use the default information from your installation.

The following files are created during the ebregister process:

C:\Sun\S1ISSTA\etc\sun_registration.cpa
C:\Sun\S1ISSTA\S1ISSTA\etc\sun_registration.ebs
C:\Sun\S1ISSTA\S1ISSTA\etc\installation_verification.cpa
C:\Sun\S1ISSTA\S1ISSTA\etc\verify_request.payload
various certificate (.cer) and keystore (.jks) files

4. Change directory as indicated below and run the following ebscript command, which takes the sun_registration.ebs script as an input file:

C:\>cd \SUN\S1ISSTA
C:\>bin\ebscript -u <admin-user> -i etc\sun_registration.ebs

admin-user is the user name of your Secure Trading Agent administrator.

After the license information is displayed, you are prompted for the admin-user password.

Proceed to "Registration Verification".

To register Secure Trading Agent on Solaris platforms

1. Login as the Secure Trading Agent administrator.

You should be the user with Secure Trading Agent administration privileges when running the registration process.

2. Navigate to the ebregister utility, as explained below.

On Solaris platforms, the default location for this utility is:

/opt/SUNWebXML/S1ISSTA/bin/ebregister

In a typical installation, the default directory for this utility is /opt/SunWebXML/S1ISSTA/bin. Your location may differ.

3. Run the ebregister program:

ebregister

The utility asks you a series of questions, using your responses to help generate CPA Ids, local party Ids, and unique certificate names that are used in the registration process.

Use the --help to print help for the registration utility to the screen.

Use the --defaults option to bypass the series of questions and use the default information from your installation.

The following files are created during the ebregister process:

/opt/SUNWebXML/S1ISSTA/etc/sun_registration.cpa
/opt/SUNWebXML/S1ISSTA/etc/sun_registration.ebs
/opt/SUNWebXML/S1ISSTA/etc/installation_verification.cpa
/opt/SUNWebXML/S1ISSTA/etc/verify_request.payload
various certificate (.cer) and keystore (.jks) files

4. Change directory as indicated below and run the following ebscript command, which takes the sun_registration.ebs script as an input file:

cd /opt/SUNWebXML/S1ISSTA
./bin/ebscript -u <admin-user> -i ./etc/sun_registration.ebs

admin-user is the user name of your Secure Trading Agent administrator.

After the license information is displayed, you are prompted for the admin-user password.

After supplying the password, information about the registration process is displayed.

Proceed to the following section, "Registration Verification."

Registration Verification

The following procedure shows how to open the Secure Trading Agent Communications Center to view the response from the Sun registration server.

To view the registration response from the Sun registration server

1. Wait a few moments (to allow time for the Sun registration server to respond), then launch the Secure Trading Agent Communications Center, as described below:

Point a browser to the following location:

https://<server>:6789

server is the machine on which you installed Secure Trading Agent.

Figure 23    Sun Management Center Welcome



2. Log into the Sun Management Center as the Secure Trading Agent administrator, and then select the Secure Trading Agent Communications Center application.

The Messaging Inbox displays a single message.

Figure 24    Secure Trading Agent Messaging Inbox



If the Inbox does not display the message, wait a few moments, then navigate to the Inbox from the Messaging tab and select Refresh.

3. In the Inbox, select the Welcome action.

Figure 25    Messages Received



4. In the Received Messages list, select the Key for the message to view the message details.

Figure 26    Messages Details



5. Select the link for the document to view the Registration Success message from the Sun registration server.

Figure 27    Messages Details

What to Do Next

---

It is recommended that you do the following to get started with Secure Trading Agent:

1. Read the Release Notes.
2. Follow the Registration procedure described in "Registration for Secure Trading Agent" to ensure that your installation is correctly configured to send and receive messages.
3. Read the "Overview" chapter of the Secure Trading Agent User's Guide to familiarize yourself with ebXML concepts.
4. Complete the Secure Trading Agent Tutorial for a "Quick Start" on using Secure Trading Agent.
5. Familiarize yourself with the Secure Trading Agent User's Guide to understand more about the Secure Trading Agent applications and how to administer them.

Refer to "Documentation Resources" for a complete list of the documentation available to you with Secure Trading Agent.