resource kit guide

Siperian Hub

Resource Kit Guide

Copyright 2009 Siperian, Inc.

Copyright 2009 Siperian Inc. [Unpublished - rights reserved under the Copyright Laws of the United States]

Siperian and the Siperian logo are trademarks or registered trademarks of Siperian, Inc. in the US and other countries. All other products or services mentioned are the trademarks or service marks of their respective companies or organizations.

THIS DOCUMENTATION CONTAINS CONFIDENTIAL INFORMATION AND TRADE SECRETS OF SIPERIAN, INC. USE, DISCLOSURE OR REPRODUCTION IS PROHIBITED WITHOUT THE PRIOR EXPRESS WRITTEN PERMISSION OF SIPERIAN, INC.

Contents

PrefaceOrganization.......................................................................................................................................................4Learning About Siperian Hub .........................................................................................................................4Contacting Siperian ...........................................................................................................................................7

Chapter 1: IntroductionSiperian Hub and Resource Kit Documentation..........................................................................................2Siperian Sample ORS ........................................................................................................................................2Sample Applications and Utilities ...................................................................................................................3

LookupWebServiceExample..................................................................................................................3BDD Demo..............................................................................................................................................3PartyWebServiceExample ......................................................................................................................4SAMProvidersExample ..........................................................................................................................4Business Process Management (BPM) .................................................................................................4MetCommand Utility ..............................................................................................................................4WsCodeGenPlugin ..................................................................................................................................4CleanseAdapterExample ........................................................................................................................5MetModelConverter................................................................................................................................5Password Encryption Tool Utility ........................................................................................................5

SIF SDK .............................................................................................................................................................5Javadocs...............................................................................................................................................................6

Chapter 2: Installing the Siperian Resource KitSystem Requirements ........................................................................................................................................8Preparing to Install the Sample Applications ................................................................................................8

Installing the Siperian Sample ORS......................................................................................................9Registering the Siperian Sample ORS.................................................................................................11

1

Installing the Siperian Resource Kit............................................................................................................. 13Troubleshooting Your Installation..................................................................................................... 23

Uninstalling the Siperian Resource Kit........................................................................................................ 24Modifying and Redeploying Applications ................................................................................................... 25

Running the postInstallSetup Process Manually .............................................................................. 25

Appendix A: Using the Password Encryption ToolSystem Requirements ..................................................................................................................................... 28Running the Password Encryption Tool..................................................................................................... 28

Encrypting a New Password ............................................................................................................... 28Updating the ORS Database Password ............................................................................................. 29Updating the System Database Password ......................................................................................... 29

2 Siperian Hub Resource Kit Guide

Preface

This guide describes how to install, configure, and use the Siperian Hub™ Resource Kit.

Note: This guide is written for a technical audience: service developers, database administrators, system administrators, and other implementers who are responsible for Siperian Hub installation and setup tasks. Familiarity with the database environment on which you are installing the Resource Kit and knowledge of Oracle administration is assumed. See the Siperian Hub Administrator Guide for Siperian Hub administration and configuration information.

Chapter Contents• Organization

• Learning About Siperian Hub

• Contacting Siperian

3

Organization

OrganizationThis guide contains the following sections:

Learning About Siperian HubWhat’s New in Siperian Hub

What’s New in Siperian Hub describes the new features in this Siperian Hub release.

Siperian Hub Release Notes

The Siperian Hub Release Notes contain important information about this Siperian Hub release. Installers should read the Siperian Hub Release Notes before installing Siperian Hub.

Siperian Hub Overview

The Siperian Hub Overview introduces Siperian Hub, describes the product architecture, and explains core concepts that all users need to understand before using the product.

Siperian Hub Installation Guide

The Siperian Hub Installation Guide explains to installers how to set up Siperian Hub, the Hub Store, Cleanse Match Servers, and other components. There is a Siperian Hub Installation Guide for each supported platform.

Chapter 1, “Introduction” Describes the Siperian Hub Resource Kit, including the various sample applications, and outlines the prerequisites you need to follow prior to installing and deploying the sample applications.

Chapter 2, “Installing the Siperian Resource Kit”

Describes the procedures required for installing the Siperian Resource Kit, including the sample applications.

Appendix A, “Using the Password Encryption Tool”

Describes how to use the Password Encryption Tool included with the Resource Kit.


Learning About Siperian Hub

Siperian Hub Cleanse Adapter Guide

The Siperian Hub Cleanse Adapter Guide explains to installers how to configure Siperian Hub to use the supported adapters and cleanse engines.

Siperian Hub Data Steward Guide

The Siperian Hub Data Steward Guide explains to data stewards how to use Siperian Hub tools to consolidate and manage their organization's data. After reading the Siperian Hub Overview, data stewards should read the Siperian Hub Data Steward Guide.

Siperian Hub Administrator Guide

The Siperian Hub Administrator Guide explains to administrators how to use Siperian Hub tools to build their organization’s data model, configure and execute Siperian Hub data management processes, set up security, provide for external application access to Siperian Hub services, and other customization tasks. After reading the Siperian Hub Overview, administrators should read the Siperian Hub Administrator Guide.

Siperian Hub Services Integration Framework Guide

The Siperian Hub Services Integration Framework Guide explains to developers how to use the Siperian Hub Services Integration Framework (SIF) to integrate Siperian Hub functionality with their applications, and how to create applications using the data provided by Siperian Hub. SIF allows developers to integrate Siperian Hub smoothly with their organization's applications. After reading the Siperian Hub Overview, developers should read the Siperian Hub Services Integration Framework Guide.

Siperian Hub Metadata Manager Guide

The Siperian Hub Metadata Manager Guide explains how to use the Siperian Hub Metadata Manager tool to validate their organization’s metadata, promote changes between repositories, import objects into repositories, export repositories, and related tasks.

5

Learning About Siperian Hub

Siperian Hub Resource Kit Guide

The Siperian Hub Resource Kit Guide explains how to install and use the Siperian Hub Resource Kit, which is a set of utilities, examples, and libraries that assist developers with integrating the Siperian Hub into their applications and workflows. This document provides a description of the various sample applications that are included with the Resource Kit.

Siperian Hub Insight Manager Guide

The Siperian Hub Insight Manager Guide explains how to install, configure, and use the Siperian Hub Insight Manager to generate reporting metadata for the data managed in the Hub Store. It provides a description of how to use this reporting metadata with third-party reporting tools to create reports and metrics for this data.

Siperian Training and Materials

Siperian provides live, instructor-based training to help professionals become proficient users as quickly as possible. From initial installation onward, a dedicated team of qualified trainers ensure that an organization’s staff is equipped to take advantage of this powerful platform. To inquire about training classes or to find out where and when the next training session is offered, please visit Siperian’s web site or contact Siperian directly.


Contacting Siperian

Contacting SiperianTechnical support is available to answer your questions and to help you with any problems encountered using Siperian products. Please contact your local Siperian representative or distributor as specified in your support agreement. If you have a current Siperian Support Agreement, you can contact Siperian Technical Support:

We are interested in hearing your comments about this book. Send your comments to:

Method Contact Information

World Wide Web http://www.siperian.com

Email [email protected]

Voice U.S.: 1-866-SIPERIAN (747-3742)

by Email: [email protected]

by Postal Service: Documentation ManagerSiperian, Inc.100 Foster City Blvd.2nd Floor Foster City, California 94404 USA

7

http://www.siperian.com

Contacting Siperian


1
Introduction
The Siperian Hub Resource Kit is a set of examples and utilities that assist you in integrating the Siperian Hub into your applications and workflows.

Chapter Contents• Siperian Hub and Resource Kit Documentation

• Siperian Sample ORS

• Sample Applications and Utilities

• Password Encryption Tool Utility

• SIF SDK

• Javadocs

1

Siperian Hub and Resource Kit Documentation

Siperian Hub and Resource Kit DocumentationThe Siperian Resource Kit includes the following documentation for the Siperian Hub, and the Siperian Resource Kit:• What’s New in Siperian Hub

• Siperian Hub Release Notes

• Siperian Hub Installation Guides

• Siperian Hub Cleanse Adapter Guide

• Siperian Hub Overview

• Siperian Hub Data Steward Guide

• Siperian Hub Administrator Guide

• Siperian Hub Metadata Manager Guide

• Siperian Hub Services Integration Framework Guide

• Siperian Hub Resource Kit Guide

• Siperian Sample ORS Configuration Guide and other sample application documentation

These files are located in the Resource Kit documentation folder and in the specific sample application folders (for example, BPM) within the samples folder.

Siperian Sample ORSThe Siperian Sample ORS is used by the various sample applications included with the Siperian Resource Kit. The Siperian Sample ORS includes the SQL scripts, PLB files, sip_sample.dmp, and related files for creating a sample ORS schema.

Note: You must install the Siperian Sample ORS in your database and register it with Siperian Hub Server before installing the sample applications.


Sample Applications and Utilities

Sample Applications and UtilitiesThe Siperian Resource Kit may include the following set of sample applications and utilities.

Note: For more information, see the readme.txt file for each sample application or utility. ReadMe files are located in the Resource Kit Samples folder.• LookupWebServiceExample

• BDD Demo

• PartyWebServiceExample

• SAMProvidersExample

• Business Process Management (BPM)

• MetCommand Utility

• WsCodeGenPlugin

• CleanseAdapterExample

• MetModelConverter

• Password Encryption Tool Utility

LookupWebServiceExample

LookupWebServiceExample is an example of a web service for exposing the cross reference services for the entities managed by the hub and code translation services for the lookup codes defined in the hub.

BDD Demo

The Business Data Director Demo is an example of the Siperian Hub Business Data Director, a data governance application for Siperian Hub that enables business users to effectively create, manage, consume, and monitor master data. Using the sample configuration file (bddDemo.xml) and the configuration tool, you can set up a Business Data Director interface for the sample schema included in the Resource Kit.

Introduction 3

Sample Applications and Utilities

PartyWebServiceExample

PartyWebServicesExample is an example of a set of composite web services built around the Siperian Sample Schema.The web services are built using the Axis web services framework and the SIF APIs are used to access the hub.

SAMProvidersExample

The SAMProvidersExample shows the basics of building custom SAM providers. The jar file that is built by this sample application is installed through the Console in the Security Providers tool. For additional information regarding the process of installing a provider, refer to “Managing Provider Files,” in the Siperian Hub Administrator Guide.

Business Process Management (BPM)

The Business Process Management (BPM) sample describes how a developer can create an integration between Lombardi Teamworks workflow tool and the Siperian Hub.

MetCommand Utility

MetCommand is a simple command-line wrapper for the Siperian Hub Metadata Manager APIs. These APIs are used to manage the metadata (export, import, validate) in the Siperian Hub. It can be used in situations where it is desirable to execute these APIs as part of a script - to automate the promotion of design objects from one ORS to another.

WsCodeGenPlugin

The Eclipse Web Services Code Generator (WsCodeGen) is an Eclipse plug-in for generating the skeleton of a Web Service for use with Siperian SIF services. Components generated by WsCodeGen include Java beans, the WSDL, Castor mapping file, WSDD and other property files required to create a Web Service. The plug-in enables the user to focus on creating and adding business logic code to the framework.


SIF SDK

CleanseAdapterExample

The CleanseAdapterExample allows you to create cleanse adapters to work with your specific, non-supported cleanse engine. For more information about supported cleanse adapters, see the Siperian Cleanse Adapter Guide.

MetModelConverter

MetModelConverter is a command-line utility that converts Common Warehouse Metamodel to Siperian Hub Change List XML format. It demonstrates how Siperian Hub Metadata Manager can be used to integrate 3rd party software like ERWIN.

Password Encryption Tool Utility

The Password Encryption tool is a command-line utility for encrypting your secured database passwords. Instructions for using this utility are located in the Appendix A, “Using the Password Encryption Tool”

SIF SDKThe Siperian Resource Kit installer also installs the Siperian Hub Services Integration Framework (SIF). The SIF is the part of Siperian Hub that interfaces with client programs. Logically, it serves as a middle tier in the client/server model. It enables you to implement request/response interactions using any of the following architectural variations:• Loosely coupled web services using the SOAP protocol.

• Tightly coupled Java remote procedure calls based on Enterprise JavaBeans (EJBs).

• Asynchronous Java Message Service (JMS)-based messages.

• XML documents going back and forth via Hypertext Transfer Protocol (HTTP).

Each of the above SIF protocols sits on top of the native Siperian Hub protocol, which accepts requests in the form of XML documents or EJBs and returns responses the same way.

Introduction 5

Javadocs

You copy the SIF SDK to any client system on which you wish to develop and run programs to interact with Siperian Hub via SIF. If you can run a Java virtual machine (JVM) on the client system, you can use the Java classes included in the SIF SDK. The SRK installs the SIF-SDK in the following location:

<Resourcekit_Home>\sifsdk

You can configure the SDK to use any SIF protocol. If you cannot run a JVM, then you must explicitly use web services (for example, on a pure .NET system) or JMS (for example, on a mainframe system), or XML over HTTP.

For a complete description of the Siperian SIF-SDK, refer to the Siperian Hub Services Integration Framework Guide. This guide refers to these Java classes by the name of the first class you must instantiate, SiperianClient.

JavadocsThe Siperian Resource Kit installer installs the java documentation for the SIF API in the following locations:

<Resourcekit_Home>\docs\sifsdk\javadoc<Resourcekit_Home>\docs\sip-plugin\javadoc

You can view the associated java packages and classes via the index.html file. The index.html file is located in the following directory:

<Resourcekit_Home>\sifsdk\javadoc\index.html

Open index.html to see a right-hand frame and two left-hand frames. The left frames provide links to the pages for all packages and all classes. The lower left frame displays the links associated with the package you select in the upper left frame.You can select All Classes in the upper left frame to see a combined list of classes from all packages in the lower left frame.

The right frame changes to show the pages you select. Begin by exploring the classes of the com.siperian.sif.message package. Most of the classes used in application programs are in this package and its subpackages.


2
Installing the Siperian Resource Kit
The Siperian Resource Kit installer installs the Resource Kit components.

Important: Before you run the Siperian Resource Kit installer, the Siperian Hub must be installed and configured for your environment. In addition, you need to install and register the Siperian Sample ORS, and you must have purchased a license for the Siperian Hierarchy Manager. For more information, see Chapter 1, “Introduction.”

Chapter Contents• System Requirements

• Preparing to Install the Sample Applications

• Installing the Siperian Resource Kit

• Uninstalling the Siperian Resource Kit

• Modifying and Redeploying Applications

7

System Requirements

System RequirementsThe system requirements for installing the Siperian Resource Kit are:• JDK 1.5.0_15 (for more information, refer to:

http://java.sun.com/javase/downloads/index_jdk5.jsp)

• Siperian Hub Server XU SP2

• JBoss-4.0.3 SP1, WebLogic 9.2 MP3 or WebLogic 10 MP2, or WebSphere 6.1.0.23

• Oracle 10g or Oracle 11g

• Windows 2003, XP SP2

Preparing to Install the Sample ApplicationsThe Siperian Hub Server must be installed and configured for your environment before you begin using the Siperian sample applications.

You must have:• A valid installation of the Siperian Hub (Hub Store Master and Siperian Hub

Server / Cleanse Match Server)

• Purchased a license for the Siperian Hierarchy Manager

For a complete description of how to install the Siperian Hub Server, refer to Siperian Hub Installation Guide.

In addition, you need to install the sample schema and register the ORS prior to installing the sample applications. For more information, refer to “Installing the Siperian Sample ORS” on page 9.


Preparing to Install the Sample Applications

Installing the Siperian Sample ORS

The Siperian Resource Kit distribution includes a script named setup_ors.sql in the database\oracle directory. This script is used to create a sample schema.

To set up a sample schema for the sample applications included with the Resource Kit:1. Create a temporary directory on the Oracle database server or on a client

workstation that has Oracle client installed with Oracle utilities (imp.exe).

Copy all of the files in the distribution to this directory.

2. Open a command window.

Go to the Windows Start menu; choose Run and enter cmd.

3. Go to the temporary directory you just created.

4. To start SQL*PLUS, enter:sqlplus

Press Enter.

5. Connect to the server as SYSTEM or as a user with DBA privileges.

6. Execute the setup_ors.sql script by typing the following command: @setup_ors.sql

7. Answer the following prompts:

Note: The text in brackets is the default information for each prompt. “CMX_ORS” for the name of the User in this case. Press Enter to use the default information and go to the next prompt, unless otherwise directed.

• Enter name of User [CMX_ORS]:

Enter sip_sample for this user name.

This is the name of the Siperian Hub user that owns this ORS (sample schema).

• Enter password for ORS User [!!cmx!!]

Installing the Siperian Resource Kit 9


• Enter name of MRM data tablespace [CMX_DATA]:

This is the tablespace in which this ORS will be created.

• Enter name of MRM index tablespace [CMX_INDX]

This is the tablespace that will contain the indexes.

• Enter name of MRM temporary tablespace <not an Oracle temp tablespace>[CMX_TEMP]:

• Create a proxy user [PROXY_ROLE]:

This step will create a proxy user with access to the database.

• Enter name of Oracle temporary tablespace [TEMP]:

This is the name of the Oracle temporary tablespace.

• Enter ORACLE server TNS name:

This is the name by which the database is known on your network. For example:

mydatabase.mycompany.com

This value is set when you install Oracle. See your Oracle documentation to learn more about this name.

• Enter name of DBA User [SYSTEM]

This is the Oracle username with DBA privileges.

• Enter password of DBA User:

This is the password for the Oracle username with DBA privileges.

• Enter file to import [cmx_ors.dmp]:

Do not use the default. Enter sip_sample.dmp.

This is the name of the Oracle export file containing the sample database. This is part of the Siperian Hub install.

• Enter import from user name [cmx_ors]:

Do not use the default. Enter sip_sample.



8. After the setup scripts are complete, there are log files in the temporary directory from which you ran the scripts:

• setup_ors.log

• sip_sample.dmpimp.log

Review these files to ensure no errors occurred. You may see warnings, which can be ignored. Errors must be addressed.

If you see database error in the logs, resolve these first with your DBA and your RDBMS vendor; then re-run the setup_ors.sql script.

You can find a copy of the sip_sample.dmp file in the Resource Kit distribution media in the following directory:

database\oracle

Now you must register this sample schema database in Siperian Hub server before running the Siperian Resource Kit installer.

Registering the Siperian Sample ORS

To register the Sample Schema, perform the following steps:1. Highlight the database in the right pane.

Choose the Databases menu, and then choose Register Database or highlight the database in the right pane and click the “+” button.

2. In the Identity section, enter the database display name and machine identifier.

3. In the Connection Properties section, specify connection properties for your database type (Oracle database).

Specify:

• database type and hostname

• Oracle SID and port number

• TNS name of the Oracle instance (as defined in the application server’s TNSNAMES.ORA file)

• user name/schema name for the Hub Store



• password for the Hub Store

Note: Registering the Hub Store fails if you try to register a database that does not contain the Siperian Hub repository objects or Siperian Hub procedures.

4. Check the Create data source after registration check box if you want to create the data source on the application server after registration.

Note for WebLogic: If you are using WebLogic, a dialog box prompts you for your username and password. This process writes only to the master database.

The ORS database and data source need not be available at registration time. Siperian Hub uses the data sources provided by the application server and, therefore, does not write any data to the ORS at the time of registration.

5. Click OK.

Note for JBoss: An exception may appear in the log files when registering the data sources on JBoss. This is caused by the deployment architecture on JBoss and results from the server trying to deploy twice. This is benign; the system deals with this situation gracefully.

Note for WebSphere: If you are running WebSphere, any changes to an ORS datasource requires an application server restart.

For more information on registering databases with the Siperian Hub, refer to the Siperian Hub Administrator Guide.

You can find a copy of the sip_sample.dmp file in the Resource Kit distribution media in the following directory:<RESOURCEKIT_HOME>/sampleschema/oracle

You can load this file into your database before you install the Resource Kit.

• You are now ready to install the Siperian Resource Kit.



Installing the Siperian Resource KitNote: You must complete a full installation in order to upgrade to a newer version of the Siperian Resource Kit. There is no patch install for the Resource Kit.

To install the Siperian Resource Kit:1. Run the Siperian Resource Kit installer:

CD:\mrmresourcekit\windows\hub_resourcekit_install.exe.

Review the Introduction instructions.

Click Next to continue.



2. Choose a license agreement option


Note: You can select Cancel to end the installation, or Previous to return to a prior page at any time during the installation process.



3. Select the Resource Kit features you want to install.

Siperian Hub Documentation

Select this option to install the entire documentation suite.

Sample Schema Select this option to install the Sample Schema. You must create a sample schema and register it with the Siperian Hub Server before installing the sample applications.

Cancel the installation and See “Installing the Siperian Sample ORS” for instructions.

Samples Select this option to install the sample applications. The list of sample applications deployed is stored in the build.properties file. This file is located in the following directory:<Resourcekit_Home>\samples

SIF SDK Select this option to install the javadocs, libraries, and resources associated with the SIF SDK.



Click Help to view installation tips.This button is active throughout the installation wizard when installation tips are available.


4. Enter the installation location for the Resource Kit, or accept the default folder.

Click Choose to select a location for the Resource Kit installation. Do not use spaces in your path or folder name.

Click Restore Default Folder to return to the default installation location.

If you select a location with an existing installation, this process will overwrite that installation.

Click Install to continue. If you are returning to this page via the Previous button, the button label changes to Next as you progress through the installation wizard.

Utilities Select this option to install the sample utilities.



5. Select the location and type of shortcuts you wish to install.

Click Next.

6. Deploy and configure the Resource Kit to run in your selected application server



You can choose to deploy and configure the Resource Kit during this installation or run this process manually at a later time.

If you choose not to run post-install setup at this time, you will not be able to use postInstallSetup scrip to deploy the EAR file. You will have to manually edit the EAR file and deploy it to make any changes to your installation.

Run the postInstallSetup.bat script from C:\Siperian\hub\resourcekit\deploy.

If you run the postInstallSetup script while installing the Resource Kit and later make changes in the samples, and want to redeploy the samples, you can make use of postInstallSetup script.

Note: For WebLogic, you must apply this option when running the postInstallSetup.bat script:-Dweblogic.password=<your WebLogic password>

Click Next.

7. Configure the Resource Kit for your application server.

Each application server has unique steps that guide you through the configuration process of the Resource Kit installation.Enter the path to your selected application server for the installation of the Resource Kit, as shown in this example:

a. Select your application server.

Click Next.



b. Enter the path to your selected application server for the installation of the Resource Kit as shown in this example:

The Siperian Hub Server and the Resource Kit can reside on different machines.

Select Restore Default Folder to reset the option. Select Choose to browse to the desired location.

Click Next.



c. Enter the settings and login information for your selected application server. The application server installation pages will vary, depending on your application server.

Application Description

JBoss Settings for your JBoss instance:• RMI PortNote: The JBoss port can conflict with the default Oracle port. If this is the case for your installation, you must change one of the ports to resolve the conflict.To change the port number in that file, open jbossweb-tomcatxx.sar for editing, search for the word “port”, and change the value for port to match the value you have set on the JBoss Application Server Port screen.Information for your Siperian Hub Server Installation:• Server Name• Server HTTP Port• Siperian Administrative passwordImportant: If you change the default HTTP port number, you must also change it in the following directory: JB_HOME\server\default\deploy\jbossweb-tomcatxx.sar\server.xml

where jbossweb-tomcatxx.sar is the SAR file for your Tomcat installation. xx represents the version number.Select a Resource Kit ORS ID.This drop down list will contain all ORS IDs you have created.You must only select an ORS ID related to the Sample Schema. If you have not registered the sample schema, you will not see the ORS ID for the Sample schema. Stop the installation at this point, register the ORS as described in Registering the Siperian Sample ORS, then restart the installation.



WebLogic Settings for your WebLogic instance:• Host• Server Name• Username• Password• Listening PortInformation for your Siperian Hub Server Installation:• Server Name• Server HTTP Port• Siperian Administrative passwordSelect a Resource Kit ORS ID.This drop down list will contain all ORS IDs you have created.You must only select an ORS ID related to the Sample Schema.If you have not registered the sample schema, you will not see the ORS ID for the Sample schema. Stop the installation at this point, register the ORS as described in Registering the Siperian Sample ORS, then restart the installation.

WebSphere Settings for your WebSphere instance:• Server Name• RMI Port• SOAP PortInformation for your Siperian Hob Server Installation:• Server Name• Server HTTP Port• Siperian Administrative passwordSelect a Resource Kit ORS ID.This drop down list will contain all ORS IDs you have created.You must only select an ORS ID related to the Sample Schema.If you have not registered the sample schema, you will not see the ORS ID for the Sample schema. Stop the installation at this point, register the ORS as described in Registering the Siperian Sample ORS, then restart the installation.

Application Description



8. Review the Pre-Installation Summary to confirm your installation choices.

Click Previous to return to prior pages in the installation wizard to change selections.

Click Install to continue.



9. Review messages on the Install Complete page to confirm a successful installation or view causes for an incomplete installation.

Troubleshooting Your Installation

Log files are useful for troubleshooting your Siperian sample application installation. Save these files after a failure and provide them when you call Siperian Support:• <ResourceKit_Home>\Siperian_Hub_Resource_Kit_

InstallLog.xml–contains the messages for the installation.

• <ResourceKit_Home>\deploy\logs\postInstallSetup.log–contains the messages for the postInstallSetup script.

• Application server log files


Uninstalling the Siperian Resource Kit

Uninstalling the Siperian Resource KitUse the Siperian uninstaller program to remove the Resource Kit.

To uninstall the Resource Kit:1. Click the Start button and select Programs > Siperian > Hub > ResourceKit >

Uninstall Siperian Resource Kit.

Or navigate to the following directory and double-click Uninstall_Siperian_Hub_Resource Kit.exe: <ResourceKit_Home>\deploy\\UninstallerData

Which by default is: C:\siperian\hub\resourcekit\deploy\UninstallerData

The Uninstall Siperian Hub Resource Kit screen is displayed.

2. Click Uninstall to begin.

The Uninstall Complete screen is displayed.

3. Click Done.


Modifying and Redeploying Applications

Modifying and Redeploying ApplicationsTo modify and redeploy the existing sample applications, perform the following steps:1. Make the desired changes.

2. Recompile the application.

3. Rerun the postinstallsetup script that is located in the following location: C:\siperian\hub\resourcekit\deploy

Running the postInstallSetup Process Manually

The postInstallSetup process packages the EAR file that is subsequently deployed on the Application Server. By default, the postInstallSetup script is located in the following directory:<ResourceKit_Home>\deploy

To run the post-install script manually:• For the WebLogic application server, run the following command from a

command prompt:postInstallSetup.bat -Dweblogic.password=your_password -Ddatabase.password=your_database_password

where your_password is the password for your WebLogic application server.

A typical way of running this script for WebLogic is as follows:C:\siperian\hub\resourcekit\deploy>postInstallSetup.bat -Dweblogic.password=weblogic -Ddatabase.password=!!cmx!!

• For the WebSphere and JBoss application servers, run the following command from a command prompt:postInstallSetup.bat


Modifying and Redeploying Applications


A
Using the Password Encryption Tool
The Password Encryption tool is a command-line utility use to encrypt your secured database passwords.

Note: See the sample folders for more information about the additional samples and utilities included in the Resource Kit.

Appendix Contents• System Requirements

• Running the Password Encryption Tool

27

System Requirements

System RequirementsYou need to make sure Siperian-common.jar is installed under the Utilities directory.

In addition, you must have Java installed and have the jar file to be able to run this utility.

Running the Password Encryption ToolIn order to successfully change the schema password, you must change it in several places. The first area in which you must change the schema password is in the data sources defined in the application server. This password is not encrypted as the application server protects it. Both username and password are stored in the cmxserver.properties file, and the password must be entered in encrypted form.

The parameters are stored in cmxserver.properties as:• [databaseId].username=username

• [databaseId].password=encryptedPassword

In addition to the data sources on the application server, Siperian requires the password to be encrypted and stored in various tables.

Encrypting a New Password

To encrypt the new password, go to the Utilities folder (for example: C:\siperian\hub\resourcekit\utilities), and execute the following command from the prompt:

java -classpath siperian-common.jar com.siperian.common.security.Blowfish

The results are echoed to the terminal window:Plaintext Password: your_new_passwordEncrypted Password: encrypted password

For example, if admin is your the new password, the command is:


Running the Password Encryption Tool

java -classpath siperian-common.jar com.siperian.common.security.Blowfish admin

The results are displayed as follows:Plaintext Password: adminEncrypted Password: A75FCFBCB375F229

Updating the ORS Database Password

Execute the following commands to update the passwords for your ORS databases:

To update your ORS database password:UPDATE C_REPOS_DB_RELEASE SET DB_PASSWORD = '';COMMIT;

Updating the System Database Password

Execute the following commands to update the passwords for your System databases:

To update your CMX_SYSTEM database password:UPDATE C_REPOS_DATABASE SET PASSWORD = '' WHERE USER_NAME = ''

Using the Password Encryption Tool 29

Running the Password Encryption Tool


Index

Aapplications, sample

prerequisites before installing 8

BBPM

sample application, about 4Business Process Management (BPM)

sample application, about 4

Cchecking after Resource Kit installation 23cmx_ors.dmpimp.log file 11customer support 7

Ddocumentation

list of documents 4organization 4

Eencrypting a new password 29

GGWTSampleApp

sample application, about 3

HHub Server

installing 13

Iindex.html

location (for Javadoc) 6installing

Resource Kit 13

JJavadocs

index.html file location 6

Llog files 23

cmx_ors.dmpimp.log file 11setup_ors.log file 11

LookupWebServiceExamplesample application, about 3

31

Mmodifying sample applications 25

OORS database

using the Password Encryption Tool toupdate the passwords 29

PPartyWebServicesExample

sample application, about 4password

using the Password Encryption Tool 28Password Encryption Tool

encrypting a new password 28ORS database 29running 27System database 29using 5, 27, 28

postInstallSetup.log file 23proxy role 10proxy user

create 10

Rredeploying sample applications 25Resource Kit

installing 13log files 23system requirements 8uninstalling 24

SSample application

installation prerequisites 13sample applications

modifying and redeploying 25prerequisites before installing 8

Sample installationlog files

checking 23postInstallSetup.log file 23

Sample Schemaabout 2installing 9registering 11

SAMProvidersExamplesample application, about 4

Schema, Sampleabout 2

Services Integration Frameworkabout 5

Services Integration Framework (SIF)about 5

setup_ors.log file 11Siperian_Hub_Server_InstallLog.xml file 23Siperian, contacting 7SiperianClient class 6Siperian-common.jar 28support 7System database

using the Password Encryption Tool toupdate the passwords 29

system requirementsinstalling Resource Kit 8


Ttechnical support 7training 6

XXML over HTTP 5

33

resource kit guide

Documents

siperian hub resourcekit deploy

siperian hierarchy manager

siperian hub tools

siperian hub overview

siperian hub release

business process management

siperian resource kit

upper left frame