Cloud
& iPad

Setting up the DocMoto server to support iPad Files integration

The iPad Files app integration requires two settings:

1. DocMoto server to use a verified SSL certificate
2. Opening port 4984

DocMoto server to use a verified SSL certificate

By default a DocMoto server uses a self signed SSL certificate. This is great for most circumstances, but for the iPad (and any other third party apps) to connect smoothly you need to configure the DocMoto server to use a verified valid SSL certificate.

Obtaining a verified SSL certificate is outside of the scope of this article. However once you have your certificate you will need it in the pem format (ie my cert file.pem).

The procedure for configuring your DocMoto server to use your verified certificate is as follows:

1. Open terminal and switch to super user by typing

   sudo -s

2. Move to the settings folder by typing

   cd /var/opt/docmoto/settings

3. Rename the existing self signed certificate by typing

   mv DocMoto.pem DocMoto.pem.org

4. Copy the new pem file to the settings folder by typing

   cp <the full path to my pem>.pem .

5. Change the ownership of the pem file to user DocMoto by typing

   chown docmoto <my pem file>.pem

6. Edit the serverConfig.conf to ensure the default secure port 3984 uses the new certificate ie

   <Https
        port="3984"
        pem-filename="<path to my certificate file>.pem">
        <WebDav />
        <Admin />
   </Https>

7. Restart the DocMoto server by going into System Preferences, finding DocMoto Server, and restarting.

Opening port 4984

Firstly you must open port 4984 on your network router. Without this external connections will be blocked.

Consult your router documentation on how to open up port 4984 and ensure that traffic is directed to the DocMoto server.

Secondly you must check that your DocMoto server is listening on port 4984. Do this as follows:

• Open terminal and switch to super user by typing

  sudo -s

• Move to the settings folder by typing

  cd /var/opt/docmoto/settings

• Open the serverConfig.config file by typing

  less serverConfig.config

  and look for the following entry

  <Https
      port="4984"
      pem-filename="<path to my certificate file>.pem">
      <WebDav />
      <Admin />
      <AutoVersioning/>
  </Https>
  

  where the pem-filename points to the pem file copied in the steps above.
• If you do not have this entry then you will need to edit the serverConfig.config file using an editor such as vi or nano.
• Once edited your full serverConfig.conf https section should look as follows:

  <Https
      port="3984"
      pem-filename="<path to my certificate file>.pem">
      <WebDav />
      <Admin />
  </Https>
  <!-- Ports that do autoversioning... useful to use with WebDAV clients that don't do DeltaV -->
  <Https
      port="4984"
      pem-filename="<path to my certificate file>.pem">
      <WebDav />
      <Admin />
      <AutoVersioning/>
  </Https>

• Restart the DocMoto server by going into System Preferences, finding DocMoto Server, and restarting.