RedHat rpm
files support a very advanced number of features. To take full advantage of this environment, it's best to understand how the rpm
package system works. http://fedoraproject.org/wiki/How_to_create_an_RPM_package is a good tutorial, but it focuses on building packages from source. The sbt-native-packager takes the approach that SBT has built your source and generated 'binary' packages.
You need the following applications installed
- rpm
- rpm-build
sbt rpm:packageBin
A rpm package needs some mandatory settings to be valid. Make sure you have these settings in your build:
rpmVendor := "typesafe"
Enables the rpm plugin
enablePlugins(RpmPlugin)
For this versions rpm packaging is automatically activated. See the Getting Started </gettingstarted>
page for information on how to enable sbt native packager.
Settings and Tasks inherited from parent plugins can be scoped with Rpm
.
linuxPackageMappings in Rpm := linuxPackageMappings.value
packageName in Rpm
The name of the package for the rpm. Its value defines the first component of the rpm file name (
packageName-version-rpmRelease.packageArchitecture.rpm
), as well as theName:
tag in the spec file. Its default value is drawn frompackageName in Linux
.version in Rpm
The version of the package for rpm. Takes the form
x.y.z
, and note that there can be no dashes in this version string. It defines the second component of the rpm file name (packageName-version-rpmRelease.packageArchitecture.rpm
), as well as theVersion:
tag in the spec file. Its default value is drawn from the project definedversion
.rpmRelease
The release number is the package's version. When the sofware is first packaged at a particular version, the release should be
"1"
. If the software is repackaged at the same version, the release number should be incremented, and dropped back to"1"
when the software version is new. Its value defines the third component of the rpm file name (packageName-version-rpmRelease.packageArchitecture.rpm
), as well as theRelease:
tag in the spec file. Its default value is"1"
.packageArchitecture in Rpm
The build architecture for the binary rpm. Its value defines the fourth component of the rpm file name (
packageName-version-rpmRelease.packageArchitecture.rpm
), as well as theBuildArch:
tag in the spec file. Its default value is"noarch"
.packageSummary in Rpm
A brief, one-line summary of the package. Note, the summary must not contain line separators or end in a period. Its value defines the
Summary:
tag in the spec file, and its default value is drawn frompackageSummary in Linux
.packageDescription in Rpm
A longer, multi-line description of the package. Its value defines the
%description
block in the spec file, and its default value is drawn frompackageDescription in Linux
.rpmVendor
The name of the company/user generating the RPM.
rpmUrl
A url associated with the software in the RPM.
rpmLicense
The license associated with software in the RPM.
rpmAutoreq
Enable or disable the automatic processing of required packages. Takes the form
"yes"
or"no"
, defaults to"yes"
. Defines theAutoReq:
tag in the spec file.rpmRequirements
The RPM packages that are required to be installed for this RPM to work.
rpmAutoprov
Enable or disable the automatic processing of provided packages. Takes the form
"yes"
or"no"
, defaults to"yes"
. Defines theAutoProv:
tag in the spec file.rpmProvides
The RPM package names that this RPM provides.
rpmPrerequisites
The RPM packages this RPM needs before installation
rpmObsoletes
The packages this RPM allows you to remove
rpmConflcits
The packages this RPM conflicts with and cannot be installed with.
rpmPrefix
The path passed set as the base for the revocable package
rpmChangelogFile
External file to be imported and used to generate the changelog of the RPM.
maintainerScripts in Rpm
Contains the scriptles being injected into the specs file. Currently supports all previous scriptlets:
%pretrans
,%pre
,%verifyscript%
,%post
,%posttrans
,%preun
and%postun
rpmBrpJavaRepackJars
appends
__os_install_post
scriptlet torpmPre
avoiding jar repackaging
rpmDaemonLogFile
File name of the log generated by application daemon.
The Rpm support grants the following commands:
rpm:package-bin
Generates the
.rpm
package for this project.rpm:rpmlint
Generates the
.rpm
file and runs therpmlint
command to look for issues in the package. Useful for debugging.
The rpm prefix allows you to create a relocatable package as defined by http://www.rpm.org/max-rpm/s1-rpm-reloc-prefix-tag.html. This optional setting with a handful of overrides to scriptlets and templates will allow you to create a working java_server archetype that can be relocated in the file system.
Example Settings:
defaultLinuxInstallLocation := "/opt/package_root",
rpmPrefix := Some(defaultLinuxInstallLocation),
linuxPackageSymlinks := Seq.empty,
defaultLinuxLogsLocation := defaultLinuxInstallLocation + "/" + name
The rpmChangelogFile property allows you to set a source that will be imported and used on the RPM generation. So if you use rpm commands to see the changelog it brings that information. You have to create the content on that file following the RPM conventions that are available here http://fedoraproject.org/wiki/Packaging:Guidelines#Changelogs.
Example Settings:
changelog := "changelog.txt"
rpmChangelogFile := Some(changelog)
* Sun Aug 24 2014 Team <contact@example.com> - 1.1.0
-Allow to login using social networks
* Wed Aug 20 2014 Team <contact@example.com> - 1.0.1
-Vulnerability fix.
* Tue Aug 19 2014 Team <contact@example.com> - 1.0.0
-First version of the system
Apply the following changes to the default init start script. You can find this in the sbt-native-packager source.
src/templates/start
...
[ -e /etc/sysconfig/$prog ] && . /etc/sysconfig/$prog
# smb could define some additional options in $RUN_OPTS
RUN_CMD="${PACKAGE_PREFIX}/${{app_name}}/bin/${{app_name}}"
...
Changing the scripts can be done in two ways. Override the maintainerScripts in Rpm
. For example:
// overriding
import RpmConstants._
maintainerScripts in Rpm := Map(
Pre -> Seq("""echo "pre-install""""),
Post -> Seq("""echo "post-install""""),
Pretrans -> Seq("""echo "pretrans""""),
Posttrans -> Seq("""echo "posttrans""""),
Preun -> Seq("""echo "pre-uninstall""""),
Postun -> Seq("""echo "post-uninstall"""")
)
// appending with strings and replacements
import RpmConstants._
maintainerScripts in Rpm := maintainerScriptsAppend((maintainerScripts in Rpm).value)(
Pretrans -> "echo 'hello, world'",
Post -> s"echo 'installing ${(packageName in Rpm).value}'"
)
// appending from a different file
import RpmConstants._
maintainerScripts in Rpm := maintainerScriptsAppendFromFile((maintainerScripts in Rpm).value)(
Pretrans -> (sourceDirectory.value / "rpm" / "pretrans"),
Post -> (sourceDirectory.value / "rpm" / "posttrans")
)
The helper methods can be found in MaintainerScriptHelper Scaladocs.
You also can place new scripts in the src/rpm/scriptlets
folder. For example:
src/rpm/scriptlets/preinst
...
echo "PACKAGE_PREFIX=${RPM_INSTALL_PREFIX}" > /etc/sysconfig/${{app_name}}
...
src/rpm/scriptlets/preun
...
rm /etc/sysconfig/${{app_name}}
...
Using files will override all previous contents. The names used can be found in the RPM Scaladocs.
Before
rpmPostun := rpmPost.value.map { content =>
s"""|$content
|echo "I append this to the current content
|""".stripMargin
}.orElse {
Option("""echo "There wasn't any previous content"
""".stripMargin)
}
After
// this gives you easy access to the correct keys
import RpmConstants._
// in order to append you have to pass the initial maintainerScripts map
maintainerScripts in Rpm := maintainerScriptsAppend((maintainerScripts in Rpm).value)(
Pretrans -> "echo 'hello, world'",
Post -> s"echo 'installing ${(packageName in Rpm).value}'"
)
rpm repackages jars by default (described in this blog post) in order to optimize jars. This behaviour is turned off by default with this setting.
rpmBrpJavaRepackJars := false
Note that this appends content to your Pre
definition, so make sure not to override it. For more information on this topic follow these links: