FTP configuration

Configuring the FTP section of jSunnyreports can be tricky. This page will hopefully help you with this.

FTP Configuration

To configure the FTP part you will need to fill in the right items in your settings.conf file.

ftp.host=
ftp.username=
ftp.password=
ftp.remotedir=
ftp.active=0
ftp.threads=3

The easiest way to explain all this is with an example.

ftp.host=ftp.jsunnyreports.com
ftp.username=martin
ftp.password=mypassword
ftp.remotedir=/wwwroot/test
ftp.active=0
ftp.threads=3

What this entry says is: Connect to “ftp.jsunnyreports.com“, when asked: use “martin” as a username and “mypassword” as a password. When the login is successfull change the remote directory to “/wwwroot/test” and start to upload all the files there and use “3” different connections to upload the files.

If you have your own domain, e.g. jsunnyreports.com, you will have the ability to create your own account there using the admin dashboard of your domain. If you do not own a domain you will probably own a website plus ftp account provided by your internet provider.

Test connection

It can be quite cumbersome to test the FTP connection data with jSunnyreports. Its much easier to use a seperate FTP tool to test your connection and remote directory entry. You can download and use Filezilla for free. In this section I will use Filezilla to explain how to test your configuration.

You can download the Filezilla Client from: https://filezilla-project.org/

After installation start Filezilla.

filezilla_1

The basic interface looks similar to the normal Windows Explorer.

To create a connection go to “File” –> “Site Manager” Or press the key combination: “CTRL + S”

filezilla_2

This is the site manager. Press the button “New Site” to create a new entry.

filezilla_3

Enter a name for this connection and fill in the information. For instance:

filezilla_4

Now press “OK”. Your entry is now saved. Open the Site manager again by pressing “CTRL + S”. Now click on your connection and press connect:

If all goes well you will see:

filezilla_5

You have successfully logged on to your FTP site. On the right you see the contents of the remote directory. In this case the start, or root, of your FTP site. In my case everything under the directory “wwwroot” is accessible from your web browser. This directory might be called differently in your case. Or your root directory might be your website right away!

In this case I have to navigate to the wwwroot directory.

filezilla_6

I have made a directory called “test” as you can see. To create a directory right click with your mouse for more options.

Now navigate to the test directory:

filezilla_7

And there you have it. The empty directory where we want to upload jSunnyreports to.

 

jSunnyreports FTP engine

jSunnyreports is highly optimized not to do things when it should not have to. jSunnyreports will only upload files that have changed since the last time you ran it. If you ran jSunnyreports before as a test it will only upload the changed files and not the full website!

There are two options.

  1. Clean up jSunnyreports by removing the cache files
  2. Use Filezilla to upload everything manually.

Both are explained here. Option 2 is the prefered option here!

Clean up jSunnyreports

You will have to remove the following files:

In your jSunnyreports directory:

  • Remove filecache.jsun
  • Remove inverterdata.jsun

Then go to your output directory you have defined in settings.conf and remove everything from this location.

And now run jSunnyreports again. Al files will be created again and everything will be uploaded by jSunnyreports.

Filezilla

Open filezilla and connect to your FTP site. Now navigate to your local output directory. In my case this is p:\jsunnyreports\development_output\ . You will see all the created files in here.

fz_1

Select all files on the left by using “CTRL + A ”

fz_2

Now drag everything from the left to the right. Everything will be uploaded now.

fz_3

Now wait a few minutes and you’re set. Every time you run jSunnyreports only the changed files will be uploaded and everything is up to date.