############
Installation
############

************************
Downloading d3VIEW Build 
************************

d3VIEW build is supported on any type of Linux operating system that includes RedHat, CentOS, Suse, Ubuntu. Please contact your local distributor or support@d3view.com to receive a build (d3VIEW.run) for your operating system.


************************
Architecture
************************

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
************************

#. cp d3VIEW.run /opt/d3view
#. ./d3VIEW.run
#. cd d3VIEW
#. Start the server using ./d3view_server.sh start
#. Open a browser and go to http://D3VIEW_SEVRER:3080/hostids.php. Please share the hostids from this link to get a valid license file
#. Once you receive the license file, you can edit the file D3VIEW_INSTALL_DIR/amp/php/bin/php.ini and update the license_path
#. You can stop and start the server as D3VIEW_INSTALL_DIR/d3view_server.sh stop and D3VIEW_INSTALL_DIR/d3view_server.sh start 
#. This will now guide you do the installation steps 


************************
Set up SSL Keys
************************

#. 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

#. Share the CSR from the above command to generate the SSL-certificate

#. 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

#. 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

   .. code-block: bash

   *  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)

************************
Updating 
************************

#. cp d3VIEW_NEW_BUILD.tgz D3VIEW_INSTALL_DIR/app
#. cd D3VIEW_INSTALL_DIR/app
#. tar -xzf d3VIEW_NEW_BUILD.tgz
#. cp D3VIEW_INSTALL_DIR/app/PREVIOUS_BUILD/local/etc/local_settings.inc NEW_BUILD_DIR/local/etc
#. cd D3VIEW_INSTALL_DIR
#. rm web; ln -s app/NEW_BUILD_DIR/web web