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.

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

Step 2: Install Apache Tomcat

 

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