AtomJump Messaging Appliance

Download VirtualBox for your platform (Windows / Linux / Mac), and the Messaging Appliance. On a Mac / Linux, we recommend that you download the Gzipped version of the Appliance, because the unzipped file is larger than some unzip software can handle.

Unzip the Appliance file, which should create a .vmdk file. For cloud users, you can import this .vmdk file into your cloud system, rather than import it into VirtualBox.

Run VirtualBox on your platform, and add a 'New' project.
Enter:
Type = Linux
Version = Debian (64-bit)

Note:
on Windows, if you can only see ‘Debian (32-bit)’ and you are definitely on a 64-bit machine, you will need to configure your server’s BIOS setting for virtualization to be switched on. See details here.

Click 'Continue' and then ‘Use an existing virtual hard disk drive’. Select the .vmdk file from your drive.

Run the VM and when you see a login after 20 seconds or so, enter the
Username: aj_customer
Password: lander5321

Once logged in, you should first change your password. Enter the line:
passwd
and enter your old and new passwords.

Then enter the line:
hostname -I
It should show you the VM server's IP address e.g. 10.0.2.15

Then enter 'Settings' for this Virtual Machine.
Go into 'Network' and click 'Port Forwarding'.
And add a new line similar to the above, using the Guest IP as the IP address found from the 'hostname -I' command.

Typical settings are:
Protocol: TCP
Host IP: 127.0.0.1
Host Port: 5100
Guest IP: 10.0.2.15 (or the IP address found after running 'hostname -I' within the server)
Guest Port: 80
The LiveWiki should now be accessible within a browser on http://127.0.0.1:5100
Technical Domain Note: You should decide on a domain/IP address that users of the system will enter to access your LiveWiki e.g. http://my.intranet.domain. Setting this up is beyond the scope of this guide, but there are several approaches. One option is to set a LAN domain on your router using DD-WRT (detailed here), or you can edit your 'hosts' file on each machine to point your chosen local domain at the server, or simply use a LAN-based IP address e.g 192.168.0.10. It is often a good idea to manually assign the IP of your server to your machine address (known as the 'mac address') within the router. For non-live situations, or if it is accessible on your own machine only, you can still use the default 127.0.0.1, but you won't be able to change this address later, quite so easily. You can also use a public-level domain e.g. mywiki.mycompany.com if your machine is serving over the internet.

Technical Port Note: rather than running this on port 5100, you can run this on the standard http and https ports (80 or 443) via port forwarding, which will save you having to enter the port number. We will use the port 5100 in the examples below, however, as this should work in the simple situation. If you decide to use secure transport, i.e. over https, you will also need to configure your secure key files manually on your server.

Technical Firewall Note: To be visible across the LAN you will likely need to open your machine's firewall for the port number used by your LiveWiki (e.g. 5100).


Once you have chosen this domain and set this up, run the LiveWiki from your chosen domain in a browser. Now click the ‘Update the server config’ link from the home page, which configures the messaging to run from the current domain, click 'Go Back', and try the large messaging button. Follow the instructions to set up the admin user. Then click through to the LiveWiki.

The main appliance target page is http://your.domain.or.ip:port/livewiki/

Important Note: the chosen admin user will have rights to enter passwords on a particular forum, limit subscribers to a particular group of people (based on their email domain), and rename forums.
If you are using the AtomJump Messaging app, and you want notifications on your phone:

Your phone should be connected to the same company Wifi or VPN network as the server. The address to use under the 'Private Server' link, or the 'Pair with a Private Server' address on the app homepage, is:

http://[your server IP or host]:5100/vendor/atomjump/loop-server/

E.g.
http://192.168.1.10:5100/vendor/atomjump/loop-server/
or
http://myhostname:5100/vendor/atomjump/loop-server/

Note: This is the same address to use if you want other server software to connect to your local AtomJump Server. If this connecting software is residing on the same machine, you can use the local server IP, also i.e.

http://127.0.0.1:5100/vendor/atomjump/loop-server/

Next Step: You should now carry out a software update, to resolve known security issues (see the section below).

Technical Specifications

Item Specification
Operating System Debian Linux 64-bit, but runs on a host Windows Desktop, Windows Server, Mac OS X, Linux.
Software Language PHP 7.1
Database MySQL 5.7
Host Disk Space Required 10GB
RAM Required 1GB minumum
Simultaneous Users 1 up to an approx maximum of 100, depending on usage patterns
Application Software AtomJump Messaging Server 2.9.1
Default Plugins Large Stickers, App Notifications, Basic Emoticons, Language Switcher (English and Spanish included), Immediate Auto-Responder
Default Interface LiveWiki
Access Super-user file-level access, Database access on request, AtomJump support access.
Support US$ 64 (NZ$100) for TeamViewer-based remote access, plus prices for individual tasks (see the LiveWiki add-ons)
Price Free
Number of messages Approx 10 million under standard disk space
Number of shared images Approx 50,000 under standard disk space
Software Updates Manual, Debian OS updates. Application updates can be done by Support.
Security The software should be run within an internal intranet, for any secure applications. A secure https server can also be used, although it needs an individual key installation.
Client Software
Mobile browsers (e.g. iPhone or Android), Desktop browsers (incl. Chrome / Firefox / Safari / Edge /IE). Future option: AtomJump Messaging app for mobile notifications.

Configuration

Log in, and enter the command:
sudo nano /jet/www/default/vendor/atomjump/loop-server/config/config.json
You can scroll down with the arrow keys. Under the "email" section, you can enter a configuration for sending off email notifications. Please see the User Guide for more details.

Once you have changed the file, you can hit 'Ctrl - O' together, then push 'Return'. It should say 'Wrote xx lines'. Push 'Ctrl - X' when done.

Warning: changes to the configuration files can make your system in-operable. We recommend backing up the file beforehand with e.g.
sudo cp /jet/www/default/vendor/atomjump/loop-server/config/config.json /jet/www/default/vendor/atomjump/loop-server/config/config-backup.json

Software Updates

We recommend bringing your operating system up-to-date immediately after installation, and then at regular intervals (e.g. monthly) after that. This is particularly important if this instance is visible over the internet, as opposed to a local intranet installation.

Log in and enter the commands:
sudo apt-get update; sudo apt-get upgrade
We also recommend updating your core Messaging Server software  immediately after installation, and then at regular intervals (e.g. monthly) after that. This is particularly important if this instance is visible over the internet, as opposed to a local intranet installation. It will also fix some known issues (as listed below).

Log in and enter the command:
eval "$(curl -fsSL https://git.atomjump.com/live-wiki-updates.git/update)"
Then, for versions prior to 0.7.7, click the following link to run a one-time update of your database:
[or using your own IP address at http://myipaddress:5100/vendor/atomjump/loop-server/update-indexes.php]

Notifications

By default, your Appliance will not be able to send emails (even if it gives some messages to say that you should confirm your email address. You presently do not have to confirm your email address to keep your account). To enable email sending you should see the 'Configuration' section, above.

In order to get popup-notifications to your Android or iPhones from your Messaging Appliance, we currently recommend using an email address that you don't mind having an audible/popup notification on from an email app. We are working on extending the AtomJump Messaging app itself for live notifications from your appliance. You can expect this feature to be released in 2021.

Importing Into Cloud Systems

These instructions may change over time, depending on the particular cloud provider. The AtomJump Messaging appliance is a .vdmk file (once it is unzipped).


Note: AtomJump has no affiliation with any of these providers.

You are welcome to let us know if you manage to successfully import an AtomJump Messaging .vdmk, or not, with your provider.

Known Issues

1. On an Android phone, if you are using a non-secure http address for your server, and your phone browser's setting's 'Lite Mode' is switched on, you will likely find images seem to flicker every 5 seconds or so.

We would recommend switching 'Lite Mode' off to stop the flickering in your Chrome Browser's Settings page.
Alternatively, once you associate an https domain with the server, the problem should disappear.

2. You cannot use ampersands '&' in the title of a forum. Please use an alternative.

3. Versions prior to 0.7.7: Vertically oriented images might be blurry. Please see 'Software Updates' above, and run an update on the Messaging Server software to resolve this issue.

4. Versions 0.8.0 and prior, have a security issue for notifications set up via the app, so we strongly recommend carrying out a software update immediately. Please see 'Software Updates' above to resolve this issue.

Prior Versions