Artbox Consolidated Install

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.

Operating System Install

  1. Set up and test server platform. Install all hardware, create hardware based RAID's, disk mirroring, etc. Note server RAM amount and gather IP addresses, DNS and Gateway settings.
  2. Obtain and create CD's of the most current version of Red Hat Linux (CentOS 4.6 is recommended, Artbox will not run on CentOS 5).
  3. Boot from 1st Linux CD. Pick graphical install. Skip media check, apply a language choice, and then choose "Server" profile.
  4. Choose manual partition with Disk Druid. Delete any and all existing drive partitions. If prompted, choose to erase all data.
  5. Create 3 partitions on primary drive in the following order:
    • mount point:/boot - filesys type:ext3 - size:100MB - fixed size - force to be a primary partition
    • mount point:not applicable - filesystype:swap - size:(installed RAM x 2) - fixed size - force to be a primary partition
    • mount point:/ - filesys type:ext3 - fill to max allowable size - force to be a primary partition

    Note: if your system has a split RAID, set the data partition to /home

    • Accept "Grub" as default boot loader.
  6. Configure NIC for fixed static IP address. Choose Activate on boot. Do not use DHCP. Include valid DNS and Gateway addresses. For hostname use artbox.yourdomain.
  7. Set a secure root password that you will remember.
  8. Disable SELinux, no firewall. Click "proceed" all the way past warning about no firewall.
  9. For Package Group Selection, include:
    • XWindow
    • Gnome
    • Editors
    • Text Based Internet
    • Graphical based Internet
    • Server Configuration Tools
    • Mail Server
    • Windows File Server
    • FTP Server
    • Development Tools, click "Details" make sure "Ruby" is checked.
    • Administration Tools
    • System Tools

    Note: Do not install Postgresql or any type of SQL.

  10. Complete the CD install and agree to Linux License.
    1. Set correct time and date. Enable net time protocol. Accept default servers and see if system connects and synchs. If not, contact your system admin to find the settings for your location.
    2. Make sure the hardware clock uses UTC
    3. Change to 1024x768 screen resolution. Do not create any other users. Skip sound check and additional package install.
    4. Continue and log in as root.

Artbox Installation

  1. Create /root/artbox from a terminal session or at the command prompt. 
      mkdir /root/artbox
  2. Download the artbox install RPMs into /root/artbox

    The directory must contain:

    • artbox-3.2.11-1.i686.rpm
    • artbox-lds-3.2.11-1.i686.rpm
    • artbox-clipcopy-3.2.11-1.i686.rpm
    • artbox-clipcopy-common-1.0.7-1.i686.rpm
    • artbox-jre-1.4.2_03-1.i686.rpm
    • pxlicenced-1.0.6-1.i686.rpm
    • pxpginstall-1.0.8-1.i386.rpm
    • postgresql-8.1.3-1PGDG.i686.rpm
    • postgresql-contrib-8.1.3-1PGDG.i686.rpm
    • postgresql-libs-8.1.3-1PGDG.i686.rpm
    • postgresql-server-8.1.3-1PGDG.i686.rpm
    • QuickTimeFullInstaller.exe

    Note: The version numbers and names of the RPM may vary depending on which version of artbox you are running.

  3. Obtain and secure a valid Artbox license file for the install.
  4. Change to install directory. 
      cd /root/artbox
  5. Uninstall any latent versions of Postgresql. 
      rpm -e --nodeps `rpm -qa | grep postgresql`
  6. Install the Postgresql package installer. 
      rpm -Uvh pxpginstall-1.0.8-1.i386.rpm
  7. Use this command to install all Postgresql RPM's. Do not install Postgresql RPM's manually. 
      pxpginstall --pg_81
  8. Install License service. 
      rpm -Uvh pxlicensed-1.0.5-1.i686.rpm
  9. Start the license service 
      service pxlicensed start
  10. Install Artbox clipcopy-common and java modules. 
      rpm -Uvh artbox-clipcopy-common-1.0.7-1.i686.rpm
  artbox-jre-1.4.2_03-1.i686.rpm
  11. Start the clipcopy service 
      service artbox-clipcopy start
  12. Install Apple Quicktime Licensing. This process emulates a Windows software installer.
    1. Copy the Quicktime installer program into the correct directory. 
        cp /root/artbox/QuickTimeFullInstaller.exe  /usr/artbox/share/wine/Install/
    2. Start the Quicktime installer program from a shell prompt 
        /usr/artbox/sbin/install_quicktime
    3. Direct a web browser to http://ip-of-artbox:5802
    4. Run through the installation, use the secure password you set earlier.
  13. Install main Artbox modules. 
      rpm -Uvh artbox-3.2.11-1.i686.rpm artbox-lds-3.2.11-1.i686.rpm artbox-clipcopy-3.2.11-1.i686.rpm
  14. Start the Artbox service. 
      artbox start
  15. Start this service (this service is automatically launched in 3.2.12). 
      service pg_autovacuum start

Artbox Pre-Configuration

  1. Create the directories needed for basic Artbox operation. '''Maintain name and capitalization patterns.''' 
      mkdir /home/artbox/Contentbase /home/artbox/Media /home/artbox/Watchers
  2. Change the following settings in /etc/samba/smb.conf: 
     workgroup=(YOUR WINDOWS DOMAIN)
 server string = Artbox
 security = share
  3. Add the following type of entry in /etc/samba/smb.conf. Modify and repeat for each share. 
      Artbox Watchers
  comment = Artbox Watchers
  path = /home/artbox/Watchers
  guest only = yes
  public = yes
  writable = yes
  force user = artbox
  force group = artbox
  create mask = 0765
  4. Start the samba service manually. 
      service smb start
  5. Make sure Samba starts automatically on server startup. 
      chkconfig smb on
  6. Assign ownership to each Samba share directory 
      chown -R artbox /home/artbox/path-to-share
  chgrp -R artbox /home/artbox/path-share
  7. Mount and test samba shares from a computer client. Test file read and write to each share.

Artbox Basic Configuration

  1. Edit /usr/artbox/conf/httpd.conf. 
      ServerName = ip-of-artbox
  2. Edit /usr/artbox/conf/artbox.conf. 
      LDS ADDR = ip-of-artbox
  3. Direct a web browser to http://ip-of-artbox. Artbox web interface should start up. Login with user "admin" and password "admin".
  4. Go to License link. Copy and paste in the text of a valid Artbox license into the windows towards the bottom of the screen. Hit apply button. and then logout.
  5. Restart the Artbox service to take the configuration and license changes. 
      artbox restart
  6. Direct a Java-capable browser to http://ip-address-of-artbox/artbox.
  7. Run the downloaded .JNLP program—This is Artbox's Java Interface. When login screen appears, type in artbox IP.
  8. Login with username "admin" and password "admin"
  9. Go to Administration > Devices (not the Devices tab on the main screen)
  10. Create the very first device—a contentbase named "Artbox Contentbase", with path to /home/artbox/Contentbase.
  11. Create a second device—a file system named "Artbox Watchers" with path to /home/artbox/Watchers
  12. Run commands to initialize transcode templates. 
      ab_config --mode copy_templates
  ab_config --mode analyse_params --params /usr/artbox/conf/artbox_params

Order Management System Configuration

  1. Execute the following commands to initialize OMS responses. 
      ab_config --mode attach_sub_response
  ab_config --mode srcattach_sub_response
  2. In artbox java app, create a group labeled "artist".
  3. Create the following directories on the artbox server. 
      mkdir /home/artbox/CompletedAssets /home/artbox/SourceMaterial
    1. Create a contentbase device in the java app called Completed Assets. Set path as /home/artbox/CompletedAssets.
    2. Create a contentbase device in the java app called Source Material. Set path as /home/artbox/SourceMaterial.
  4. Log in to artbox web interface as admin
  5. Create a City, and then a Station
  6. Create user account for artist and add to artist group. Enable all permissions for artist.
  7. In Global Settings choose Source Material and Completed Assets Servers
  8. In Stations create a publish destination
Published Date: Feb 20, 2012