Cumulus Web Solutions : Installing
   
Installing
Canto provides installer utilities for installing Cumulus Web Solutions on all supported platforms.
The Cumulus Web Solutions require a Web application server and Cumulus Java Classes installed on the machine running the Web solutions. For your convenience, both a Web application server (Apache Tomcat) and the Cumulus Java Classes are included in the Cumulus Web Solutions installer. However, you may install Cumulus Web Solutions into an already existing web application server, as long as this server supports Servlet API 3.1, JSP2.3, EL 3.0.
The Cumulus Web Solutions installer provides several installation sets:
• Cumulus Portals, including the respective technical documentation.
• Cumulus Web Client, including the respective technical documentation.
• Cumulus Server Console
• Cumulus Integration Platform
• Web Application Server, including Apache Tomcat and Cumulus Java Classes
Cumulus Web Solutions may be installed either on the Cumulus Server machine or on another computer in the TCP/IP network.
NOTE: All Cumulus Web Solutions are able to (and will per default) run inside the same Tomcat Web application server.
It is not possible to update an existing Cumulus Portals or Cumulus Web Client installation directly. If you need to update your existing Cumulus Portals or Cumulus Web Client installation, contact Canto Professional Service or a Canto partner.
Installing under Windows or macOS
To install Cumulus Web Solutions under Windows ()  or macOS () :
 
1.   Log on to the Windows server machine as the Administrator for the local machine.
 Log on to the macOS server machine.
2.   Double-click Install_Cumulus _11xx_Web_Solutions.exe.
Under Windows, you may be requested to allow the start of the installer.
 Double-click Install Cumulus 11xx Web Solutions and authenticate yourself as an administrator.
The installation resources are extracted and you are asked to select a language (for the installation process as well as for the language dependent files to be installed).
3. Select a language and click OK. The installer is launched.
4. When the Introduction screen is displayed, click Next to continue, then follow the instructions on the subsequent screens until you are asked to Choose Features.
5. Select the desired feature and click Next.
6. Enter the path to the Cumulus web applications folder where you want to install the feature (e.g. C:\Program Files\Canto\Cumulus Web Solutions)
7. Follow the instructions on the subsequent screens. It is recommended to adopt the given suggestions.
The installation process will take some time.
8. When the installation is finished, the Install Complete window is displayed. Click Done to end the installation and close the window.
Windows: The Cumulus Web Solutions is registered as a Tomcat service and started automatically.
macOS: The Cumulus Web Solutions daemon is installed and started automatically.
If your Cumulus Web Solutions installation includes Cumulus Portals, the Web Server Console is opened in your default Web Browser in order to perform initial configuration steps. For details see Initially Configuring Cumulus Portals.
For the next steps, see the following chapter, Cumulus Web Solutions: Initial Steps.
NOTE: If you have installed Cumulus Web Solutions into an already existing Web application server, this Web application server software must be configured in order to run the Web Solutions (see Manual Tomcat Environment Configuration, for details).
Installing under UNIX
With UNIX versions of Cumulus Web Solutions, Canto provides a CONSOLE mode installation.
The CONSOLE mode installation guides you through all steps necessary to install Cumulus Web Solutions. To accept the default values [shown in square brackets] press the Enter key.
To install Cumulus Web Solutions under UNIX:
 
1. Open a UNIX shell as Administrator and change to the download directory.
2. Start the CONSOLE mode installation by entering:
sh C1100WebSolution.bin
3. Select a language. The installer is launched.
4. When the Introduction is displayed, press Enter to continue. The software license agreement is displayed.
5. Read the displayed license agreement and enter y to accept.
6. Select the desired features and press the Enter key to continue.
NOTE: If you want to install modules of the Cumulus Web Solutions into an already existing Web application server, use the Custom Installation set.
If you install the Web Solutions only, i.e. without the provided Apache Tomcat, you will be prompted to enter the path of the webapps subdirectory of your already existing Tomcat installation directory.
The default installation location is displayed.
7. To accept the default installation location, press Enter. If you prefer a different location, enter the absolute path for the desired installation folder and press Enter.
You are prompted to choose the features to be installed.
The Pre-Installation Summary is displayed.
8. Press Enter to start the installation.
The installer begins copying files. Import information on configuration ist displayed.
9. Press Enter to proceed.
When the installation is finished, the Install Complete information is displayed.
10. Press Enter to end the installation and exit.
The Cumulus Web Solutions server is installed but not registered. To be used, the Cumulus Web Solutions must be registered and stated as a service. For details on registering and starting/stopping, the Cumulus Web Solutions, see Linux: Registering and Starting.
For the next steps, see Cumulus Web Solutions: Initial Steps. IIf you your Cumulus Web Solutions installation includes Cumulus Portals, you must additionally perform some initial configuration steps in order to get Portals up and running. For details see Initially Configuring Cumulus Portals.
NOTE: If you have installed Cumulus Web Solutions into an already existing Web application server, this Web application server software must be configured in order to run the Web Solutions (see Manual Tomcat Environment Configuration, for details).
Activation
In order to use Cumulus Web Solutions, their respective licenses must be activated at the Cumulus Server. This applies to fully valid purchased licenses as well as to demo licenses.
Cumulus Web Solutions are activated as any other newly purchased Cumulus options via the Remote Admin module of the Cumulus (Web)Server Console. For details see Activation.