↓ Slide 1

Linux Setup Guide

In slideshow mode, use arrow keys or the navigation buttons at lower right of screen to move forward/back.

This guide will assist you getting ProfitTrailer running on an Ubuntu Server.
The process will be roughly the same for other Linux versions.

↓ Slide 2

Contents

  • Connect to Linux
  • Installing Java (and other things)
  • Downloading ProfitTrailer
  • Mandatory Settings
  • Running ProfitTrailer
  • Setup a Second Bot
↓ Slide 3

Getting Started with ProfitTrailer on Linux

First of all, note that running the bot 24/7 is not possible if you allow your PC to fall asleep or close a laptop as the bot will not run anymore. You may want to consider using a VPS instead of installing it on a dedicated computer.

↓ Slide 4

1.Connect to Linux

We need some software to connect from your home computer to the linux server.
Use anything you are comfortable with however we suggest you download:

→ Slide 5

In this guide we will use WinSCP. WinSCP allows you to connect to the server, FTP files, edit files and has PuTTY integrated into the app. So in english it can move files, edit files and also connect to the terminal in one nice little free app.

→ Slide 6

Your VPS provider will have given you access information: an IP Address, username and password. In our example, we have a root user, which is fine. Use this info to open a terminal window to your new VPS. Here we open WinSCP and set up a new connection.

→ Slide 7

Enter the Hostname (IP address), User name (root) and Password and click login. You may need to allow the connection and will be able to chose a name to save the connection as for future use.

→ Slide 8

In WinSCP, click the terminal icon in the menu bar to get to a terminal:

→ Slide 9

We are now connected to the server.

→ Slide 10

2. Installing Java (and other things)

We need to make a directory for ProfitTrailer. Use the cd command to change to the root directory of your choice. I like to drop my bots into the /var/opt folder

→ Slide 11

Enter the following commands one line at a time:

cd ..
cd /var/opt
mkdir pt
cd pt
→ Slide 12

You should now be inside a folder called pt in your /var/opt path
The prompt will look similar to this:
root@profittrailer:/var/opt/pt#

→ Slide 13

Run an update:

sudo apt-get update



Install Java 8:

sudo apt-get install openjdk-8-jdk


Be advised: You need JAVA 8. Version 9 or 10 are not supported.

→ Slide 14

Install Nodejs and create a symlink from the /nodejs to /node folder:

curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt-get install -y nodejs

sudo ln -s /usr/bin/nodejs /usr/bin/node
[this is optional and may not be needed]


→ Slide 15

Recently new installs have had issues with pm2 not starting correctly. Update Node using the previous commands if you have issues

→ Slide 16

Install npm and use npm to install pm2:
npm may already be installed and if so you will receive dependencies errors. skip to pm2 install:

sudo apt-get install npm
sudo npm install pm2@latest -g
→ Slide 17

pm2 is a process manager – it lets you run the bot in the background, and has features to autostart, log-rotation and much more. You do not HAVE to use pm2, but we like it, especially from running multiple bots. http://pm2.keymetrics.io/docs/usage/quick-start/

→ Slide 18

At this point you have all the apps and tools you need to run the Profit Trailer.

  • Java to run the jar
  • Nodejs to run pm2
  • Pm2 to manage your bot process, log windows and logs
→ Slide 19

Type pm2 at your prompt and you should get a list of pm2 commands. This will verify everything is running as expected.

→ Slide 20

3. Downloading ProfitTrailer

I like to download the bot to my local machine, edit the configs and then upload everything to the VPS at one time. I’ll show you how I do that. If you are familiar with Linux, you can certainly download and unzip the bot directly to your working folder.

→ Slide 21

Go to this link: https://github.com/taniman/profit-trailer/releases.
Download the latest release.
Right click on the zip and select Extract All.

→ Slide 22

Choose a location to extract to, for example on the desktop.

→ Slide 23

You should have something similar to:

→ Slide 24

4. Configuring ProfitTrailer

Open WinSCP, and connect to your VPS if not already.
Select the “Open directory/bookmark” icon and type in /var/opt/pt

→ Slide 25

This should bring you to your pt folder:

→ Slide 26

In the left hand window of WinSCP, find your new PT folder, the one you just unzipped from the download.
Things should look like this:

→ Slide 27

Simply select and drag all of the files from the left window to the right window.

→ Slide 28

You now have the PT files on your VPS, and are ready to start editing configs.
You can double-click on a file in WinSCP to edit that file (left and right panels). The bot will be using the files on the right panel, in the /var/opt/pt folder.

→ Slide 29

At this point, you can minimize WinSCP and go back to your terminal window (or click on the terminal icon to connect again)

→ Slide 30

5. Mandatory Settings

Now we can proceed to setup the Mandatory Settings before attempting to run the bot.

  • This guide only includes an example application properties file, so please check the other parts of the wiki for settings, before you go ahead and run the bot on random settings without knowing what they do.
→ Slide 31
→ Slide 32

6. Running ProfitTrailer

Now for the fun part. To run your bot, you first navigate to your pt folder

cd /var/opt/pt



Change the permission on the JAR file so it will execute correctly

chmod +x ProfitTrailer.jar
→ Slide 33

Start the bot using pm2:

pm2 start pm2-ProfitTrailer.json


→ Slide 34

At this point, the bot is running. To see the live log scrolling by, type pm2 log 0. You use CTRL-C to get out of the window.

pm2 log 0         	See log live
pm2 stop 0       	Stop the bot
pm2 reload 0   	reload and restart the bot
→ Slide 35

Text logs are maintained by pm2 and are located at /root/.pm2/ (for my root account access)

→ Slide 36

Run a save and startup command. After this is complete, PM2 will restart your bot if you restart the server. Run this command again if you change your app, or add a second bot.

pm2 save
pm2 startup
→ Slide 37

To run Profit Trailer without Pm2 you can still execute the same java command as any other operating system.

java -Djava.net.preferIPv4Stack=true -Dsun.stdout.encoding=UTF-8 -Dio.netty.allocator.numDirectArenas=0 -Djdk.nio.maxCachedBufferSize=262144 -XX:+UseSerialGC -XX:+UseStringDeduplication -Xms64m -Xmx512m -XX:CompressedClassSpaceSize=300m -XX:MaxMetaspaceSize=128m -jar ProfitTrailer.jar
→ Slide 38

Your ProfitTrailer bot is now up and running. Congratulations!
Now go to http://localhost:8081 if it did not open automatically. (adjust port if you have used a different one)

→ Slide 39

When you open the GUI for the first time you will be asked to set a password. You will also need to enter your default_api_key to confirm you are the owner.

→ Slide 40

If successful you will then be asked to Login.

→ Slide 41

Finally you will be see the Config Load screen.

  • Public - Choose from our database of public configs and copy it to your bot giving it a unique name.
  • Saved - Choose from one of your own configs that you have already created in the past.

→ Slide 42

7. Setup a Second bot

Time to go bigger? Running a second bot is fairly straightforward.

→ Slide 43

Make a second folder in your /var/opt/ folder, maybe pt2

/var/opt/pt2

Upload a copy of your Profit Bot to this folder.

→ Slide 44

Edit the application.properties file and change the port number - I increment them by 1
(If these variables do not exist, add them)
In /var/opt/pt/application.properties

server.port = 8081

In /var/op/pt2/application.properties

server.port = 8082
→ Slide 45

8. Running the second instance with pm2

You will need to edit /var/opt/pt/pm2-start.json in order to change the Application name. Pm2 requires unique application names. I like to edit all of my start jsons to be descriptive of the bot:

→ Slide 46

Just start the second bot the same way you started the first.
Navigate to the 2nd bot folder in the command line, then type:
pm2 start pm2-ProfitTrailer.json
This will display PT Polo as the app name in the pm2 list.

→ Slide 47

This concludes the ProfitTrailer Linux Setup Guide

  • linux_guide.txt
  • Last modified: 5 weeks ago
  • by taniman