Java Plugins and Java Web Start¶

Extending IJC functionality - module install into Java Web Start¶

Here we show how to extend Java Web Start distribution of IJC with a custom module. As a sample module we will use our MyAddField example module.

1. Build the module¶

1
2
3

cd api-examples-suite
cd addfield 
ant

when the module is successfully built we need the following two files:

1 2	`api-examples-suite/build/cluster/modules/com-im-ijc-examples-addfield.jar api-examples-suite/build/cluster/config/Modules/com-im-ijc-examples-addfield.xml`

2. Unzip IJC java web start distribution¶

1
2
3

unzip ijcinst-jws.zip
cd ijcinst-jws
unzip instantjchem.zip

The whole folder should look like this:

3. Copy the module’s files to IJC JWS distribution¶

As it is indicated in the previous screenshot, copy the files from the built module into the distribution folder:

JAR file into instantjchem/instantjchem/modules/

XML file into instantjchem/instantjchem/config/Modules/

4. ZIP the instanjchem folder¶

Now everything is in the place and we can zip the IJC folder. You can use any ZIP utility od command line:

Delete or backup the old zip:

1	`rm instantjchem.zip`

Create the new one which includes the module files :

1	`zip -r instantjchem.zip instantjchem`

5. Update the Java Web Start files¶

In the last step we have to update CRC32 of a new instantjchem.zip in the info.properties configuration. It is recommended to update file size and creation time but it is not mandatory (just some warnings are displayed). However, if you choose, you can find the creation time on Windows with stat -c %Y and on Unix systems with stat -r

To find out the CRC32, you can use some windows utility such as this one, or command line:

1 2	`$ crc32 instantjchem.zip 893d789a`

Update the CRC32 in instantjchem.zip:

1 2	`# zip file with InstantJChem = file size, timestamp, crc32 instantjchem.zip=216959352,1409579282000,893d789a`

6. Deploy the IJC distribution¶

Now the distribution is ready to use with the new module