Basic Information

Artifactory system requirements:

  1. A valid JDK 1.5+ installed on the server.
  2. At least 400m of Java heap size, for good management of the binary files.
The downloadable artifactory zip install file contains an embedded Jetty container with a with default Artifactory configuration for ultra easy startup. After unzipping it, run the appropriate Windows or Linux script under the bin directory.

The bin folder also contains an install script for making artifactory a Linux service using chkconfig (RedHat and Suse).

You can read the Configuration page for a description of artifactory folders.

After installation the default admin user is username=admin and password=password

Windows

The file "artifactory.bat" under the bin folder, will look for java and run the main class.

Linux

The main dependency needed before running artifactory is to have a valid JDK 1.5+ on the machine. Before running scripts directly the JAVA_HOME should be set to a JDK 1.5+.

The best to check the validity of your environment is to run "artifactoryctl check" under the bin folder. This script is a modification of jetty init script and is quite well documented.

You can run artifactory with "artifactory.sh" directly to see its behavior. The console will be locked on artifactory process and you can stop it clean with CTRL+C.

You can also try run directly "artifactoryctl check|start|stop" to run directly artifactory as a daemon process using the environment variable of the shell you are in.

There is also under bin a script called "install.sh" that will run a bunch of unix commands to setup artifactory correctly as a Linux service.

The install script is documented and you should look at it before running it. Anyway, here are the notes and informations about what this script is doing:

NOTE This script should be run as root
NOTE It uses chkconfig which is part of RedHat and Suse but not debian (as I know it)
User creation It creates a user named "jetty" (JETTY_USER) by default. The install script accept the username as it first and only parameter.
etc config It creates the folder /etc/artifactory copy the configuration files there and creates a soft link in $ARTIFACTORY_HOME/etc
etc default It creates the file /etc/artifactory/default that contains the main environment variables needed for artifactory to run: JAVA_HOME, JETTY_USER, ARTIFACTORY_HOME, JAVA_OPTIONS, ...

The /etc/artifactory/default is included at the beginning of artifactoryctl and so can include whatever you wish.

Becareful: The default max memory is 1G
init.d It copy the file artifactoryctl to /etc/init.d/artifactory
Logs folder It creates /var/log/artifactory make it writable for the user JETTY_USER and creates a soft link $ARTIFACTORY_HOME/logs.
Backup folder This script will create the folder ARTIFACTORY/backup directly, so you need to create a link if you want this folder to be somewhere else (like /var/backup/artifactory for example). The script make $ARTIFACTORY_HOME/backup it writable for the user JETTY_USER.
Repos folder This script will create the folder ARTIFACTORY/repos directly, so you need to create a link if you want this folder to be somewhere else. The script will make it writable for the user JETTY_USER.
chkconfig call The script call add, list (you can see the output), then activate (on), the artifactory service

After running the script successfully you can test the installation by running: "service artifactory check" or "/etc/init.d/artifactory check"

And if everything OK start artifactory with: "service artifactory start" or "/etc/init.d/artifactory start"

And then check the log with: "tail -f $ARTIFACTORY_HOME/logs/consoleout.log"

Enjoy...

WAR File

Configure a standard Servlet container VM with -Dartifactory.home=$ARTIFACTORY_HOME, pointing to the location of your Artifactory home folder. (If you do not specify this property it will default to the ${user.home}/.artifactory).

Alternatively, you can set an ARTIFACTORY_HOME environment variable.

Artifactory will try to create the folder if it does not exist.

Copy the configuration file to $ARTIFACTORY_HOME/etc/artifactory.config.xml.

Deploy the artifactory.war file into the container.