Administer > Content utilities > IDK build environment

IDK build environment

ISM file system structure

The ISMTool --build and --upload commands operate on the ISM directory, which you create with either the --unpack or --new commands. The --unpack command unzips a file (containing the ISM directory contents) that was previously zipped with --pack. The --new command initially creates the ISM directory. For example, the following command creates a new directory named ntp-4.1.2:

ismtool --new ntp-4.1.2

This command creates the following subdirectories under the ntp-4.1.2 directory:

  • bar - Contains binary archives, the contents of which are used to create the application package.
  • doc - A location for documentation (HTML) generated automatically during ISM build. You can also create other documentation files in the directory.
  • ism - Contains all the files needed to create the control package of the ISM. The ism directory is where you can edit the default package hooks (pre-install, post-install, pre-uninstall, post-uninstall), as well as add control scripts to ism/control.
  • log - Holds files which keep track of the output from source transformations (compilation or local installs), output from native packaging engines such as msi, rpm, pkgtrans, swpackage, or an SA upload.
  • pad - Contains the installation scripts (pre-install, post-install, pre-uninstall, post-uninstall) specified by the ISMTool --addPkgProp option.
  • pkg - Contains the application, control, and shared runtime packages, all of which are generated by --build. This subdirectory also contains copies of passthru packages.
  • tmp - Used as scratch space for ISMTool operations.
  • src - May optionally contain files that can control the compilation of sources into binary archives.

The following listing shows the contents of the ISM subdirectories after the following command:

ismtool --build ntp-4.1.2

The output of the source build is in the binary archive directory with the generated name __ntp-4.1.2_src_ntp.spec.cpio. The build creates the files in the log, pkg, and tmp subdirectories, in addition to the other files with names beginning with two underscores.

ntp-4.1.2/
	src/	
		ntp-4.1.2.tar.gz
		ntp.spec	
	bar/
		__ntp-4.1.2_src_ntp.spec.cpio		
		__ntp-4.1.2_src_ntp.spec.cpio.meta
	pkg/
		ntp-4.1.2-3.i386.rpm
		ntp-ism-4.1.2-7.i386.rpm
		ismruntime-rpm-2.0.rpm
	log/		
		. . .
	doc/
		index.html
		index/
			ntp-4.1.2-3.i386.rpm.html
			ntp-ism-4.1.2-7.i386.rpm.html
	tmp/
	. . .
	ism/
		ism.conf
		bin/
			ismget
			parameters
			platform
			python
		env/
			ism.sh
			ism.py
			ism.pl
		pkg/
			ism_check_install
			ism_post_install
			ism_post_uninstall
			ism_pre_install
			ism_pre_uninstall
		control/
	pad/
		ismruntime-rpm-2.0.0.i386.rpm
		. . .
		ntp-4.1.2-3.i386.rpm/
				pkg.conf
				scripts/
		ntp-ism-4.1.2-7.i386.rpm/
		. . .