Install 3Sixty

Overview

The following steps will walk you through a typical installation of the current version of 3Sixty on premise (locally). For previous version requirements please see the Compatibility Matrix

To install 3Sixty Docker use the following instructions. 3Sixty Local Docker Development.

Step 1. Install Java

Important:  Java 17 is required for 3Sixty Version 4.1+

  1. Download the installer for your platform

  2. Select Temurin 17 (LTS) and click Latest Release

    1. Run the executable file

  3. You may need to give permission to allow changes to your advice.

  4. Follow the installer instructions.

    1. Make note of the installation location. You may need it for later steps.

Step 2. Install Apache Tomcat

  1. Download the Tomcat 10 package for your platform type.

  1. Start Tomcat

  • Mac Users: Following the instructions MAC install instructions for Tomcat for starting Tomcat from the command line.

  • Windows Users: Inside your tomcat installation, in the 'bin' folder, there is a file, tomcat9w.exe. This application acts a user interface for Tomcats. Allowing you to start/stop the process as well as altering variables like memory and logging locations.

  1. You can verify Tomcat has started by checking the url localhost:8080 (or whatever port you set). You should see a tomcat landing page.

  2. SHUTDOWN Tomcat for the 3Sixty installation.

Note:  
Set the JVM_opts MIN and MAX memory options. Setting your MAX to be as much as possible. -Xmx3072m -Xms1024

Tip:  Shared Loader (Optional)
A shared loader allows you to keep your simflofy-global.properties and mongo_db.properties from being overwritten when installing a new 3Sixty war file. When 3Sixty starts, the properties in the shared loader folder will take precedence over the ones in 3sixty-admin/WEB-INF/classes.

To set it up:

1. Open tomcat/conf/catalina.properties.
2. Add "${catalina.base}/shared/classes" to shared.loader.
3. If the folder tomcat/shared/classes folder does not exist, create it.
4. Put your simflofy-global.properties or mongo_db.properties file in the new folder.

Step 3. Install MongoDB

  1. Download MongoDB 6.x

  2. Verify Service is installed and running.

    • For Mac/Linux, you can simply type mongo into the command prompt, and you should be automatically taken to the mongo shell.

    • For Windows installations use Mongo Compass to create db or use mongo compass>mongosh.

  3. Create the 3Sixty database and user in MongoDB by executing the following commands in the mongo shell.

    use simflofy
    db.createUser({"user":"simflofy", "pwd":"password",
    "roles":["dbOwner"]});

Important:  Passwords
Remember to set your password using your organization's password policy. It's advised that you use a stronger password than "password".

Caution:  I keep getting the error in caused by when I try to start 3Sixty
In some cases, MongoDB will have some settings that need to be changed. If, during start-up, you encounter this (or a similar) error:

Caused by: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'simflofyGlobalProperties': Invocation of init method failed; nested exception is com.mongodb.MongoWriteException: error processing query: ns=simflofy_db.ts3SixtyPropertiesTree: key $eq "simflofy.initialize.mongo"

You will want to make sure the MongoDB notablescan setting is false. To do that, you can run these commands against your MongoDB:

Check notable scan
db.adminCommand( { getParameter: 1, notablescan: 1 } )

Set notable scan to false
db.adminCommand( { setParameter: 1, notablescan: 0 } )

Step 4. Install 3Sixty Admin Server

  1. Copy the 3Sixty Admin and discovery war files or expanded zip to Tomcat Installation Directory > webapps directory

  2. Start Tomcat

  3. Navigate to the mongo-db.properties file Tomcat > Webapps > 3Sixty > Admin > WEB-INF > classes > mongo-db.properties.

  4. Set the credentials for the user and the database connection details.

  5. Depending on what database you created the admin user in, you may have to append the database name to the end of the uri. This is the authenticating database. The following example config assumes you followed the previous steps exactly.

    mongo.db.username=simflofy

    mongo.db.password=#whatever password you set during mongo user creation

    mongo.db.uri=mongodb://[[USER]]:[[PASS]]@localhost:27017/simflofy

  6. In the same folder, open simflofy-global.properties and check if all of the 'initialize' properties are set to true. If not, set them to true and save. See the section on properties for more information.

  7. If you performed an optional step while installing Tomcat, move the global properties files to the shared/classes folder. Now the properties files will persist after redeploying the war.

  8. Restart Tomcat

    1. Windows users: Navigate to the Tomcat/bin folder and double click on Tomcat9w

    2. On the Java Tab add a 0 to the end of the Initial and Maximum memory pool limits

    3. From the General Tab select Start to start Tomcat

  9. In simflofy-global.properties set initialize properties to false

  10. Copy and paste the following into your browser

    http://(servername):(port)/3sixty-admin

    Default 3Sixty Username/Password is admin/admin.

Step 5 Configure Tomcat for SSL.

Use the Windows installer to install Tomcat.

Follow this guide to configure Tomcat for SSL on Mac or Linux.

You can find info on architecture/ports, getting to the user interface, changing passwords, and the command line utility in the Getting Started with 3Sixty Guide.

Troubleshooting: Check Java Version and check credentials in Mongo

 

Related Articles:

Quick Start User Guide

LDAP Configuration