2. Install & Run SocrateCloud

To get SocrateCloud running the following steps are necessary:

    • Get SocrateCloud setup kit

    • Install SocrateCloud

    • Start user interface

Getting SocrateCloud setup kit

The setup kit can be downloaded from BITSoftware's WebStore. Please contact BIT Software for access.

Additional components (if any) are also downloaded from BITSoftware's WebStore.

Installing SocrateCloud

SocrateCloud installation is performed in two phases:

    • the build phase packages the modules that will be deployed

    • the deploy phase is for deploying the modules created by the build phase to GlassFish server

Build phase

The following steps should be performed:

    • Unpack the setup archive

    • Copy, if any, additional components to folder <kit unpack directory>/components

    • Start RUN_Install.{bat|sh} (.bat if running on Windows, .sh if running on Linux) from the <kit unpack directory>

    • At the end of the build you will be asked if you want to create a SocrateCloud database. Answer with Yes to create a database.

Note: If you choose No at this point you can create the database later by running the RUN_DBImport.{bat|sh} (.bat if running on Windows, .sh if running on Linux) from the <kit unpack directory>

However, if you do not have a SocrateCloud database you will not be able to configure GlassFish Server for SocrateCloud deployment.

    • at the end of a successfull build phase you should read the message <<<<<<<< Installer Done (... min .. sec) >>>>>>>>

Deploy phase

The following steps should be performed:

  • Configure GlassFish Server

    • Create database connection pool

      • Open GlassFish Server Administration Console by navigating the web browser to http://localhost:4848 (this url is valid for the situation when the web browser is started on the same machine where GlassFish server is installed)

      • In the left side navigation tree select Resources -> JDBC -> JDBC Connection Pools and click New... button

      • In the page that opens fill in Pool Name=<name of Oracle server>, Resource Type=javax.sql.DataSource and Database Driver Vendor=Oracle. Then click Next...

      • In the next page set following properties:

      • Ping=Enabled

      • Initial and Minimum Pool Size=10

      • Maximum Pool Size=100

      • Pool Resize Quantity=5

      • Idle Timeout=300

      • Max Wait Time=0

      • Non Transactional Connections=Enabled

In the Additional Properties section of the page fill in the following properties:

      • serverName: name or IP of the Oracle Database server

        • portNumber: database port

        • databaseName: name of the database

        • user: name of Oracle database user

        • password: Oracle database user password

        • url: string in the format: jdbc:oracle:thin:@<serverName>:<portNumber>:<databaseName>

        • In case you want to connect to the server using also the Java client application you need to include in the url also the user and password like this:

        • jdbc:oracle:thin:user/password@<serverName>:<portNumber>:<databaseName>

After filling in all these properties click Finish button.

      • The result should be Ping succeeded. If instead an error appears check Additional Properties values if they have correct values to connect to SocrateCloud database or check if you performed all the steps from GlassFish Server configuration

      • Open the newly created configuration, go to Advanced tab and set the following properties in Connection Validation section

        • Connection Validation=Required

        • Validation Method=custom-validation

        • Validation Class Name=org.glassfish.api.jdbc.validation.OacleConnectionValidation

    • Create SocrateCloudMainDatasource JDBC resource

      • In the left side navigation tree select Resources -> JDBC -> JDBC Resources and click New... button

      • In the page that opens set the following properties:

        • JNDI Name=SocrateCloudMainDatasource (this name is mandatory. Do not use other name!)

        • Pool Name=<name of database connection pool previously created>

    • Deploy SocrateCloud modules

Modules can be deployed in different ways, each one producing the same result.

      • Deployment using GlassFish Server Administration Console

        • Open Administration Console by navigating the web browser to http://localhost:4848 (this url is valid for the situation when the web browser is started on the same machine where GlassFish server is installed)

        • In the left side navigation tree select Applications and click Deploy... button

        • Click Choose File button, select one module from <kit unpack directory>/dist and click OK button

        • Repeat for every module that exists in <kit unpack directory>/dist

      • Deployment using GlassFish Server command line utility asadmin

      • Open a command line console and change directory to <glassfish install dir>/glassfish/bin

        • Run the command asadmin deploy <kit unpack directory>/dist/<module file name>

Example: asadmin deploy E:/SocrateCloudKit/dist/server.ear

Post deploy configurations

After deployment there are necessary to perform some configuration so that the SocrateCloud web modules can communicate with each other.

The steps to perform are the following:

  • Open SocrateCloud Web User Interface

  • Login with user System (default password is System) and role System - System Administrator

  • Select the menu System Admin -> System Management -> Web Modules

    • In the Window that opens create records for each deployed module and set the following fields:

      • Web Module Type = module type for which configuration is performed

      • Application Server Type = Glassfish

      • Host Address = Host address of the GlassFish server running SocrateCloud. Do NOT use localhost. It should be a name that is callable from network

      • Port = HTTP/HTTPS port of the GlassFish server running SocrateCloud

      • SSL = indicates if the module uses SSL for access

    • Reset client/server cache

Click the button from the upper right corner and select Tools -> Cache Reset Client + Server

Running SocrateCloud

Starting Web User Interface

The Web User Interface of SocrateCloud is started by navigating your web browser to http[s]://<GlassFish Server Name>[:port]/soweb

Note: You can find out this URL by opening GlassFish Server Administration Console, editing the soweb application and clicking the Launch link of the soweb.war component.

Starting Java User Interface

The Java User Interface of SocrateCloud is started performing the following steps:

  • Navigate your web browser to http[s]://<GlassFish Server Name>[:port]/admin

Note: You can find out this URL also by opening GlassFish Server Administration Console, editing the jclient application and clicking the Launch link of the jclient.war component

    • In the page that opens click the link Click Here to WebStart Me Now

The Java client application will download and start.

Note: In case application will not start but you get the message "Application Blocked by Security Settings" you have to add the URL to the GlassFish site (http[s]://<GlassFish Server Name>[:port]) in the Exception Site List in Java security.

To do that see https://www.java.com/en/download/exception_sitelist.jsp

    • On the login window that opens click on the Server input to configure the connection to the SocrateCloud server

    • In the dialog that opens fill in the following fields:

      • Application Type = GlassFish

      • Application Host = GlassFish Server Name or IP

      • Application Port = GlassFish Server port

      • Connection = LAN

Then click the button Test Application Server. After the test finishes click OK button to return to the login window