Toggle navigation

JFrog Artifactory Image Guide

Version 5.4

Websoft9 JFrog Artifactory is a pre-configured, ready to run image for running JFrog Artifactory on Alibaba Cloud.

JFrog’s Artifactory open source project was created to speed up development cycles using binary repositories. It’s the world’s most advanced repository manager, creating a single place for teams to manage all their binary artifacts efficiently.

Application Software(JFrog Artifactory5.4)
JFrog Artifactory application directory: /opt/jfrog
JFrog Artifactory logs directory: /var/opt/jfrog/artifactory/access/logs
JFrog Artifactory data directory: /var/opt/jfrog/artifactory/data
JFrog Artifactory configuration file path:/etc/opt/jfrog/artifactory
JFrog Artifactory script directory: /opt/jfrog/artifactory/bin/artifactory.sh

Application Server(Nginx1.10,JAVA1.8)
Nginx Configuration Files: /etc/nginx/sites-available/default

Database(Derby)
Derby is a opensourse database writing by Java and running on memory

After the installation of Image,please verify it

  • Login on Alibaba Cloud console,get you Internet IP Address
  • Open you Chrome or Firefox on your local PC,visit the http://Internet IP Address/
  • If verify successfully,you can enter the Start Installation page of this Image
  • If no response from browser,please check the Security Group settings to ensure that port 80 is been allowed

Using Chrome or Firefox to visit: http://Internet IP Address/ to start using this application.Following is the steps:

  1. Visit http://Internet IP Address  to enter the installation page
  2. Click the “Next” to the step of “Set Admin Password” and then go to the next step

  3. Then,Configure a Proxy Server
  4. Then,Create Repositories yourselft
  5. The latest step,Filish the configuration wizard

Three usernames and passwords are required for application installation, application using, and application maintenance:

1、JFrog Artifactory:Username is admin and password need need your own settings
2、Derby Database:No usename and password,you can set it by yourselft
3、Linux Server:Username is root,Password is set by yourself when buying.You can reset the password through console and restart the Server if you have forgotten it.Please Using the Putty for Remote and WinSCP for SFTP

Routine backup (archives) of the database and application setup is essential to ensure failover is smooth.

Backup is based on the server snapshot automatic backup and manual local backup in two ways, both of which have their own advantages and disadvantages, it is recommended to use together

Automatic Backup by Snapshot of Server

IaaS provider have the “snapshot” function for Server, the snapshot is for the server disk. Snapshot tool can record the specified point in time the hard disk data, all backed up, and can achieve a key recovery.

If you have an automatic snapshot of the disk settings, the following scenes you can be more calm face:

  • Work a few days of the results, was mistakenly deleted
  • Hackers damage your site
  • The content has been messed up

Done a snapshot backup, a key to restore to the backup point of time state. That is, on-site reduction, very good function.

Different cloud vendor snapshot settings slightly different, specific reference:

Backup Interface

You can use Backup Interface as following steps:

  1. Login as Administrator,go to Admin->Backups,
  2. You can set the Backup strategy and run the backup now

Before upgrade you should put the site down for maintenance and always Backup your code, data and config files.

It is highly recommended to temporarily disable application before upgrading. Don’t forget to empty your browser cache if you experience weird bugs right after upgrading.

Note that you should upgrade to the latest version available, installing intermediate releases sequentially is not needed.

Upgrade solution,please read the documentation:https://www.jfrog.com/confluence/display/RTF/Upgrading+Artifactory

If you want use Domain for this application,you should complete below steps:

  • Domain resolution if you want to use (Add an A record to the Internet IP Address of Server from your Domain Control Panel)
  • Modiy the Apache configuration file: /etc/nginx/sites-available/default

    server {
    ...
            listen 80 default_server;
            server_name _;//add you domain here
    ...
    }
    
  • Restart the services

Artifactory supports sending mail to notify administrators and other users for significant events that happen in your system.

Some examples are:

  • Watch notifications
  • Alerts for backup warnings and errors
  • License violation notifications

To enable mail notifications, you need to configure Artifactory with your mail server details as described below.

To access the mail server configuration, in the Admin module select Configuration | Mail.

Setup is straightforward and can be verified by sending a test message. Simply click “Send Test Mail” in the Configure Mail screen. 

Enabled
When set, mail notifications are enabled
Host
The host name of the mail server
Port
The port of the mail server
Username
The username for authentication with the mail server
Password
The password for authentication with the mail server
From (optional)
The “from” address header to use in all outgoing mails.
Subject Prefix
A prefix to use for the subject of all outgoing mails
Artifactory URL (optional)
The Artifactory URL to use in all outgoing mails to denote links to Artifactory.
Use TLS
When set, uses Transport Layer Security when connecting to the mail server
Use SSL
When set, uses a secure connection to the mail server
Test Message Recipient
The email address of a recipient to receive a test message

Websoft9 Jfrog Artifactory Image  comes with a built-in embedded Derby database that can be reliably used to store data (metadata) for production-level repositories up to hundreds of gigabytes in size.

Recommend using the documentation: https://www.jfrog.com/confluence/display/RTF/Configuring+the+Database

You can use the command to manage the services for Server.Please choose the corresponding command mode according to different types of operating system

Ubuntu Linux

Nginx Restart

~# systemctl restart nginx

Start or stop Artifactory using

~# service artifactory <start | stop>

JFrog Artifactory script directory: /opt/jfrog/artifactory/bin/artifactory.sh

 

This document is original from Websoft9.In order to ensure the seriousness and usability of the documentation, no one may misappropriate or modify the second distribution. The need for friends reproduced please mark the source, otherwise we reserve the right to give legal action.

We will periodically update the documentation. Please visit the online documentation for the latest version

This document URL: http://en.websoft9.com/xdocs/jfrogartifactory-image-guide/
Support & Partnership: http://www.websoft9.com