[Download Edition] Set-up Manual

Descriptions about procedures for 'Installation / Uninstallation', 'Start up / Shut down', 'Upgrading' of Questetra BPM Suite Download Edition.
We are providing Windows version and Linux version for ‘Download Edition’.
Although this document is described mainly for the Windows version, the basic steps are the same for Linux version. Please see [>> for Linux] for the differences such as Path or commands.

[Fresh installation]
Section 2.4 and 2.0 are descriptions for the steps of version-upgrading. Skip them when Fresh install.

[Version Upgrading]
Section 2.0 / 2.4 are the procedure of restoration and data backup.
We only support Version upgrading from current version to one version newer. When you upgrading to the latest version from two versions or older generation, please repeat the upgrading one by one generation. Please note that if you have been upgraded across multiple generations, we cannot guarantee the behavior.

Versions of the Past

Please check the following about server machine installing prior to installation.

  • Satisfying System Requirements
  • Either of JDK8 or JRE8 has been installed.
  • Port number 18080 is not assigned to any other service.
    • If Port 18080 is not available, change the setting of the software occupying Port 18080 in order not to use it. Or, edit the setting file (server.xml in “conf” folder) when starting Questetra BPM Suite so that Questetra BPM Suite can get started at a Port other than 18080.
  • Adjust the clock setting appropriately
    • If not appropriate, there’s a possibility that Questetra BPM Suite does not work properly.
    • Also there’s a possibility that the extension key is not recognized properly.
This procedure is only for upgrading Questetra BPM Suite. Not necessary for New installation. Skip to 2.1.

Login Questetra BPM Suite with System Administrator authorization. Then conduct backup at [Database] > [System Setting]. Confirm backup data is in C:\QBPMS\backup\h2. (It is assumed that Questetra BPM Suite is installed directly below: C)

Then, uninstall Questetra BPM Suite. Please stop Questetra BPM Suite first.

If you had installed Questetra BPM Suite with installer, open Windows Control Panel and conduct the uninstallation.
You don’t need to select Backup at uninstallation, as you already have done it. After the uninstallation finished, modify the folder name of C:\QBPMS to C:\QBPMS.back. Modify the same way, even if it had been installed without installer.

The backup data is stored underneath / var/local/qbpms/backup/h2. After stopping the application, change the name of the installation directory (/var/local/qbpms) to /var/local/qbpms.back.

$ mv /var/local/qbpms /var/local/qbpms.back

* See 3.2. Shut down for how to shut down.

If you have not yet downloaded Questetra BPM Suite, apply for Free Download from HERE.
After submitting your application, an email which tells you the Links will be sent to you. Select one to suit your system environment, and download the file.

  • Windows version: Questetra_BPM_Suite_Windows_X.X.X.zip (X.X.X is replaced with the version number.)
  • Linux version: Questetra_BPM_Suite_Linux_X.X.X.tar.bz2 (X.X.X is replaced with the version number.)

Expand the distribution package. Place the directory named QBPMS which is generated by expanding zip file at directly below C:.

Questetra BPM Suite is supposed to be run by a user “qbpms.” Therefore, we need to add a user “qbpms” to the system. Execute the following command as “root” user before placing the files.

# useradd qbpms

Extract the distribution package. Here, we are installing the files to /var/local/qbpms. The command usage below also assumes that tar.bz2 file is in the current directory.

# tar jxf qbpms-linux.tar.bz2 -C /var/local
# mv /var/local/linux /var/local/qbpms
# chown -R qbpms:qbpms /var/local/qbpms

Edit the following configuration file to suit your use environment.

C:\QBPMS\bin\setenv.bat

This is a configuration file of Apache Tomcat, a runtime environment on which Questetra BPM Suite runs.

set QBPMS_HOME=C:\QBPMS
set QBPMS_TIMEZONE=GMT+0900
set JRE_HOME=C:\Program Files\Java\jre8
set CATALINA_HOME=%QBPMS_HOME%\apache-tomcat
set CATALINA_BASE=%QBPMS_HOME%
set CATALINA_OPTS=-Xmx1024m -Dqbpms.home="%QBPMS_HOME%" -Duser.timezone=%QBPMS_TIMEZONE%
/var/local/qbpms/bin/setenv.sh

JRE_HOME=/usr/java/default
QBPMS_HOME=/var/local/qbpms
QBPMS_TIMEZONE=GMT+0900
CATALINA_HOME=$QBPMS_HOME/apache-tomcat
CATALINA_BASE=$QBPMS_HOME
CATALINA_OPTS="-Xmx1024m -Dqbpms.home=$QBPMS_HOME -Duser.timezone=$QBPMS_TIMEZONE"

Edit the directives in the file as described below. If you exactly follow the instructions on this page, you will need to edit only JRE_HOME.

Directive Name Description
QBPMS_HOME The install directory of Questetra BPM Suite. If you exactly follow the instruction on this page, set the value of this directive to be C:\QBPMS (for Linux; /var/local/qbpms).
QBPMS_TIMEZONE The reference time zone for operating Questetra BPM Suite application.
Specify time zone in offset from GMT (“GMT+0900” “GMT-1200”)
JRE_HOME The install directory of JDK or JRE. Edit this based on your system environment. It may have become “C:\Program Files (x86)\Java\jre8” on 64 bit OS.
CATALINA_HOME The install directory of Apache Tomcat, an application server. If you are going to use the one included in the distribution package, this directive does not have to be changed.
CATALINA_BASE The install directory of an application to be run on Apache Tomcat. You do not have to change this.
CATALINA_OPTS JVM options used when starting up Apache Tomcat.
Because “-Dqbpms.home=${QBPMS_HOME}” is REQUIRED, don’t erase it. If necessary, you can add an option to set the size of the heap memory etc.
C:\QBPMS\qbpms.config

/var/local/qbpms/qbpms.config

This is a configuration file of Questetra BPM Suite.

Since the language is set to be English by default, you need to change the configuration to use the application in Japanese. In addition, change the Path setting (qbpms.contextPath) based on the URL which actually accessing the server. The application might not work as expected, if the access URL was different from the Path setting. In order for the system to send Emails appropriately, you have to correctly edit the directives related to Email server setting based on your environment.

See the details of Configuration Files HERE.

#qbpms.locale=en
qbpms.locale=ja

qbpms.contextPath=http://localhost:18080/userweb/

### Mail Configuration
qbpms.smtp.host = 
qbpms.smtp.port = 25
qbpms.smtp.fromaddress = 
qbpms.smtp.auth = false
qbpms.smtp.username =
qbpms.smtp.password =
qbpms.smtp.starttls = false
This is a necessary step only when upgrading the Questetra BPM Suite. This step is not required in the case of a new installation. Skip to 3.

Restoring must be conducted BEFORE starting Questetra BPM Suite. Do not start the application before data restoration. Execute the following command at the command prompt.

$ cd c:\QBPMS
$ "C:\Program Files\Java\jre8\bin\java" -jar lib\adminapp.jar

Directory to cd is the directory where you installed the QBPMS. Specify the path to the java command based on the directory JRE installed. Specifies the Backup file path of the file that was generated in step 2.0.
(e.g. C:\QBPMS.back\backup\h2\backup20130501.zip)

After a successful execution, the following message is displayed on the console.

creating test db...
restoring test db...
restore test db successful.
deleting test db...
removing current db...
creating new db...
restoring data...
restore succesful.

Then copy the entire folder C:\QBPMS.back\file.back (If not uninstalled through Windows Control Panel, C:\QBPMS.back\file) to C:\QBPMS\file using Windows Explorer.

This is all of the data restoration. Start Questetra BPM Suite and confirm the completion of upgrading and data restoration.

Execute the following command as “qbpms” user.

$ cd /var/local/qbpms
$ /usr/java/default/bin/java -jar ./lib/adminapp.jar
.....
.....
restore succesful.
$ cp -R ../qbpms.back/file .

Execute the following batch file.
C:\QBPMS\bin\startup.bat

If you are going to execute from the command prompt, please move to either of C:\QBPMS or C:\QBPMS\bin in advance. It may take a few minutes to start. After Startup is completed, you can access the application with a browser at the URL that has been set to qbpms.contextPath.

http://(HOST name of the server):18080/userweb/

Execute the following command as “qbpms” user.

$ /var/local/qbpms/bin/startup.sh
to use the Automatic Start-up Script (only for Red Hat type OS)

With this setting, you can start up Questetra BPM Suite automatically when the server machine is booted up.
<pre”># cp /var/local/qbpms/bin/init-script.sh /etc/init.d/qbpms # chmod a+x /etc/init.d/qbpms # chkconfig –add qbpms

Also, you can start up the application by executing the command shown below as “root” user.

# service qbpms start

Execute the following batch file.
C:\QBPMS\bin\shutdown.bat

If you are going to execute from the command prompt, please move to either of C:\QBPMS or C:\QBPMS\bin in advance.

Execute the following command as “qbpms” user.

$ /var/local/qbpms/bin/shutdown.sh

If you set up the startup script on Red Hat type OS, you can also shut down the application by executing the command shown below as “root” user.

# service qbpms stop

In the following procedure, uninstall (remove) the Questetra BPM Suite completely. When conducting the upgrade by using the data, refer to 2.0.

Shut down Questetra BPM Suite. After the application is shut down, delete the install directory (C:\QBPMS).

Delete the directory /var/local/qbpms, after Questetra BPM Suite is shut down. Then delete qbpms user.

 

Last modified: 2013-06-03