fileXhub Personal Edition Documentation

fileXhub™ 1.2 Personal Edition


1.1. Introduction

This guide provides documentation for running fileXhub™ Personal Edition from Amazon EC2 Marketplace. It is assumed that you have already started an instance of fileXhub™ Personal Edition.

1.2. fileXhub™ Personal Edition

fileXhub™ Personal Edition(BIT file transfer hub) provides a user portal for exchanging files. It also secures your data by encrypting the data before storing it in an encrypted database. It is based on fileXhub Enterprise Edition

.



2. Quick Start

After completing this entire Quick Start section, you will have a fully functioning installation of fileXhub™ Personal Edition. You will then be ready to proceed to the Trading Partner tutorial.



2.1. fileXhub™ Personal Edition

fileXhub™ Personal Editionhas been preinstalled and is automatically started when your EC2 instance is booted. It is recommended (but not required) to associate an Elastic IP Address for your instance.


2.1.1 fileXhub™ Personal Edition Login

We will begin by logging into the fileXhub™ Personal Edition Admin web interface. The admin interface is your tool for managing the user profiles of those with whom you want to exchange files. For example, you may want to receive electronic purchase orders from your customers, and then send them electronic invoices. You would use the fileXhub™ Personal Edition Admin interface to manage each trading partner's access to fileXhub™ Personal Edition to send orders to you and receive invoices from you.


To Login: http://Your EC2 Domain Name or Elastic IP Address/admin

username password
admin (AWS EC2 Instance ID)



Your initial password is the instance ID assigned to your new instance by Amazon AWS. You will see this id on your EC2 Management Console by clicking 'Instances'.


After a successful login you will see a screen similar to below.

If this fails you probably did NOT start fileXhub™ Personal Edition with the required privileges.



2.1.1.1 Change ADMIN password

Click on the change link next to the ADMIN user under the Password column. Please enter a new password to secure fileXhub Personal Edition further.



2.2. Test Install

We will create a new user to confirm that the installation and start-up completed successfully. We will use this new user ID in the Trading Partner tutorial.

Verify that fileXhub™ Personal Edition is running and that you are still logged in from step 3.3.1.

Fill out the User form and click submit:

  • Set username to test.
  • Set password to password.
  • Set Contact Name to Trading Partner.
  • Set Company Name to Tutorial.
  • Set Email to {any valid email address}.
  • Set Phone to 3146356351.

username and password are mandatory. The other fields are optional and are not required for this test. They are for information purposes only.


If your new user "test / Trading Partner" is successfully created, the screen will refresh and you will see a result similar to below. You will see "user created successfully!" at the top, and it will be listed in the Current Users table at the bottom of the screen.


This is proof your installation is working. You are now ready to progress to the next section, the Trading Partner tutorial.


3. Trading Partner Tutorial

File transfer with your trading partners is made very easy with fileXhub™. For both inbound messages (Trading Partner to you) and outbound messages (you to Trading Partner), simply create a username & password for the Trading Partner in the fileXhub™ Admin interface. This will enable you to manage the settings in fileXhub™ and EME for the sending and receiving of messages for that Trading Partner.

In fileXhub™, "inbound/in" and "outbound/out" always refer to the point of view of the Enterprise (you), never from the point of view of the Trading Partner. "Inbound" always refers to messages coming from the Trading Partner TO you; "outbound" always refers to messages going FROM you to the Trading Partner.



3.1. Trading Partner Example

In this section, we will use the Trading Partner that we added in section 3.4 to confirm that fileXhub™ Personal Edition was installed correctly.

Verify that fileXhub™ Personal Edition is running before proceeding with this tutorial.


3.1.1. Send Inbound Message

Now we can test sending an inbound message as the fileXhub™ Personal Edition trading partner we created, test. We are going to use the fileXhub™ Personal Edition Web Portal, which is the web interface that is available to your trading partners.


Login to the fileXhub™ Personal Edition Web Portal with our newly created user: http://Your EC2 Domain Name or Elastic IP Address/portal

username password
test password


Click the Upload tab to select a file to send to fileXhub™ Personal Edition.

You will see a screen similar to below.

You will specify what type of file it is, either binary or text. Let's send the text file that is posted on our Download page as a zip archive. It is an EDI standard 810 invoice. Using the Browse tool, select the file 810.edi from the directory where you extracted it from the zip archive. Change the Content Type selection to Text.

Microsoft Word documents, Microsoft Excel spreadsheets, and PDFs are actually binary file types.

When you have selected the file, click upload.

After the upload, the screen refreshes to view the Inbox tab. You will see the file listed, similar to the screen below.



Now let's check the admin interface that we used in section 3.4 where we can verify that the 810.txt file uploaded by the trading partner is available for you to pick up. Click the Messages tab and you will see the file where you can manually open or download it, or delete it. Click the Audit tab to see a log of the events that have taken place for that file. The audit log is useful for confirming transaction events with a trading partner.

The following two screen shots show the Messages tab and the Audit tab.





3.1.2. Send Outbound Message

Next we will test sending a message outbound to our Trading Partner, test by using the admin interface to upload a file. Make sure you are still logged in to the admin interface, and click the Upload tab to send the same 810.txt file out to the trading partner. Make a copy of the text file and give it a new name, such as 810-outbound.txt, so you can distinguish between the 2 files.

Change Content Type to Text, Direction should be Out, and enter TEST in the Username field. Click Browse and select the 810.text file from your system directory and click upload.

Your screen will look similar to the one below.

After the upload, the screen refreshes to view the Messages tab. You will see the file listed, similar to the screen below.

Now let's check the portal interface that the trading partner uses, and we can verify that the 810-outbound.txt file you uploaded is available for the trading partner to pick up. Click the Outbox tab and you will see the file where you can manually open or download it, or delete it.

You will see a screen similar to the one below.


This is the end of the tutorial. You have learned how to:
  • add a Trading Partner
  • send files inbound - from a Trading Partner
  • send files outbound - to a Trading Partner