CaptainCasa is a J2EE-Servlet based framework. Applications require some Java runtime environment and some servlet container into which they are deployed.
As consequence CaptainCasa comes with two types of installation files:
Installation of “Environment Components” - which copies a JRE and Tomcat environment
Installation of “CaptainCasa Enterprise Client” - which copies the CaptainCasa .war files into this environment. And which copies other useful resources.
When installing CaptainCasa Enterprise Client the first time then you need to execute both installation steps – one after the other. When later on installing updates of CaptainCasa you do not need to re-install the environment components a second time – you just need to install the CaptanCasa part.
If you already have installed CaptainCasa then stop the corresponding Tomcat instances before installation.
Execute the setup of the environment components:
Start “setupRISC_JRE<version>Tomcat8<version>.exe” that you downloaded from the CaptainCasa download page.
During the installation you are prompted for a directory into which CaptainCasa will be installed (default “C:\EnterpriseClientRISC”). When selecting some own directory: do NOT use a directory location within the Windows “Program Files” of “Program Files (x86)” folder.
Execute the setup of CaptaiNCasa Enterprise Client:
Start “setupRISC_V_S_YYYYMMDD.exe”
V = version
S = subversion
YYYYMMDD = Year/Month/Day of build
During the installation you are prompted for a directory. Use the same directory that you used for the environment installation. It is automatically proposed by the installation wizard.
The Demo Workplace shows the features of CaptainCasa Enterprise Client CC. It contains a lot of useful information and code snippets how to use components and how to develop concrete scenarios.
Start the Tomcat instance that provides the demo workplace (and that by default will include the web applications that you develop on your own).
Either: Select “CC Enterprise Client RISC > A Start Server” from the Windows Start-Menu.
Or: Start “A_startserver.bat” from the installation directory.
Now start the browser showing the demo application:
Either: Select “CC Enterprise Client RISC > B Start Demo” from the Windows Start-Menu.
Or: Start “B_startclientRISC_demos.bat” from the installation directory
Or: Open URL “http://localhost:50000/demos/indexRISC.html” inside your web browser
The page will present a list of links to the demos, select one of them and you will see the corresponding demos.
For best performance: minimize the Tomcat instance (DOS-Box). The log output that is shown for demo purpose takes a quite significant amount of resources.
The CaptainCasa Enterprise Client Toolset is the environment for creating dialogs and binding them to your application processing.
Start the Tomcat instance that provides the toolset.
Either: Select “CC Enterprise Client RISC > C1 Start Tools Server” from the Windows Start-Menu.
Or: Start “C1_starttoolsserver.bat” from the installation directory.
Now start the browser showing the toolset application:
Either: Select “CC Enterprise Client RISC > C2 Start Tools Client” from the Windows Start-Menu.
Or: Start “C2_starttoolsRISC.bat” from the installation directory
Or: Open URL “http://localhost:51000/editor/indexRISC.html” inside your web browser
If you already have installed CaptainCasa then stop the corresponding Tomcat instances before installation.
Create a directory in which you want to place the CaptainCasa installation.
Extract the content of “EnterpriseClientRISC_JRE<version>Tomcat<version>.tar.gz” into this directory
Example (assuming the installation directory is “/opt/EnterpriseClientRISC” and assuming the downloaded field is in the “/home/xyz” directory):
cd /opt
mkdir EnterpriseClientRISC
cd EnterpriseClientRISC
tar -xvf /home/xyz/EnterpriseClientRISC_JRE11Tomcat9.tar.gz
Of course you can use any other directory – both for placing the CaptainCasa installation and for keeping the download file.
Execute the setup of CaptainCasa Enterprise Client:
Extract the content of “setupRISC_V_S_YYYYMMDD.tar.gz” into the same directory into which you installed the environment components.
V = version
S = subversion
YYYYMMDD = Year/Month/Day of build
Example (assuming the installation directory is “/opt/EnterpriseClientRISC” and assuming the downloaded field is in the “/home/xyz” directory):
cd /opt/EnterpriseClientRISC
tar -xvf /home/xyz/EnterpriseClientRISC_6_0_20190812.tar.gz
Start the Tomcat instance that provides the demo workplace (and that by default will include the web applications that you develop on your own).
cd /opt/EnterpriseClientRISC
./A_startserver.sh
Now start the browser and open URL:
http://localhost:50000/demos/indexRISC.html
Start the Tomcat instance that provides the toolset.
cd /opt/EnterpriseClientRISC
./C1_starttoolsserver.sh
Now start the browser and open URL:
http://localhost:51000/editor/indexRISC.html
Maybe you want to take a look into the installation directory:
<installdirectory>
/documentation
/resources
...
/eclipseplugin
/server
/jre
/tomcat
/tomcattools
A_startserver.bat
…
All the batch files / shell scripts for starting certain aspects of Enterprise Client RISC are located in the main installation directory.
The server directory includes the JRE (Java Runtime Environment) for the server side processing and it includes 2 Tomcat instances:
“tomcat” - this is the Tomcat for the demo application and for the applications that you later on might build on your own.
“tomcattools” - this is the Tomcat for running the CaptainCasa toolset. The toolset is developed on base of CC Enterprise Client RISC, as well – so it requires some server. The tool-server is running as parallel instance to the demo/application server in order to decouple both.
The Tomcat instance for running the applications occupies ports in the 5000* area. The default HTTP-port is “50000”.
The Tomcat instance for running the toolset occupies ports in the 5100* area. The default HTTP-port is “51000”.
In general we recommend to keep the ports as defined when testing / developing with CaptainCasa Enterprise Client RISC. In case of conflicts within your environment you may update the ports by updating the file <tomcat>/conf/server.xml.
CaptainCasa comes with a little plugin to simplify the development with Eclipse.
The tools of CaptainCasa are operating on the same directory that also used by the corresponding Eclipse project. Whenever a change (e.g. to a layout definition) is done within the CaptainCasa tools, a “signal file” is written into the project folder. The pluging scans this “signal file” and automatically refreshes the project.
Result: changes due to CaptainCasa tools are automatically scanned and lead to an updated of the Eclipse project – you do not have to manually refresh the project against the file system.
...the scanning of the project files is done automatically by both of the tools in a fast way – there is no need for plugin to trigger this.
The plugin is part of the “/resources” folder, the name is “org.eclnt.eclipseplugin.zip”.
If using Eclipse <= 4.4 (Luna): Unzip the file into your eclipse installation directory.
Copy the .jar file contained in the zip-file into the /dropins-folder of your Eclipse installation directory.
After coying the file and restarting Eclipse, you need to start the plugin. Then open the menu...
...and select the CaptainCasa plugin:
After opening, press the “Start” button within the plugin:
You will see the tool scanning for changes regularly.