By using Microsoft SQL you can benefit from features in the Microsoft SQL Server infrastructure such as backup, restore and high availability.
Optimizing Artifactory when running with MS SQL Server
When running Artifactory with Microsoft SQL Server you may create the Artifactory schema on an existing server used for other applications, however for optimal performance, we recommend creating a dedicated Microsoft SQL Server database instance and then configure Artifactory to use it as described in the following sections.
Before You Continue
Before proceeding with the steps below, please make sure you have read and followed the steps described in Changing the Default Storage.
Creating the Artifactory Microsoft SQL Server Database
Supported Microsoft SQL Server Versions
Artifactory supports Microsoft SQL Server 2008 and above.
- Create a new user for Artifactory:
In Microsoft SQL Server Management Studio, open the Object Explorer, right click on Security and select New | Login....
Create user "artifactory" and set its password.
- Create the Artifactory database:
In Microsoft SQL Server Management Studio, open the Object Explorer, right click on Databases and select New database...
- In the New Database dialog window, select General in the Select a page: navigation pane.
Set Database name to "artifactory" and Owner to "artifactory" (the user name you created in step 2).
Select the Options page and set Collation to "Latin1_General_CS_AI".
Then click OK to confirm.
Selecting a Case-sensitive Collation
While Microsoft SQL Database Server is not case-sensitive by default, it is important to select a case-sensitive collation because Artifactory is case-sensitive.
Configuring Artifactory to use Microsoft SQL Server
$ARTIFACTORY_HOME/etc/storage.properties(If you do not have this file you can take it from the standalone zip distribution or directly from the JFrog domain). For a full explanation on the contents of this file please refer to The Bundled Storage Configurations.
Adjust the connection definitions in the
$ARTIFACTORY_HOME/etc/storage.propertiesfile to match the attributes of the Artifactory database you created.
You must configure the database URL and username/password to use. The schema and tables are created first time Artifactory is run using the new database.
hostnameis your database address,
1433is your database port (if not the default 1433),
dbnameis the name of the database you created in the previous step.
Make sure not to overwrite
sendStringParametersAsUnicode=falsesince this is critical for appropriate and efficient use of the database indices.
Download and extract the Microsoft JDBC Driver and copy the
sqljdbc4.jarfile into the server's shared lib directory.
$TOMCAT_HOME/libwhen installed as a service or
$ARTIFACTORY_HOME/tomcat/libin the standalone version.
Make sure your driver has the same permissions as the rest of the files in the shared lib directory.
- Start Artifactory.