Editing OGV on FreeBSD

== Getting Ready ==

Since Meteor installer doesn't support freeBSD operating system, we need to manually build and compile the meteor source code. Currently, this method is tested on version '''10.2-RELEASE-p18'''

If possible, use a freshly installed freeBSD system. Any trace of node/npm can create problems while compilation, Most of the problems I faced were because of some old/unsupported version of node and npm.

== Installing few packages ==

We need to install some packages in order to start our meteor compilation.

<code>$ sudo pkg install -y bash git gmake mongodb node npm python</code>

== Installing Meteor ==

=== Step 1 : Clone the Repository ===

The first step is to get the meteor source code on your machine. I cloned it in home directory, so it's easy to execute meteor script, using $HOME variable.<br />
<code>$ cd $HOME</code><br /><br />
<code>$ git clone --depth 1 https://github.com/4commerce-technologies-AG/meteor</code>

=== Step 2: Build the node module ===

Next cd into the cloned directory by<br />
<code>$ cd $HOME/meteor</code> <br /><br />
#Execute the build node script in scripts folder <br /><code>$ scripts/build-node-for-dev-bundle.sh</code><br /><br />
#Execute the generate bundle script <br /><code> $ scripts/generate-dev-bundle.sh </code><br />

''The above two scripts execution may take some time depending upon the configuration of the host machine. So have a little patience while executing them ;)''

=== Step 3: Give meteor it's first try ===

Now meteor is installed successfully and you can give it first try by<br />
<code> $ $HOME/meteor/meteor --version </code>

''The above-mentioned code of line assumes that your meteor folder is in the home directory''

== Get OGV ==
Now that meteor is successfully installed, it's time to run OGV on system.
Clone OGV from it's official repository by<br />
<code> git clone https://github.com/BRL-CAD/OGV.git </code>
<br /><br />
Go to the OGV app directory <br />
<code> $ cd /path/to/clone/OGV-Meteor/OGV </code><br /><br />
Run meteor using the following command <br />
<code> $ $HOME/meteor/meteor </code>

== Keep OGV running on a server ==
If you are working on a cloud server and want OGV to keep running, even if you close the connection, you can do so by using tmux.
<br /><br />
Install tmux by<br />
<code>$ sudo pkg install tmux </code><br /><br />
Start tmux session by <br />
<code>$ tmux </code><br /> <br />
Run meteor inside tmux session in the usual way.
Get out of the session using <code> Ctrl + b </code> and then press the key '''D''' on keyboard to detach from that session. Now you can safely log out and it won't end the meteor process you started inside tmux session.