Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section
Column

 Windows:

  1. Open a command prompt. Navigate to <frevvo-home>\solr-x.x.x. Type bin\solr.cmd start to run the Insight server in the background, listening on the default port 8983.



    You will see this message: 

  2. Browse http:<your server:port>/solr to verify the Insight server is running. The <server:port> default values are localhost:8983. Change <your server>  to the server name and <your port> to the port the Insight server is running on if they are different than the defaults. Do not include the angle brackets <>. You will see the Insight server (Solr) dashboard with the current status:

Warning

If you close the Insight server (Solr) startup window, the server will stop running. Leave the window open or set up Live Forms frevvo and the Insight Server to run as Windows services.

Column

Linux:

  1. Ensure that the scripts are executable: chmod 755 <frevvo-home>/tomcat/bin/*.sh
  2. Navigate to <frevvo-home>/solr-x.x.x/bin. Run this command to make the solr startup file executable:

    chmod +x solr
  3. Navigate back to the solr-x.x.x directory.
  4. Start the Insight server by typing bin/solr start - this starts the Insight server in the background, listening on the default port 8983.
  5. Browse http:<your server:port>/solr to verify the Insight server is running. The <server:port> default values are localhost:8983. Change <your server>  to the server name and <your port> to the port the Insight server is running on if they are different than the defaults. Do not include the angle brackets <>. You will see the Insight server (Solr) dashboard with the current status:

...

To stop a particular instance of the Insight Server, use the -p option to specify the port number that the Insight Server process is running on. Ex: bin\solr.cmd stop -p 8983


Running

...

frevvo and the Insight Server as Windows Services

The Insight Server must be started BEFORE

Frevvoproduct
 from a command prompt, or you will see a Configuration Checklist warning and you will not be able to proceed. If you close the Insight Server startup window, on a Windows system, the server will stop running. You can leave the window open or set up Live Forms frevvo and the Insight Server to run as Windows services.

...

  1. Install the Insight Server as a Windows service
  2. Install Live Forms frevvo as a Windows service
  3. Add a Dependency to the Live Forms frevvo service

Install the Insight Server as a Windows Service

...

  1. Extract the NSSM zipfile to a Program Files\nssm directory
  2. Open a command prompt. Run as an administrator
  3. Navigate to the directory under c:\Program Files\nssm\ that contains the nssm.exe file for Windows64 or Windows32

    Code Block
    For example, the path in Windows 7 would be C:\Program Files\nssm\nssm-2.24\win64
  4. Type: nssm install <service name> - Replace <service name> with the name you want to use for the Insight Server service.

    Code Block
    Ex: nssm install insightserver
  5. Browse to the location of the solr.cmd script by clicking on the three dots to the right of the Application Path field. This should be in <frevvo-home>\solr-x.x.x\bin.



  6. Click on the solr.cmd file, then click Open.  The Application Path field will populate.

  7. Notice the Startup directory field also populates. REMOVE bin from the Startup directory field. The Startup directory should be: c:\<frevvo-home>\solr-x.x.x\

  8. Enter these Arguments:

    start -f -p 8983

    • the -f option starts the Insight Server in the foreground so NSSM can kill it when it needs to be stopped or started
    • the -p option specifies the port that the Insight Server is running on. The default is 8983. Change 8983 to the port number for your installation if necessary.



  9. Optionally, click the Details tab to specify a Display Name and Description - Ex: Insight Server, Script to Stop/Start Solr5. Notice the Startup type is set to Automatic.

  10. Click the Install service button. A success message displays:



  11. Start the Insight Server service from the Computer Management Services pane.



  12. Browse http://<your server:port>/solr to verify the Insight server is running. The <server:port> default values are localhost:8983. Change <your server>  to the server name and <your port> to the port the Insight server is running on if they are different than the defaults. Do not include the angle brackets <>. You will see the Insight server dashboard with the current status:

Install

...

frevvo as a Windows service

There are batch files in the <frevvo-home> directory to Install/Configure

Frevvoproduct
as a Windows service. Refer to Installing Live Forms frevvo as a Windows Service for more details and troubleshooting tips.

  1. Navigate to <frevvo-home>. Run the Install-Service batch file as an administrator to install
    Frevvoproduct
    as a service.
  2. Configure the

    Frevvoproduct
    service if you are using Windows 64 bit by clicking on the Configure Service batch file. You must run the Configure-Service batch file as an administrator.

    1. Change the mode on the Startup and Shutdown tabs from jvm to javatype to Automatic. Save the changes.
      Image Removed

  3. Frevvoproduct
    will appear under Windows services with the name frevvoforms with a Startup type of Manual. Change Startup Type to Automatic (Delayed Start), then start the service.

Add a Dependency to the

...

frevvo service

Once the two services are installed and started, add a dependency to the Insight server for the frevvoforms service. The dependency ensures that the Insight service is running before the frevvoforms service starts.

  1. From the administrative command prompt, type the following command with the name you gave to the Insight Server service:

    Code Block
    sc config frevvoforms depend= <name of the Insight Server service>



  2. Check the Dependencies tab of your Insight Server service in the Windows Services list. It should list frevvoforms as a system component that depends on the Insight service.



  3. If you manually stop the Insight Server service, it will ask you if you want to stop Live Forms.
    Image Removedfrevvo.

    Image Added

Insight Server Security

Solr should only be accessible to the frevvo server i.e. http://localhost:8983/, and should not be remotely accessible. Most customers don’t allow external http access to a server (only https). Since solr is not exposed over https, remote code execution vulnerability can be mitigated (a remote attacker cannot exploit this vulnerability as it is not exposed). Another option to enhance solr security is to block external access to port 8983, for example using firewall rules.

frevvo accesses solr via the client API and does not use velocity. It also encodes all solr query parameters, so it is not possible to attack via injection.

Troubleshooting Tips

Insight Server Log

Indexing related messages are captured in the <frevvo-home>\tomcat\logs\frevvo.YYYY-MM-DD file. For example, if you run the Insight Data Batch process manually or if it runs automatically during an upgrade, messages from the process are found in the frevvo.log.