DownloadsMirrorWanted - OSDN Docs (English) Wiki - OSDN Docs (English)

Up: FrontPage

Prev: Mirror sites

Next: Help Us with the Translation

Looking for Mirror sites for our File Release System

At OSDN, we are looking for Mirror Providers who will host a mirror site for our file release system, at all times. If you are interested in helping us, please read the following information on OSDN's public mirror website. Please contact us when you create one.

Conditions

• For OSDN's file release mirror server, http access is requisite.
• OSDN server has to be mirrored via rsync, so please have your environment ready to use rsync.
• The mirroring size is about 1.2TB (as of 2015/September), but it is gradually increasing. You are advised to secure at least 1.5 TB.
• To allow inbound http access to the mirror server, please secure sufficient network bandwidth.
• Currently, there's only IPv4 support for mirror server (as of 2015/September, Ipv6 is not supported).
• Due to the limitations of the system (there are several IP-based limitations), DynamicIP routing will not be supported.
• Due to some kind of technical difficulties regarding mirror configuration, we may turn down your offer. Please accept our apology in advance should this happens.

Configuration

0. Abbreviated Name

First of all, you will need an abbreviated name on OSDN. Create one using Alphabet letters/numbers up to 10 figures. This will be used as host name and the abbreviated name within OSDN system. (We may ask you to change should there be any problem.)

In the following text, we will adopt abbreviated-name “example” to explain. Also, directory for mirror will be called path/to/mirror-dir .

1. Configuration for http server

Complete the configuration for http server as instructed below.

• The host name of the mirror server will be example.dl.osdn.jp. You will have to prepare a virtual host that allows this name to be used for access.
• In addition, (as for temporary measure after having changed the service name in 2015/May,) as of now, 2015/September, enable accessing also with the virtual host name, example.dl.sourceforge.jp. (Once this measure becomes unnecessary, we will let you know. )
• If there are no files on the mirror server, try redirecting to OSDN's original mirror server.

Here's a configuration example of apache2. When using other type of http server, configure to behave in the same way.

<VirtualHost *:80>
    ServerName example.dl.osdn.jp
    ServerAlias example.dl.sourceforge.jp
    DocumentRoot /path/to/mirror-dir

    # Redirect missing file to master
    RewriteEngine on
    RewriteCond %{REQUEST_URI} ^/[-a-z0-9]
    RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_FILENAME} !-d
    RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_FILENAME} !-f
    RewriteRule ^(.*)$ http://osdn.dl.osdn.net$1 [L,R=302]

    # for server not to return Content-Encoding: x-gzip
    AddType application/x-gzip .gz

    # extra mime-types
    AddType application/x-xpinstall .xpi
    AddType application/x-apple-diskimage .dmg
</VirtualHost>
<Directory /path/to/mirror-dir>
    AllowOverride None
    <IfVersion < 2.3>
        Allow from all
    </IfVersion>
    <IfVersion >= 2.3>
        Require all granted
    </IfVersion>
</Directory>

If you using nginx, please refer example below;

server {
    server_name example.dl.osdn.jp;
    root /path/to/mirror-dir;

    location / {
        try_files $uri @osdn_fallback;
    }
    location @osdn_fallback {
        rewrite ^ http://osdn.dl.osdn.jp$request_uri? redirect;
    }
}

2. Application for Mirror Server Configuration

Please contact OSDN system admin (admin -at- osdn.net) to inform the following information.

• The name of the organization who will mirror
  • Please inform the name of the company/university/organization who will mirror.
  • This name will be used on OSDN download page and documents.

• Web page URL of the organization who will mirror.
  • Please inform the URL of the organization's web page. We will install a link on the download page to provided information on the organization who is mirroring.

• Country (e.g: Japan), and Location (e.g: Tokyo) of the organization.

• Logo image about or smaller than 200x50 pixel
  • This logo image will be used on OSDN download page and mirror select window.
  • Please provide in png format.

• Email address/Name of the point of contact
  • Please inform the name and email address of the person whom we can contact, together with his/her post in the organization.
  • Email address could also be in a form of mailing list.
  • We ask for this piece of information only for the purpose of contacting you, and it will not be posted on web.

• IP Address for the Rsync Access
  • Rsync server designed for mirroring sets access limitation based on IP address. We will enable only IP addresses that were requested for rsync.
  • You could make a request for registering multiple IP addresses or IP address ranges. In that case, please explain why.

• Abbreviated Name for the Mirror Server
  • Please inform the abbreviated name which you have adopted in the previous section 0.
  • By the way, we may ask you to change the name due to some kind of technical difficulty on the system. Thank you in advance for your understanding.
  • Using this name as a base, let's move on to the additional DNS configuration for osdn.jp (we are going to add a host name after .dl.osdn.jp).

• Mirror Server's IPv4 Address or Host Name
  • Inform the IP address or the host name for the mirror server which will be allowing inbound http access. (DNS configuration will be done based on this information.)
  • If you are using IP address, we will add the A record.
  • If you are using a host name, we will add the CNAME record.

If you don't have a problem that we use all the above information, we will contact you after we complete the DNS and rsync configuration.

3. Execution and Configuration of the Mirror

Once you receive a message from us that the configuration has been completed, you can start mirroring via rsync. On mirror website, please be advised to execute rsync in the way shown below. (* Those of you who have already used rsync before must be familiar with it already, but let us remind you that the / at the end of a path has it own function, so please heed the instruction precisely.)

rsync -rplHtqSz --del rsync://master.dl.osdn.jp/download/ /path/to/mirror-dir/

After mirroring is done for the very first time, make sure to configure so that the above rsync gets executed once every hour using cron or something. By the way, mirroring website that doesn't get updated for over 12 hours will be automatically removed from the download's sorting destinations.

When you complete the configuration for mirroring via rsync, please let us know. After we confirm the condition, we will begin directing to the mirror server.

Contact Us

• OSDN Corporation
• mail: [e-mail]

Up: FrontPage

Prev: Mirror sites

Next: Help Us with the Translation