JBOX2 (Saturn Ring) Appliance General Guide

Transcription

1 JBOX2 (Saturn Ring) Appliance General Guide Rev Revisions Date Approval A Gianfranco D'Aleo 17 April 2008 rel 3.1.0

2 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 Windows TM 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.

3 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 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):

4 JBOX2 Appliance - General Guide 2 Network Configuration The 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 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 console Before 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.

5 JBOX2 Appliance General Guide 2.2 Using DHCP When 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 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.

6 JBOX2 Appliance - General Guide 3 Web Server When 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 so we suggest to use admin/admin as user and password in the web login page. 3.1 Login Page The 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 Page A 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

7 JBOX2 Appliance General Guide 3.3 Network Page The 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 Netmask : ex Gateway : ex 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.

8 JBOX2 Appliance - General Guide 3.4 Printer Page The 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 = 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.

9 JBOX2 Appliance General Guide 3.5 Storage Page The 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 FSMKDIR NAME = FSDOWNLOAD FORMAT:BINARY NAME = "0:\macros\mymac.100" SIZE= (binary stream)

10 JBOX2 Appliance - General Guide 3.6 Firmware Page This 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.

11 JBOX2 Appliance General Guide 3.7 Log Page The 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 : [X86] ( ) ***************************************************************************** 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=" " NETMASK=" " GATEWAY=" " #SEARCH="" #DNS="" #DNS1="" ***************************************************************************** NETWORK STATUS eth0 lo Link encap:ethernet HWaddr 00:1B:EB:09:01:D1 inet addr: Bcast: Mask: 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: (100.2 KiB) TX bytes: (242.8 KiB) Interrupt:6 Base address:0xee00 Link encap:local Loopback inet addr: Mask: UP LOOPBACK RUNNING MTU:16436 Metric:1 RX packets:0 errors:0 dropped:0 overruns:0 frame:0

12 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 table Destination Gateway Genmask Flags Metric Ref Use Iface * U eth * U lo default venezia.oberons UG eth0 ***************************************************************************** PRINTER CONFIGURATION Input type: RAW Input 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 runs drwxrwxrwx 2 root root 1024 Apr 17 14:55 web /mnt/usbdisk/runs: -rwxrwxrwx 1 root root Apr 17 14:57 bardimm.jxe /mnt/usbdisk/web: -rwxrwxrwx 1 root root Apr 17 14:55 BS33AProBox.pdf -rwxrwxrwx 1 root root 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 OBE (daleo@pc-dgf) (gcc version 4.2.1) #46 PREEMPT Fri Apr 18 14:57:25 CEST 2008 MemTotal: MemFree: Buffers: Cached: SwapCached: Active: Inactive: HighTotal: HighFree: LowTotal: LowFree: SwapTotal: SwapFree: Dirty: Writeback: AnonPages: Mapped: Slab: PageTables: NFS_Unstable: Bounce: CommitLimit: Committed_AS: VmallocTotal: VmallocUsed: VmallocChunk: kb kb 4656 kb 4336 kb kb kb 1488 kb 3064 kb kb 4108 kb kb kb If enabled the Printer Log (see 3.4) this page will include also the log related to the Printer and its Loader.

13 JBOX2 Appliance General Guide 3.8 Restore Page Use 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 Page This 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.

14 JBOX2 Appliance - General Guide 4 FTP The 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.5 To login to box using ftp you have to specify: USER: PASS: storage storage