itools-packager¶

The itools-packager Maven plugin provides a way to assemble distribution bundles based on itools.

The layout of such distribution is the following:

<package-name>
├── bin
│   ├── itools
│   ├── itools.bat
│   └── powsyblsh
├── etc
│   ├── itools.conf
│   └── logback-itools.xml
├── lib
└── share
    └── java
        ├── <jars>

Goals overview¶

The itools-packager only has one goal.

The package-zip goal creates a zip package based on iTools

Configuration¶

Properties¶

archiveName
The archiveName property defines the basename of the archive. If this property is not set, itools-packager uses the packageName.

packageName
The packageName property defines the name of the root folder of the distribution. If this property is not set, itools-packager uses the finalName of the maven project.

configName
The configName property defines the the basename of the configuration file. The default value is config

javaXmx
The javaXmx property defines the amout of the Java Heap memory. The default value is 8 Gb. This property is used to initialize the java_xmx property of the itools.conf file.

copyToBin
The copyToBin property defines the list of files to copy in the bin directory of the distribution.

copyToLib
The copyToLib property defines the list of files to copy in the etc directory of the distribution.

copyToEtc
The copyToEtc property defines the list of files to copy in the etc directory of the distribution.

Example¶

<build>
    <plugins>
        <plugin>
            <groupId>com.powsybl</groupId>
            <artifactId>powsybl-itools-packager-maven-plugin</artifactId>
            <version>${powsybl.core.version}</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>package-zip</goal>
                    </goals>
                </execution>
            </executions>
            <configuration>
                <packageName>powsybl</packageName>
                <archiveName>powsybl-V${project.version}</archiveName>
                <javaXmx>512M</javaXmx>
            </configuration>
        </plugin>
    </plugins>
</build>

Usage¶

The itools-packager plugin copies all the maven dependencies to the share/java folder of the distribution. To enable a feature, add a runtime dependency to the pom.xml file. Refer to the itools commands list documentation to learn more about existing commands.

The itools-packager tutorial gives the minimal configuration of an itools based distribution.