The following is the LaunchWorks Deployment guide.  This guide should be used as a step by step checklist for proper Installation/Deployment of the LaunchWorks application.


This document should be filled in with customer specific information that pertains to the installation of all require LaunchWorks applications.


For specific definitions, or expanded information on any of the topics defined/discussed below, please refer to the LaunchWorks Installation Guide.


Pre-Deployment Information – Defining Environment Information

Note: This deployment automatically configures launch with server-specific settings. Client must provide the following information prior to installation for these settings to be accurate:


Step
Owner
Comments
Absolute File Path to my SQL install
OPS
Ex:  C:\Program Files\MySQL\MySQL Server 5.0
Absolute File Path to Apache Tomcat install
OPS
Ex:  C:\Program Files\Apache Software Foundation\Tomcat 7.0
MySQL User Name
OPS
SEE IT OPS
MySQL Password
OPS
SEE IT OPS
Launch Server
Server Name
OPS
SEE IT OPS
Network Location (Internal / DMZ)
OPS
SEE IT OPS
Audit Launch Database Server (optional)
Server Name
OPS
SEE IT OPS
 Database DBMS
OPS
SEE IT OPS
 Database Name
OPS
SEE IT OPS
 Database User
OPS
SEE IT OPS
 Database Password
OPS
SEE IT OPS
Source Database (optional)
 Database Server
OPS
SEE IT OPS
 Database DBMS
OPS
SEE IT OPS
 Database Name
OPS
SEE IT OPS
 Database User
OPS
SEE IT OPS
 Database Password
OPS
SEE IT OPS
BOE Server
 CMS Name
OPS
SEE IT OPS
 CMS Admin User
OPS
SEE IT OPS
 CMS Admin Password
OPS
SEE IT OPS
 CMS User
OPS
SEE IT OPS
 CMS Password
OPS
SEE IT OPS
 CMS Port Number
OPS
6400 (default, change if necessary)
SMTP Server
SMTP Server Name
OPS
SEE IT OPS
SMTP User Name (if required)
OPS
SEE IT OPS
SMTP Password (if required)
OPS
SEE IT OPS
SMTP "From" email address
OPS
SEE IT OPS
SMTP "To" email address
OPS
SEE IT OPS

 

Installation Checklist

All references to {tomcat root} refers to: C:\Program Files\Apache Software Foundation\Tomcat7

All references to {launch url} refers to: http://localhost:[port]/launch/


Step
Owner
Comments
Download required installation package from LaunchWorks
Prerequisite
This will contain a .war file for the codebase and a database update script
Run appropriate update script against the database to create LW backend database compatible with your upgrade
Prerequisite
Script will be provided with deployment package:
launch_sql_<version>.sql
Backup/Archive the current /launch installation to ensure a rollback policy for codebase
Prerequisite
Archive to current server (or predetermined archive location) that is accessible in the event of a needed rollback
Retain a copy of the appconfig.properties file for post installation configuration
Prerequisite
This can be found in the current code location.  E.g.  C:\Program Files\Apache Software Foundation\Tomcat7\launch\WEBINF\
Confirm all prerequisite steps are complete in terms of internal and LaunchWorks related preparations
Prerequisite
 
Stop Tomcat web service 
Deployment

Remove/Archive the current /launch installation folder (and all sub folders) from the Tomcat directory
Deployment

Move the delivered LaunchWorks .war file install package to the server and place in the Tomcat/webapps folder
Deployment
E.g. C:\Program Files\Apache Software Foundation\Tomcat 7.0\
Note:  if the .war file is not named “launch.war” please rename during this step. When the .war is extracted, the .war name will be the name of the codebase.  This should be “launch” in most scenarios
Start Tomcat web service.
Deployment

Confirm /launch has been extracted to the /webapps folder as expected
Deployment
 
Stop Tomcat web service
Deployment
 
Replace the appconfig.properties file with the original from step 4 above
Deployment
 
Remove/Archive the launch.war file from the current /webapps folder to avoid redeploy during standard Tomcat web service maintenance
Deployment
 
Start Tomcat web service.
Deployment
 
Login to the Administration Console and Confirm database connection
Testing
See below for link
Test application connection
Testing
See below for link


Test Application Connection

Once the code has been deployed (or migrated) and the application configurations have been made, run the following test to assure all connections have been made.


Login to the administration console:  (e.g. http://(localhost)/launch/administration)



Note:  Please contact your system administrator, or support@launchworks.com for Administration Console username and password


Select View Application:

Click “Test Application” for the appropriate App_Name:   


 


 

 


 


 


 


Confirm Successful Connections Tests:

 


 


 


   

Backups

 


Database, virtual server, and file system backups will be performed by the IT resources and standard automated processes. These backups are standard practice and LaunchWorks is under the assumption that backups of these types are scheduled/processed are regular intervals in the event of needing any database, virtual server, or file system backup for disaster recovery.  It these processes are not in place, or you need assistance in defining any aspect of the LaunchWorks installation to be backed up, please contact your LaunchWorks representative.