1.4.2 Using the file digikatsuwide.xml to set up the environment

According to the procedure below, edit the digikatsuwide.xml file to set the server IP address, the mail server, the sender's email address to be used for email notifications, the FQDN and domain name of the server, the storage folder for delivery data, network bandwidth limits, and the maximum size of files available for transfer.

Prerequisites

To perform this task, the system administrator logs in as the built-in Administrator user to the machine on which JP1/DH - Server is installed.

Procedure

Use a text editor to open the digikatsuwide.xml file.

The digikatsuwide.xml file is stored in the following location:

installation-folder\misc\digikatsuwide\digikatsuwide\WEB-INF
Set the server IP address.

Set the IP address of the machine on which JP1/DH - Server is installed.
```
<end-point>
    <ip>server-IP-address^#</ip>
</end-point>
<end-point protocol="https">
    <ip>server-IP-address^#</ip>
</end-point>
```
#

To make the server accessible from the Internet, specify a global IP address (for example, 192.168.0.2).
Set the mail server.

Set the host name and port number of the mail server that is currently in operation. For sender's-email-address, set the sender's email address for the email notifications that are sent to users by JP1/DH - Server to report information such as the delivery status of data.
```
<mail-notification>
    <mail-server>
        <host>mail-server-host-name</host>
        <port>mail-server-port-number</port>
    </mail-server>
    <notification-from>
        <system-address>sender's-email-address</system-address>
    </notification-from>
    :
</mail-notification>
```
Set the FQDN and domain name of the server.

Set the fully qualified domain name (FQDN) and domain name of the machine on which JP1/DH - Server is installed.
```
<biz-connect id="bizconnect">
    <service>
        :
        <bind-hostname>server-FQDN</bind-hostname>
        <bind-domainname>server-domain-name</bind-domainname>
        <bind-sub-domainname>server-subdomain-name</bind-sub-domainname>
        :
    </service>
</biz-connect>
```
Important
- Do not use an underscore (_) in the host name (the server FQDN). Doing so might cause a malfunction.
- If the FQDN or domain name of the server is invalid, the operation after logging in to JP1/DH - Server will not work properly. Make sure that no problems exist with the settings.
Tip

Structure of domain and subdomain names

A server FQDN consists of the following two parts: the domain name part and the subdomain name part.

For example, if a server FQDN is jp1dhserver.foo1.foo2.co.jp, the server domain name is foo2.co.jp, and the server subdomain name is jp1dhserver.foo1. In this example, set values in the digikatsuwide.xml file as follows:

<biz-connect id="bizconnect">

<service>

:

<bind-hostname>jp1dhserver.foo1.foo2.co.jp</bind-hostname>

<bind-domainname>foo2.co.jp</bind-domainname>

<bind-sub-domainname>jp1dhserver.foo1</bind-sub-domainname>

:

</service>

</biz-connect>
Set the storage folder for delivery data.

Set the folder for storing the data transmitted by JP1/DH - Server. The folder for storing delivery data is as follows:

C:\Program Files\Hitachi\jp1dh\server\data\.
```
<biz-connect id="bizconnect">
    :
    <persistence>
        <storage>
            <directory>C:\Program Files\Hitachi\jp1dh\server\data\</directory>
        </storage>
    </persistence>
    :
</biz-connect>
```
Important

You cannot use any network folder or any folder on a network drive as the storage folder for delivery data.
Set network bandwidth limits.

Set the network bandwidth to be used by JP1/DH - Server.
```
<biz-connect id="bizconnect">
    <service>
        :
        <throughput-limit>
            <upload>maximum-transmission-bandwidth-for-uploading^#</upload>
            <download>maximum-transmission-bandwidth-for-downloading^#</download>
        </throughput-limit>
        :
    </service>
</biz-connect>
```
#
The network bandwidth values are in Mbps.

Specify a value in the range from 0 to 1,000. You cannot omit these values.

The value 0 means no bandwidth limit.
Important
Set the network bandwidth by considering the need for balance with other business operations. In the test and evaluation phrases, verify that the specified values are appropriate.

For the network bandwidth values, specify values within the range of the network bandwidth available on actual network lines. Even if you set a value that exceeds the range of the network bandwidth available on actual network lines, no error occurs, but the network bandwidth that can be used by JP1/DH - Server is limited to the network bandwidth of actual network lines.
Set the maximum size of files available for transfer.

Set the maximum size of files that can be delivered per delivery and the maximum file size per file. Set these values by considering the content of your business.
```
<biz-connect id="bizconnect">
    <service>
      :
      <data-capacity>
        <per-file>maximum-size-per-delivery^#</per-file>
        <per-delivery>maximum-file-size-per-file^#</per-delivery>
      </data-capacity>
      :
    </service>
    :
</biz-connect>
```
#

The unit is GB.

Set a value in the range from 1 to 1,024.

Make sure that you specify the values. If you omit them, startup of JP1/DH - Server will fail.

Postrequisites

Set Java heap memory sizes in the usrconf.cfg file.

Related topics

1.4.3 Setting Java heap memory sizes

To Page Top