In this blog I'm going to cover installing ICCT (IBM Image Construction and Composition Tool) also know as ICON, now I know there is lots out there on installing this tool. As per usual I have trouble finding it, so into my developerWorks blog it goes, and more so this one is driven around the install of AIX. Along with this I will be detailing a few things I do to make managing the system easier. First a little information about this tool -
ICCT is part of the IBM Virtual Appliance Factory tools. ICCT implements a consistent methodology to design and build Open Virtualization Appliance (OVA) files across multiple cloud provider architectures, in my case IBM PowerVM, but also kernel-based virtual machine (KVM), and VMware. An OVA file is a portable self-contained binary package that includes metadata and several software artifacts such as operating system, middleware, software packages, and applications at the top. In the case of an IBM PowerVM cloud provider, these software artifacts are part of a raw disk file and are configured by the Virtual Solution Activation Engine (VSAE) at deployment time. Virtual hardware resources are defined within the Open Virtual Machine Format (OVF) file included in the OVA.
Preparing the Server -
ICCT uses the following directories;
- Product directory (where Commands are located) /opt/IBM/icon
- Configuration, Databases, and Templates /drouter
- Logs (for problem determination) /drouter/ramdisk2/mnt/raid-volume/raid0/logs/error
Inorder to make the management and administration of this server easier I tend to create the following filesystems before I do the install -
Filesystem GB blocks Free %Used Iused %Iused Mounted on
/dev/lvdrouter 10.00 9.96 1% 4 1% /drouter
/dev/lvimages 200.00 199.47 1% 4 1% /images
The point of giving /drouter its own filesystem is that it takes configuration, databases and templates away from the / filesystem. It can fill up quickly and saves you having problems with / being full. In addition to this I create a 'images' directory' as when exporting OVAs from ICCT I find it easier to stage them on ICCT server and move them later. So this space needs to be bigger then the largest appliance in your Cloud.
Remove Any Older Versions of ICCT -
- Export any Software Bundles or Images that you would like to keep.
- Stop ICCT service if currently running; /opt/IBM/icon/stop.sh
- Uninstall the Image Construction and Composition Tool; /opt/IBM/InstallationManager/eclipse/tools/imcl uninstall com.ibm.cloud.icon
- (Optionally) Uninstall IBM Installation Manager; /var/ibm/InstallationManager/uninstall/uninstallc
- (Optionally) Remove ICCT sub-directories; rm -rf /drouter/*
Install IBM Installation Manager -
- Download the latest version of IBM Installation Manager.
- Create a temporary directory for the zip file; mkdir /tmp/im
- Transfer zip file to tmp directory
- Extract the file; cd /tmp/im; unzip agent.installer.aix.motif.ppc*.zip
- Then install IBM Installation Manager; installc -acceptLicense
Install Image Construction and Composition Tool -
- Download the latest version of Image Construction and Composition Tool
- As before create a temporary directory for ICCT to be extracted to; mkdir /tmp/icct
- Transfer ICCT zip file to this temp directory.
- Extract the file; cd /tmp/icc; unzip ICCT_Install_*.zip
- Copy response file; cp /tmp/icct/icon/icon_silent_install_response_file.xml /tmp/icct
Update response file
- Change <repository location='/tmp/icct/icon'/>
- Change <data key='cic.selector.os' value='aix'/>
- Change <data key='cic.selector.arch' value='ppc64'/>
- Remove <data key='cic.selector.ws' value='gtk'/>
- Then run the install; /opt/IBM/InstallationManager/eclipse/tools/imcl input /tmp/icct/icon_silent_install_response_file.xml -acceptLicense
To start the ICCT server /opt/IBM/icon/start.sh
To use ICCT, point your browser to: https://<hostname>/icn/ui/index.html Default credentials: admin/password