jbox2 appliance user guidedownload.bluemega.fr/download/bardimm/manuels/jbox2... · 2008-09-03 ·...

JBOX2 (Saturn Ring)Appliance

General Guide

Rev Revisions Date Approval

A Gianfranco D'Aleo 17 April 2008 – rel 3.1.0

Oberon Service Srl – via meda 28 – 20144 Milan (Italy) www.oberon.it

http://www.oberon.it/

JBOX2 Appliance - General Guide

NOTE

The information contained in this document is subject to change without prior notice

This document contains proprietary information, which is protected by copyright. All rights reserved. This document cannot be photocopied, reproduced or translated without prior written approval by Oberon Service.

Microsoft®, Microsoft WindowsTM are US trademarks of Microsoft Corporation.

Adobe and Acrobat are US trademarks of Adobe System Incorporated.

All other Companies and/or product names are trademarks or registered trademarks of their respective company.

Oberon Service 2007/2008. All rights reserved.



JBOX2 Appliance – General Guide

1 Introduction The JBOX2 Appliance (Saturn Rings) is a box based on the CPU Vortex86SX 32-Bit Microprocessor, DDR2 128MB onboard (133Mhz), which is based on x86 structure. It is the x86 SoC (System on Chip) with 0.13 micron process and ultra low power consumption design (less than 1 watt). The Cpu is a high performance and fully static 32-bit X86 processor with the compatibility of Windows based, Linux and most popular 32-bit RTOS.The Cpu integrates 32KB write through direct map L1 cache, PCI Rev. 2.1 32-bit bus interface at 33 MHz, SDRAM, DDR2, ROM controller, IPC (Internal Peripheral Controllers with DMA and interrupt timer/counter included), Fast Ethernet MAC, FIFO UART, USB2.0 Host and IDE controller into a System-on-Chip (SoC) design.

The box is running the standard Linux 2.6 as Operative System installed in a single SECURED MFC (CompactFlash).This compact flash (128Mb size) is using the proprietary Oberon Firmware to achieve the maximum security .

The base system runs the following services:

Boa Web Server Telnet uDHCP Net-SNMP Pro-FTPD Jbox2 Daemon Prints and Macros/Fonts loader

The standard configuration can serve maximum one printer connected to USB or via LAN (TCP/IP).

Jbox2 as Print Server (LAN2USB):

Jbox2 as re-router (LAN2LAN):




2 Network ConfigurationThe box's network interface (eth0) can be configured in two ways:

Using a DHCP server Statically defined via Web Interface

At the box's power-on, the internal dhcp daemon looks for a DHCP server on the lan, to acquire a valid IP address from it.If no server is providing the IP address, the box automatically raise up the network interface with this temporary address:

IP ADDRESS NETMASK ADDRESS

192.0.0.192 255.0.0.0

This address should be used to perform the complete box's configuration using the Web Interface (see. 3). otherwise it should be changed using the box's TTY console.

2.1 Using the box consoleBefore to power-on the box, connect a VGA monitor and a PS2/USB keyboard.Turn on the box. When the box is ready, the console will display the login prompt like:

JBOX2-001BEB0012AA login:

Type ALT+F2 to have access to the JBOX2 Network Configuration Tool window

After you changed the IP and MASK values with this tool, the configuration has to be performed using a browser (see. 3) pointing to the temporary IP associated.

Note: if the box is restarted the network temporary configuration is lost.




2.2 Using DHCPWhen a DHCP server is availabe on lan, the box will ask for a valid IP address.To check with address the box gets from lan, you have to login to DHCP server and look in the right windows of Address Leases

Look for the jbox2 suffix followed by the box MAC address

In case you have not the DHCP address, use the PING/ARP procedure to discover the box's IP.

1. Open a DOS shell on your Windows PC 2. Run the ping command in broadcasting mode in the current mask this way:

ping 192.168.1.255 -t (the address must reflect you lan environment)

3. Now examine the ARP table using the command arp –a 4. Find the JBOX2 MAC address (reported on box bottom side) and the relative IP address assigned by the Server.




3 Web ServerWhen the box is configured with an IP address (see. 2), the complete configuration has to be performed with the internal box's web server pages.The web server is secured with a login method using User and Password.Those values are configured the first time the web server is accessed. Recover this account require a restore to factory default procedure that should only be executed via box's console (see. @), so we suggest to use admin/admin as user and password in the web login page.

3.1 Login PageThe box's login page allows you to access on configuration pages.The first time a User and Password are to be choose.

After you fill the user and password fields and pressed login, a pop-up will inform you to perform again the login with choosed account.

3.2 Home PageA successfully login, will shown the box's home page where many links are available on its left side

This page

JBOX2 NIC configuration (IP, MASK, Lan speed ...)

Configure the receive and send method (LAN2USB or LAN2LAN)

Manage the files stored on public MFC area (Macros, fonts ...)

Perform firmware upgrade

JBOX2 various logs

Restore to factory default

Restart the box after configuration

Logout from web session




3.3 Network PageThe network page allows to configure the ethernet interface (eth0).

Host Name – By default the box's hostname is composed by the JBOX2 keyword plus the ethernet mac address. This field allows you to change its default value.

IP lookup method – By default the box look for a DHCP server on lan to acquire an IP address. If you need to assign a STATIC ip address choose for 'manual' and fill up all 3 fields:

IP address: ex 192.168.1.120

Netmask : ex. 255.255.255.0

Gateway : ex. 192.168.1.254

Normally the interface auto configure the LAN speed automatically. If you need a different value, select the right speed and type from selection.

To fix the Networks modifications use the SAVE button. This will save the values you choose in this page. Remember that to use the new values a box's reboot is required.




3.4 Printer PageThe box's Printer Page allow you to configure the box's Receive method (the way the jobs are sent to it) and the Send to printer method.

Input connection: how the box will receive the jobs. RAW: default value with PORT = 9100. LPD: normally used on *nix system. In this method you can

specify in your host printer's configuration any QUEUE name.

Printer connection: how the box has to send the jobs. USB: a printer connected to the USB port (LAN2USB) LAN: rerouting the jobs to a lan connected printer. IP address: specify the IP address of the destination printer. PORT: specify the connection port of remote printer.

LOG: enable this flag to have the Printer thread log available for debug pourpose. (see Log Page).

Save the values of the page. The box needs to be restarted after the modifications.




3.5 Storage PageThe JBOX2 appliance use an MFC to store programs and other various stuff. This page helps you to check what is loaded on MFC's public area or to load new stuff.

The file to download on appliance This button helps to find files on your PC using a standard search window.

Files and folder list of already loaded stuff.

RUNS: this folder is normally used to load application to execute as Iofilters by the appliance at each jobs. The application has to have the extension .jxe and must be compiled with appropriate SDK.

UTIL: folders that contains stuff required by JXE application. WEB: custom pages linkable to the main WEB server.

DELETE: use to delete stuff from appliance. CREATE DIR: used only to create a new folder on storage device.

NOTE:The JBOX2 has an automatic download manager that can send, to the configured printer, stuff like macros, fonts, preprinted pages etc..This Loader loads the content of Macros folder at power-on and all the times that the printer has a printer fault or a restart.

NOTE1:The JBOX2 supports the PJL commands as standard to load stuff on storage device.By default the public area is mapped as disk 0: It is easy to create a RFU files that can be sent to the appliance as a normal job and store data to public area.The RFU file has to begin with the special header that are 4 bytes

#~#~

The supported PJL commands are: FSAPPEND FSDELETE FSDOWNLOAD FSMKDIR

RFU Example:#~#~[esc]%-12345X@PJL[esc]%-12345X@PJL@PJL FSMKDIR NAME = "0:\macros"@PJL FSDOWNLOAD FORMAT:BINARY NAME = "0:\macros\mymac.100" SIZE=19432................... (binary stream)




3.6 Firmware PageThis page is used to upgrade/downgrade the appliance firmware.Normally the new firmwares are published in zip format.Before to load on box you have to unzip the firmware file on PC's temp folder.

Firmware file to load

Button to perform the Firmware upgrade.

The box will automatically performs a reboot after the file is loaded on it.To check the firmware running version look on every bottom web pages for a line like

After the upgrade check for changed version.

NOTE:The firmware file is also available as RFU format. In this case just send it to the box as a normal job.




3.7 Log PageThe Log Page reports various log files available on appliance.The main windows is showing the Linux OS log messages.This log is produced by the kernel and drivers.

The „save log file“ is used to open a new browser windows.This new window (text format) is reporting deep information about the appliance itself.This is a snapshot of this page:

JBOX2 Status information-----------------------------------------------------------------------------

FWVERSION : 3-1.0-[X86] (20080407)*****************************************************************************HOSTNAME : JBOX2-001BEB0901D1*****************************************************************************NETWORK FILE CONFIGURATION

# Valid media types are "auto", "10baseT-HD", "10baseT-FD", "100baseTX-HD",# "100baseTX-FD" and "" (nothing).MEDIA="auto"

# BOOTPROTO puÃ² avere dhcp and "" (nothing).BOOTPROTO="dhcp"

# Se impostato BOOTPROTO="dhcp" i valori IP e NETMASK non vengono usati.# Se viene usato dhcp ma nessun indirizzo acquisito viene impostato# viene usato l'ip di default.IP="192.0.0.192"NETMASK="255.0.0.0"GATEWAY="0.0.0.0"

#SEARCH=""#DNS=""#DNS1=""*****************************************************************************NETWORK STATUS

eth0 Link encap:Ethernet HWaddr 00:1B:EB:09:01:D1 inet addr:192.168.1.29 Bcast:192.168.1.255 Mask:255.255.255.0 UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:592 errors:0 dropped:0 overruns:0 frame:0 TX packets:453 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:102615 (100.2 KiB) TX bytes:248640 (242.8 KiB) Interrupt:6 Base address:0xee00

lo Link encap:Local Loopback inet addr:127.0.0.1 Mask:255.0.0.0 UP LOOPBACK RUNNING MTU:16436 Metric:1 RX packets:0 errors:0 dropped:0 overruns:0 frame:0



JBOX2 Appliance - General Guide TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:0 RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)

Kernel IP routing tableDestination Gateway Genmask Flags Metric Ref Use Iface192.168.1.0 * 255.255.255.0 U 0 0 0 eth0127.0.0.0 * 255.0.0.0 U 0 0 0 lodefault venezia.oberons 0.0.0.0 UG 0 0 0 eth0

*****************************************************************************PRINTER CONFIGURATION

Input type: RAWInput port: 9100

Printer type: USB*****************************************************************************STORAGE STATUS

rootfs on / type rootfs (rw)proc on /proc type proc (rw)/dev/hda1 on /mnt/firmware type ext3 (rw,data=ordered)/dev/hda2 on /mnt/usbdisk type ext3 (rw,data=ordered)

Filesystem Size Used Available Use% Mounted on/dev/hda1 18.6M 4.8M 12.9M 27% /mnt/firmware/dev/hda2 92.5M 7.2M 80.5M 8% /mnt/usbdisk

/mnt/usbdisk:drwxrwxrwx 2 root root 1024 Apr 17 14:57 runsdrwxrwxrwx 2 root root 1024 Apr 17 14:55 web

/mnt/usbdisk/runs:-rwxrwxrwx 1 root root 282364 Apr 17 14:57 bardimm.jxe

/mnt/usbdisk/web:-rwxrwxrwx 1 root root 1354773 Apr 17 14:55 BS33AProBox.pdf-rwxrwxrwx 1 root root 107095 Apr 17 14:55 BS33AProBox_QIG.pdf-rwxrwxrwx 1 root root 24 Apr 17 14:55 freescape.cfg-rwxrwxrwx 1 root root 1937 Apr 17 14:55 index.html-rwxrwxrwx 1 root root 32 Apr 17 14:55 webparam.conf*****************************************************************************APPLIANCE STATUS

Linux version 2.6.18-OBE (daleo@pc-dgf) (gcc version 4.2.1) #46 PREEMPT Fri Apr 18 14:57:25 CEST 2008

MemTotal: 127572 kBMemFree: 115160 kBBuffers: 200 kBCached: 7048 kBSwapCached: 0 kBActive: 4656 kBInactive: 4336 kBHighTotal: 0 kBHighFree: 0 kBLowTotal: 127572 kBLowFree: 115160 kBSwapTotal: 0 kBSwapFree: 0 kBDirty: 40 kBWriteback: 0 kBAnonPages: 1752 kBMapped: 1488 kBSlab: 3064 kBPageTables: 200 kBNFS_Unstable: 0 kBBounce: 0 kBCommitLimit: 63784 kBCommitted_AS: 4108 kBVmallocTotal: 909288 kBVmallocUsed: 0 kBVmallocChunk: 909288 kB

If enabled the Printer Log (see 3.4) this page will include also the log related to the Printer and its Loader.




3.8 Restore PageUse this page to restore the appliance to its factory defaul value

Apply the restore button to clear the configuration.Is it possible also to use the JBOX2 console to perform the Restore to Factory procedure.Follows the same steps on 2.1 but instead of typing ALT+F2, type ALT+F3 sequence.A window like this will appear:

Just type Y at the prompt and the box will reload factory default values and it will reboot automatically.

3.9 Restart PageThis link has to be used to perform a remote reboot of appliance.It is required after any modification on the box's configuration.

Just click on restart button to perform the remote appliance reboot.




4 FTPThe JBOX2 provides also an FTP access to the public storage area.This method should be used instead of the web access as explained at point 3.5To login to box using ftp you have to specify:

USER: storagePASS: storage



jbox2 appliance user guidedownload.bluemega.fr/download/bardimm/manuels/jbox2... · 2008-09-03 ·...

Documents