Image Packaging System (IPS) tools for updating GlassFish Server software obtain updates from repositories that contain the OSGi modules and other content for GlassFish Server.
Oracle GlassFish Server and GlassFish Server Open Source Edition each have their own set of repositories, as explained in the following sections:
Table 11-1 lists the preconfigured repositories for Oracle GlassFish Server.
Table 11-1 Oracle GlassFish Server Preconfigured Repositories
For Oracle GlassFish Server installations, the release.glassfish.oracle.com publisher is designated as the preferred publisher. To ensure that installations contain only commercial, production quality version of components by default, the preferred publisher is treated specially by the tools for updating GlassFish Server software:
If an add-on component is available from the preferred publisher and from other publishers, the Update Tool GUI and the pkg CLI list and install the component from the preferred publisher.
After a component has been installed from the preferred publisher, the Update Tool, Software Update, and desktop notifier GUIs search for updates to that component only from the preferred publisher.
If you have support for Oracle GlassFish Server, you can change the preferred publisher's repository URL from the Oracle GlassFish Server release repository to the Oracle GlassFish Server support repository. For more information, see Enabling the Oracle GlassFish Server Support Repository.
If you have support for Oracle GlassFish Server, you can change the repository URL for the preferred provider, release.glassfish.oracle.com, to refer to the support repository instead of to the release repository. This support repository includes the content provided by the release repository, but also includes commercial, production quality updates that resolve issues reported by Oracle GlassFish Server customers.
Enabling the Oracle GlassFish Server support repository involves two tasks:
Your company's technical contact acquires the key and certificate files needed to access the support repository.
GlassFish Server administrators use the key and certificate files to change the release.glassfish.oracle.com publisher's repository URL to the support repository.
Note - The key and certificate files needed to enable access to the support repository expire. When they expire, you need to acquire new ones and apply them to your Oracle GlassFish Server installations.
To acquire the key and certificate files for the Oracle GlassFish Server support repository, your company's technical contact uses the pkg-register.oracle.com Certificate Generator.
Before You Begin
Before using the Certificate Generator, you must add your Oracle GlassFish Server Customer Support Identification (CSI) numbers to your My Oracle Support account. If you do not yet have a My Oracle Support account, you can create one at https://support.oracle.com.
After signing in, the Certificate Requests page displays, showing “Oracle GlassFish Server 3 Support” as one of the products for which you can request a certificate.
The Certificate Requests: Additional Information page displays.
The Certificate Information page displays.
When the current certificate expires, you will need to repeat this process to acquire new certificates.
Note - If you accidentally delete or misplace these files, you can sign into https://pkg-register.oracle.com using your My Oracle Support account information and get replacement copies of them.
Use the pkg utility to change the repository URL for the release.glassfish.oracle.com publisher to the Oracle GlassFish Server support repository for an Oracle GlassFish Server installation.
Before You Begin
Before you use the pkg utility, you must copy the Oracle_GlassFish_Server_3_Support.key.pem key file and the Oracle_GlassFish_Server_3_Support.certificate.pem certificate file to a location accessible from the host where Oracle GlassFish Server is installed.
The default parent installation directory is glassfish3.
On Unix systems (including Mac OS), where backslash (\) is the command line continuation character:
bin/pkg set-publisher -P \ -k path-to-key-file/Oracle_GlassFish_Server_3_Support.key.pem \ -c path-to-certificate-file/Oracle_GlassFish_Server_3_Support.certificate.pem \ -O https://pkg.oracle.com/glassfish/v3/support release.glassfish.oracle.com
On Windows systems, where caret (^) is the command line continuation character:
bin\pkg set-publisher -P ^ -k path-to-key-file\Oracle_GlassFish_Server_3_Support.key.pem ^ -c path-to-certificate-file\Oracle_GlassFish_Server_3_Support.certificate.pem ^ -O https://pkg.oracle.com/glassfish/v3/support release.glassfish.oracle.com
Table 11-2 lists the preconfigured repositories for GlassFish Server Open Source Edition.
Table 11-2 GlassFish Server Open Source Edition Preconfigured Repositories
For GlassFish Server Open Source Edition installations, stable.glassfish.org is the preferred publisher.