2. Installation

This document describes how to install the d3VIEW platform on a Linux server, configure the application, and perform basic setup operations.

2.1. Install d3VIEW

The installation process includes downloading the installation build, choosing an architecture, performing the installation, starting the server, and completing application-level configuration.

2.2. Steps to Install d3VIEW

This section explains the complete install workflow from obtaining the build to starting the application server.

Downloading d3VIEW Build

  1. d3VIEW supports Linux systems such as RedHat, CentOS, Suse, and Ubuntu.
  2. Contact your distributor or email support@d3view.com to obtain the installation build (d3VIEW.run) for your target OS.

Architecture

d3VIEW supports three deployment architectures:

  1. The minimum architecture that can be used to run d3VIEW-Platform is a all-inclusive LAMP stack in which a single Linux server supports running Apache and Database. This is the simplest method to run d3VIEW and can support 1-5 users depending on the server capacity.
  2. The second method is to host d3VIEW-Platform using two servers that each run Apache and Database server separately. This is most commonly used for small-to-medium loads and is highly recommended. The two servers can be independent with local storage to each of the servers.
  3. The third method is high-availability and reducdant system in which the Database is run in a clustered environment and the Apache is run behind a load-balancer with multiple servers hosting the application

Installation

Follow these commands on your Linux host to install d3VIEW:

  1. Copy and run the installation script:

Navigate to the d3view Installed directory /opt/d3VIEW and copy the run file (d3VIEW.run) shared by d3VIEW.

cp d3VIEW.run /opt/d3view
cd /opt/d3view

Using the above commands user can copy the file to the installed directory.

Use the below command to run the installation

./d3VIEW.run

This will copy and executes the installer script.

  1. Verify installation files are present.

    cd d3VIEW
ls

    If the tmp directory is missing, create it:

    Use below commands to create tmp directory in installed directory.

    mkdir tmp

  2. Start the application server:

    /d3view_server.sh start

  3. Open a browser and navigate to:

    http://D3VIEW_SERVER:3080/hostids.php

    This page displays Host IDs required for licensing.

    Below Image shows the host IDs info.

Host IDs info



  1. After receiving the valid license file, open:

    /D3VIEW_INSTALL_DIR/amp/php/bin/php.ini

  2. Edit and update the “license_path” to point to the new license file.

  3. Restart the server if needed

    /D3VIEW_INSTALL_DIR/d3view_server.sh stop
/D3VIEW_INSTALL_DIR/d3view_server.sh start

    The image below shows an example of the license path.

License path



Application Installation

  1. Start the server using /d3view_server.sh

  2. Open the link  http://D3VIEW_SEVRER:3080 ,which will open the installation page. Click on ‘Install’

    http://D3VIEW_SERVER:3080

Install



  1. The next step in Installing is Database connection, and this will tell us how to connect to the Database.
    1. Provide Host name
    2. Username
    3. Password
    4. Database name

Database connection



  1. Next step is to Create Administration account by providing - user name , email ID and Password.

    Click on create account after adding the credentials.

Administration



  1. Once the d3VIEW installation is complete and the account is created
  2. Login page will be navigated, and User can login to d3VIEW with the credentials.

Login to d3VIEW



After successful login, the user will be directed to the d3VIEW dashboard, where you can start visualizing and analyzing simulation data.

Updating

  1. Place the new build d3VIEW_NEW_BUILD_FILE.tgz file into d3VIEW install directory (under the ./app directory)

    ./d3VIEW_INSTALL_DIR/app/

  2. Extract/unzip the file under the app directory

    tar -xzf d3VIEW_NEW_BUILD_FILE.tgz

    this creates a new directory under the ./app directory : ./d3VIEW_INSTALL_DIR/app/d3VIEW_NEW_BUILD_FILE/

    in this new directory, there is a dir called “web” which is the new d3view build.

  3. Move back to the d3VIEW INSTALL directory (d3VIEW_INSTALL_DIR)

    ./d3VIEW_INSTALL_DIR/

  4. Update the “web” link

    rm web; ln -s ./d3VIEW_INSTALL_DIR/app/d3VIEW_NEW_BUILD_FILE/web web

    (rm web : remove the older version of d3VIEW build)

    (ln -s **** web : create a new link that links to the new d3VIEW build we just unzipped)

Additional Information

If Port is restricted,

Start Apache as Root.

Switch to root because port 80 requires root privileges. Do not start MySQL at this point. This starts the Apache web server on port 80.

Switch to your regular user.

After Apache is running, switch back to your normal user account. This ensures MySQL and other d3VIEW processes run under the correct user permissions.

Start MySQL.

Now start the MySQL server as your user (not root): Then Access d3VIEW

Set up SSL Keys

  1. On the server where d3VIEW is installed, create a server CSR file using the following command openssl req -new -newkey rsa:2048 -nodes -keyout d3view_server.key -out d3view_server.csr
  2. Share the CSR from the above command to generate the SSL-certificate
  3. Once the SSL-certificate is issued, you can convert them from p7b format to .cer format as shown below openssl pkcs7 -print_certs -in ssl_certificate.p7b -out ssl_sertificate.cer
  4. Edit the Apache configuration file D3VIEW_INSTALL_DIR/am/httpd/conf/http.conf and add the following lines if not present or update the path to the certificates from above
    • SSLCertificateKeyFile /path/to/d3view_server.key (server key file from step 1 above)
    • SSLCertificateFile /path/to/ssl_certificate_from_network_team.cer (provided by network team after step 2 above)
    • SSLCertificateChainFile /path/to/ssl_certificate_chain.cer (chain from step 3 above)

FAQs

  1. What is happening in the scratch directory?

  1. This is where we create temporary files when extracting data

  1. What is the database directory?

  1. The default is D3VIEW_INSTALL_DIR/amp/mysql/data

  2. This is where we maintain all of the information related to data

  1. Setting up HPC

  1. We have information here: https://www.d3view.com/docs/master/getting_started/Administration.html

  1. What is the FILE_TRANSLATORS

  1. We need this to convert LS-DYNA d3plots into a compressed format

  1. What is SIMLYZER_HOST

  1. In some cases, the data-extraction can be done here.

  1. LDAP

  1. The default authentication is d3view-database

  1. FORA is where the FORA server is located (fora3.d3view.com)
  2. LUCY_EXE should be D3VIEW_INSTALL_DIR/lucy/bin/lucy