We are pleased to announce the availability of Artifactory 1.3.0-RC1.
artadminCLI tool for all administrative tasks.
The complete release notes from Jira are available here:
Artifactory 1.3.0-beta-6 is available for immediate download here.
The Artifactory Team
Please read this carefully before installing or upgrading:
jetty). You might have to update the provided install script or your file system permissions accordingly.
$ARTIFACTORY_HOME/etc/artifactory.propertiesfile and restart the container. As this affects the whole container VM it is recommended to use this feature for specifying Artifactory related properties only (such as repository ids substitution, etc.).
Below is important information that will make it into the final Artifactory 1.3.0 documentation.
Please refer to the Installing section of the current user guide, which still applies.
To upgrade from older versions you first need to dump the data from you old Artifactory into a 1.3 compatible format and then import it to the new Artifactory.
We expect that with 1.3.0 and above upgrading can be done directly on an existing repository without the need to export it first.
Since Artifactory 1.3.0-beta-5, JFrog merged the
artdump tool with the main CLI administration tool:
artadmin - creating the CLI "
artadmin tool can be found under the
$ARTIFACTORY_HOMEfolder (even though the export should be a read only process).
--destoption, the dump command will create a
tmpExportfolder under the current execution directory, where it will export all the data from your old Artifactory.
Here are step by step instructions for running the full upgrade process:
$ARTIFACTORY_HOMEfolder to a new location.
#artadmin dumpcommand on the old
$ARTIFACTORY_HOMEor on a copy of it, by running
artadmin dump $ARTIFACTORY_HOME(This will generate a
tmpExportfolder if you did not specify a destination folder with
$ARTIFACTORY_HOME/etc/jetty.xml. It is also highly recommended to use a different port in order to perform the upgrade on a "silent" instance that is not being hit by user requests in parallel.
artadmincommand line (highly recommended):
--username username --password password.
artadminoutput will display the progress of the import. NOTE: If the
artadminprocess is killed, the import will still run in Artifactory.
During the import binary artifacts are copied over into a working copy and are imported into Arifactory in by a background thread. This speeds up the import process dramatically and makes Artifactory ready for serving requests as soon as possible. The background import process will take some time to completes, depending on the size of your repository. During this time Artifactory might perform more slowly than usual, but it will still serve any artifact immediately. The log does provide visible information about the progress of this process.
Should you wish to repeat the upgrade process from scratch, make sure to remove the
artadmin dumpcommand line usage:
usage: dump [Artifactory home folder] ... Artifactory will try to automcatically determine the previous version from $ARTIFACTORY_HOME/webapps/artifactory.war if present. If the war file cannot be found at this location, please do one of the following: 1) link or copy it at this location, or pass the version. 2) pass one of the following version as second parameter: 1.2.2-rc0 1.2.2-rc1 1.2.2-rc2 1.2.2 1.2.5-rc0 1.2.5-rc1 1.2.5-rc2 1.2.5-rc3 1.2.5-rc4 1.2.5-rc5 1.2.5-rc6 1.2.5 1.2.5u1 1.3.0-beta-1 1.3.0-beta-2 1.3.0-beta-3 1.3.0-beta-4 1.3.0-beta-5 Valid options: --dest [destination folder]: the destination folder for the new export files. Default value: tmpExport --version [version name]: the actual version of the old Artifactory if the Update Manager cannot find it --caches: include cached repositories in the export (by default caches are not exported). If repo option is passed this option will be ignored --security: only export the security file from DB, and set the norepo flag --repo [repo names separated by ':']: export only a specified list of repositories. Default value: all-non-cached --norepo: does not export the repositories, just convert config and security --convert: activate the Local and Virtual repository names conversion --noconvert: does not activate the Local and Virtual repository names conversion during a full export
artadmin importcommand line usage:
usage: import [import from path] ... Valid options: --ssl: Activate https instead of http. Default is false --server [the server host or ip]: The remote Artifactory server IP or host name with optional port number. The default is localhost:8081 --timeout [timeout in seconds]: Set the timeout of the HTTP connection. --url [root url to rest api]: The root URL of the Artifactry REST API. The default is http://[servername]/artifactory/api --username [username]: Optional username to use when connecting to the remote Artifactory --password [password]: The users's clear text password --noMetadata: Exclude metadata information when importing/exporting --symlinks: Use symbolic links to the original import path file (no file copying) --syncImport: Import directly into Artifactory without using the background import process --verbose: display maximum details --failFast: fail at first error --failIfEmpty: fail at empty directories
artadmincommand line usage:
Usage: artadmin <command> [arg] [options] Type 'artadmin help <command>' for help on a specific command. Available commands: help: The help message info: Get system information export: Export artifactory data to destination path import: Import full system from import path dump: Dump the database of an older version of Artifactory compress: Compress the database tables (Derby only) in order to free up disk space.