QConnector

{{toc}}

h1. Deployment

*Prerequisite:*

* Completed [[Installation]] section

* Completed [[Configuration]] section

This section describes how to deploy components/modules to the servers.

Deployment Architecture:

!DeploymentView.JPG!

The deployment's tasks are summarized in the below table:

|_.Component|_.Type|_.Target|

|ecwyconnector|WAR|Dot Com Mall / QueueSystem|

|ecosway-adaptor|JAR|US Mall|

|ws-mimic|WAR|US Mall / QueueSystem|

|ws-status|WAR|US Mall|

In general, this deployment task involves 2 parts: 

# [[Deployment#Upload-properties-files|Upload properties files]]

# [[Deployment#Deploy-WARJAR-file|Deploy WAR/JAR file]]

h2. Upload properties files

*This section is dedicated for the first time deployment only.* For subsequent deployment, you should update the existing properties files when needed. 

All of the properties files can be found in SVN repository:

> http://192.168.2.13:50000/svn/qconnector/trunk/qconnector-config

All of the properties files should store in the directory:

> /data/ecwyconnector

h3. ws-mimic

*List of the properties files to be uploaded:*

* *Note*: replace {environment} with either *production* (for production environment) or *development* (for development environment)

** *application.properties* - http://192.168.2.13:50000/svn/qconnector/trunk/qconnector-config/{environment}/ws-mimic/properties/application.properties

** *jndi-factory.properties* - http://192.168.2.13:50000/svn/qconnector/trunk/qconnector-config/{environment}/ws-mimic/properties/jndi-factory.properties

*Steps:*

# see the [[Deployment#Deployment]] section for the deployment target

# upload the following files to */data/ecwyconnector/ws-mimic/* directory via ftp or sftp:

** application.properties

** jndi-factory.properties

# make sure *everyone* has the read-access to the above files

# done

h3. ecosway-adaptor

*List of the properties files to be uploaded:*

* *Note*: replace {environment} with either *production* (for production environment) or *development* (for development environment)

** *application.properties* - http://192.168.2.13:50000/svn/qconnector/trunk/qconnector-config/{environment}/ecosway-adaptor/properties/application.properties

** *database.properties* - http://192.168.2.13:50000/svn/qconnector/trunk/qconnector-config/{environment}/ecosway-adaptor/properties/database.properties

** *registration/template.properties* - http://192.168.2.13:50000/svn/qconnector/trunk/qconnector-config/{environment}/ecosway-adaptor/properties/registration/template.properties

*Steps:*

# see the [[Deployment#Deployment]] section for the deployment target

# upload the following file(s) to */data/ecwyconnector/ecosway-adaptor/* directory via ftp or sftp:

** application.properties

** database.properties

# upload the following file(s) to */data/ecwyconnector/ecosway-adaptor/registration/* directory via ftp or sftp:

** template.properties

# make sure *everyone* has the read-access to the above files

# done

h3. ws-status

*List of the properties files to be uploaded:*

* *Note*: replace {environment} with either *production* (for production environment) or *development* (for development environment)

** *database.properties* - http://192.168.2.13:50000/svn/qconnector/trunk/qconnector-config/{environment}/ws-status/properties/database.properties

*Steps:*

# see the [[Deployment#Deployment]] section for the deployment target

# upload the following file(s) to */data/ecwyconnector/ws-status/* directory via ftp or sftp:

** database.properties

# make sure *everyone* has the read-access to the above files

# done

h3. ecwyadaptor

*List of the properties files to be uploaded:*

* *Note*: replace {environment} with either *production* (for production environment) or *development* (for development environment)

*Steps:*

# see the [[Deployment#Deployment]] section for the deployment target

# upload the following file(s) to */data/ecwyconnector/ecwyadaptor/* directory via ftp or sftp:

** *database.properties* - http://192.168.2.13:50000/svn/qconnector/trunk/qconnector-config/{environment}/ecwyadaptor/properties/database.properties

# make sure *everyone* has the read-access to the above files

# done

h2. Deploy WAR/JAR file

* Refer to [[Deployment#Deployment]] section to see the list of available components and deployment target. 

* Refer to the [[Documentation#ModulesComponents|Components]] section for the latest component version.

h3. Deploy ecwyconnector

*Steps:*

# choose one of the methods:

## build from *source files*:

### build the deployment file (see [[Build components from sources]])

### rename the deployment file to *ecwyconnector.war*

## download the binary from *internal repository* (see [[General Info:SearchBrowse artifact|Nexus]]):

*** component name: *ecwyconnector*

*** component version: _see_ [[Documentation#ModulesComponents|Latest Version]]

# upload the file to target server

** if target server is Jboss AS 4.2.2

*** upload to */usr/local/jboss-4.2.2.GA/server/{profile name}/deploy*

# restart jboss

# done

h3. Deploy ecosway-adaptor

See [[Deploy ecosway-adaptor]]

h3. Deploy ws-mimic

*Steps:*

# choose one of the methods:

## build from *source files*

### build the deployment file (see [[Build components from sources]])

### rename the deployment file to *ws-mimic.war*

## download the binary from *internal repository* (see [[General Info:SearchBrowse artifact|Nexus]]):

*** component name: *ws-mimic*

*** component version: _see_ [[Documentation#ModulesComponents|Latest Version]]

# upload the file to target server

<pre>

.../jboss5.1.0.GA/server/{profile name}/deploy

</pre>

# restart jboss

# done

h3. Deploy ws-status

See [[Deploy ws-status]]