Disclaimer: Proximity Corporation provided the information in this article and it was deemed accurate as of 30 May 2007. Apple Inc. is not responsible for the article's content. This article is provided as is and may or may not be updated in the future.
The java clients need direct access to the LDS for data transfers. /usr/artbox/conf/artbox.conf contains the configuration for LDS_ADDRESS. This must be set to the IP address of the ethernet interface (found by using ifconfig).
Changes to artbox.conf are not read until the storeserver is restarted using:
The artbox http server runs on port 80. It is important that the apache ServerName is an address or hostname that can be resolved by remote machines, as it is used by the webstart php scripts to create a url. This can be achieved by having an entry in /etc/hosts of the hostname resolving to the IP address of the external network interface (see above), or manually by adding the ServerName directive to /usr/artbox/conf/httpd.conf (and restarting httpd). It should be possible to use an IP address as the ServerName if isn't possible to edit the local hosts file of the client.
To access the java client via webstart, browse the following the url:
Changes to httpd.conf are not read until the storeserver is restarted using:
To install an artbox license, upload the file to your server and run the following command:
Be sure the date on the server is correct since if the date is accidentally set too early, a license created for today's date will not work.
This section describes how to configure an artbox system from scratch, as well as how to re-initialise the database so that from-scratch configuration can be done on an existing system.
Note: ab_config usage is printed out when it is run with no arguments.
The creation order of devices is important, because each device is assigned an id starting at 1 from the time the database is first initialised, so in this case, artbox Content will have address /dev/1 and artbox Watchers will have address /dev/2.
Note: Whenever an entity (device or subscription) is created using ab_config, the address of the newly created entity is output by ab_config. ab_config can be found in /usr/artbox/sbin.
Note: steps 2 and 3 may be performed as many times as desired without starting from scratch.
If artbox has order management enabled the following steps are required for assets to be attached to orders.
ab_config --mode attach_sub_response
ab_config --mode srcattach_sub_response
To allow all copy templates for a particular device, instead of configuring them manually in the java ui, this may be done using ab_config, e.g:
ab_config --mode permitted_templates --addr /dev/2
Note: the preferable thing to do now is use the Java UI for this (in the Administration/Template tab)
artbox stop
/usr/artbox/sbin/ab_initdb --reinit
All the data needs to be purged from any contentbase devices that were configured (and are to be reconfigured with the same root path), so for each contentbase device, do:
cd <path to contentbase device>
rm -rf *
artbox start
Obviously this process will erase all your database configuration and data files which reside in contentbase devices.
To access the artbox database directly, do:
psql px pxdb
The easiest way to find out the address of a particular device is to use ab_config to search for devices:
ab_config --mode search --addr /dev
Because this output is rather overwhelming, and you might want to find a single device of a particular name, you can do the following:
ab_config --mode search --addr /dev | grep "DEVICE_NAME = artbox Content"
Which will show the device details for the device called "artbox Content."
After you finish configuring the artbox, you must configure Samba.