MongoDB installation procedure

To install MongoDB, follow either the full installation procedure or the reinstallation procedure.

Caution: Take note of the MongoDB server name and the corresponding port number. Make sure you can access this information when you launch the V12 web server installation.

Full installation

Perform a full installation:

  • If you are installing the platform on a server for the first time
  • If you want to switch from a manual installation (done in 7.0) to an automatic installation.
  • If you want to switch from an installation done in 8.0 to an installation that manages security through certificates.

To do so:

  1. Double-click the .jar file in the MongoDB folder.
  2. Select the installation language and click OK.
  3. Click Next.
  4. Click Next.
  5. Select I accept the terms of this license agreement and click Next.
  6. Select New installation and click Next.
  7. Select the installation path by clicking Browse and click Next.
  8. Select the packages to install and click Next.
    Only the core files package is mandatory.
  9. (Recommended) Select the Configure the mongoDB service check box and enter:
    • The MongoDB node identifier (must be unique on a server).
    • The paths for the database data, the logging information files and the configuration files.
    • The service port number used to connect to MongoDB (27017 by default).
    Select the Enable ipv6 support check box if applicable.
  10. Select The server uses and accepts only SSL encrypted connections if applicable.
    • If you have not selected this check box, click Next.
    • If you have selected this check box, select the path for certificates storage and choose between Simplified certificate installation and Use an existing certificate.
  11. If you have selected Simplified certificate installation, enter the passphrase for the master certificate twice and click Next.
  12. Enter the information that defines the certificate and click Next.
  13. Enter the passphrase for the connection certificate twice and then the host name. Click Next.
    Make sure you enter the full server path, including the full qualified domain name.
  14. Carefully check the options selected and go back if anything was incorrectly entered.
    Click Next when everything is OK.
  15. Click Next at the end of the installation.
  16. Click Next at the end of the connectivity test.
  17. Click Generate an automatic installation script if applicable.
    This script is an XML file that stores the settings from the previous dialog boxes. It can be modified and reused in order to run a setup automatically, for example on another server.
    To automatically run an installation script associated with an XML answer file, run the following command (in a shell with the path to java.exe set and setup.jar accessible):
    java -jar setup.jar file_name.xml
  18. Click Done.

Reinstallation

To reinstall MongoDB:

  1. Double-click the .jar file in the MongoDB folder.
  2. Select the installation language and click OK.
  3. Click Next.
  4. Click Next.
  5. Select I accept the terms of this license agreement and click Next.
  6. Select Modify installation and click Next.

    Note : The old MongoDB configuration file will be backup in the update_backup folder.

  7. Modify the configuration if required. Click Next.
  8. Modify the configuration if required. Click Next.
  9. Enter the passphrase for the master certificate twice and click Next.
  10. Carefully check the options selected and go back if anything was incorrectly entered.
    Click Next when everything is OK.
  11. Click Next at the end of the installation.
  12. Click Next at the end of the connectivity test.
  13. Click Generate an automatic installation script if applicable.
    This script is an XML file that stores the settings from the previous dialog boxes. It can be modified and reused to run a setup automatically, for example on another server.
    To automatically run an installation script associated with an XML answer file, run the following command (in a shell with the path to java.exe set and setup.jar accessible):
    java -jar setup.jar file_name.xml
  14. Click Done.