To check your package on Solaris, call
rhub::check()as usual and choose one of our Solaris builders.
Bookmark this page, in case you get an email from CRAN about your package failing on Solaris.
This is a post about checking that your R package on Solaris, using R-hub, and how you can create your own Solaris virtual machine to debug your R code.
OpenCSW is a repository of open source
software packages. It uses a package manager tool called
pkgutil is similar to
OpenCSW greatly varies in terms of how current its various packages are.
By default OpenCSW uses its “testing” distribution, which has a rolling
release model. The most recently added packages are in the “unstable”
distribution. OpenCSW unstable has now a new R 4.0.0 build, called
r_base. It will move to the “testing” distibution in a couple of days.
r_base 4.0.0 is one of the R builds used on R-hub’s Solaris
R-hub also has a repository (catalog) of OpenCSW packages,
which we use for system requirements that are not (yet) updated in the
official OpenCSW catalog. The R-hub catalog is at
https://files.r-hub.io/opencsw/. (This is the URL you need to use in
pkgutil.conf file or with
CRAN’s Solaris builder
CRAN uses two sets of compilers for their R package checks. Oracle Developer Studio (ODS) is a commercial product that supports Oracle Solaris 10. In addition, OpenCSW packages GCC, version 5.5.0 currently.
CRAN compiles R packages with ODS by default. If ODS is not able to compile a package, they use GCC instead. GCC should be able to compile most (all?) CRAN R packages. Notably, Rcpp and all packages linking to it are compiled with GCC.
R-hub’s Solaris builder
R-hub’s setup is similar. Our Solaris virtual machine has three R versions:
- 32-bit GCC build at
/opt/csw/bin/R, from the OpenCSW
r_basepackage. The configuration of this build is in OpenCSW.
- 64-bit GCC build at
/opt/csw/bin/amd64/R, from the same OpenCSW
- 32-bit ODS build, see the a
config.sitefile in our
If you call
rhub::platforms() you’ll see two
solaris-x86-patcheduses the 32-bit GCC build of R. This is also what
solaris-x86-patched-odsuses the 32-bit GCC build to install all dependencies of the package, but then runs
R CMD checkwith the ODS build. This maximizes the chance of a meaningful
R CMD checkrun.
It is unclear how system requirements are installed on CRAN’s Solaris.
R-hub’s Solaris machine installs all system requirements from OpenCSW.
The list of installed packages are in the
solarischeck GitHub repository.
If you need another library for your package, please let use know and we can install it. See the current list of OpenCSW packages.
If the library you need is missing from OpenCSW, or it is outdated, let us know, there is a good chance that we can add it or update it.
Creating your own Solaris 10 VM
R-hub’s Solaris check is great if you want to make sure that your package works on Solaris before a CRAN submission. If it does not work, and the fix is not obvious, then you probably want to debug it on a Solaris machine.
We have a template for the packer automated VM builder tool that helps you do this with as little work as possible. (Which is not the same as little work, mind you!) You’ll need:
- A sufficiently powerful computer to run a virtual machine.
- packer, available for Windows, macOS, Linux, free and open source.
- Virtualization software: VMware or VirtualBox. VirtualBox is open source and available for many platforms. VMware has free evaluation versions.
- You need to create an Oracle ID, and download the Oracle Solaris 10 install DVD image and also Oracle Developer Studio. They are free for non-commercial use, without support.
- You need to wait about 15-30 minutes for packer to build the virtual machine.
If you want to install Solaris yourself without the packer automation, our internal R-hub docs have a detailed walkthrough.
Need help? Contact us!
If creating a virtual machine is not the right solution for you, do not despair! We have other ways to help you with your Solaris issues, please contact us by opening an issue in the R-hub issue tracker.
- CRAN’s Solaris config by Brian Ripley.
solarischeckGitHub repository for Solaris related tools.
- packer template to build your Solaris VM:
- An R ODS build and other Solaris related tools, e.g. newer R builds for Solaris on our web site.
- A walkthrouh of a manual Solaris installation, on our internal docs site.
- The R-hub OpenCSW catalog is at https://files.r-hub.io/opencsw.
- Prior art and inspriration.
- Our packer config is based on Edwin Biemond’s work.
- To get help with R and Solaris please open an issue in our issue tracker.