System Requirements

You will need a computer with a graphical user interface:

  • MacOS
  • Linux
  • Windows
  • Solaris

A headless server is not sufficient since you need to log-in at the appliance console to power-off when updates are required.

Minimum recommeded resources:

  • x86 Compatible, quad-core processor
  • 4 GB RAM
  • 70 GB Free disc space

Download

The appliance consists of 2 virtual machines compressed into password-protected 7Zip archives. The password and download links are contained in the information email you get from us.

If you don't have software capable of decompressing 7Zip install a free application now such as Keka for MacOS, 7Zip for Windows and many packages for Linux.

Download both 7Zip archives, uncompress and place in a folder called 'TransPDF Appliance' The combined, uncompressed size of both VMs is around 20GB.

The transpdf-DB VM will hold your users PDFs and data so it must be stored where it will have room to expand.

Install Virtual Box

If you don't already have it, dowload and install Virtual Box from www.virtualbox.org

When you start the software for the first time it will prompt you to download the current extension package. Follow the instructions and install the extension pack.

Add VMs To Virtual Box

To make Virtual Box aware of each VM you need to double-click each .vbox file:

  • TransPDF Appliance/transpdf-DB/transpdf-DB.vbox
  • TransPDF Appliance/transpdf-WWW/transpdf-WWW.vbox

This will add them both and group them into the TransPDF Intranet group in the Virtual Box window.

VirtualBox Screenshot

Configure Networking

The web server appliance needs to talk to the database appliance via a private network and to machines on your network.

Open the Preferences... panel in VirtualBox then click Network then click the + button to create a new NAT network.
VirtualBox Screenshot

Ensure the name used is 'NatNetwork' and the values are as shown in the screenshot below.
VirtualBox Screenshot

Click on the Port Forwarding button and add a new configuration with the values as shown below. You have then finished with the NAT configuration.
VirtualBox Screenshot

Back in the Oracle VM VirtualBox Manager window, click on the transpdf-WWW appliance and then click Settings then Network. This will show the first of the two network adaptors for that appliance.
VirtualBox Screenshot

Ensure that Adaptor 1 is set to a valid network device. Your device (wifi, lan etc.) will have a different name than shown here. Do not alter any of the other settings.

Start The VMs

Click on the title bar of the TransPDF Intranet group to select it then click in the Virtual Box toolbar.

The database VM will start first followed by the translation server. After a short delay each VM window should display the login-prompt. The system is now ready for use.

VM Startup Screenshot VM Startup Screenshot

Accessing the Server

The homepage URL is: http://transpdf.local

If this does not work, look at the console window for the TransPDF-WWW machine. You should see two ip addresses just above the login-prompt. The first is the address on your local network. Use this ip address to access the machine's website.

If you need to change the name of the server on your network, you will have to let the system know the new name. Do this by accessing the admin interface :
Username: admin
Password: *****
The password will have been included in the information email from us.

Domain name is the actual URL of the server on your intranet.
Display name is the address shown to users in emails from the system.

System Shutdown

Log into each VM at its console (not remotely).
Username: appliance
Password: ******
The password will have been included in the information email from us.

Then issue the command:
shutdown

User Accounts

When paying for final PDFs, the appliance gets credit balances from the public TransPDF server. This means that every user likely to produce a final PDF must have an account on the public server (transpdf.iceni.com) as well as your private server.

When you purchase credits they are added to your account on the public server and it is that account's total which is displayed when you view your account details on your appliance.