Recordin_ Installation_IQ_1_0

Public Channel / documentation

599 views
0 Likes
0 0
Step by step installation procedure for Record'in Blockchain software

Share on Social Networks

Share Link

Use permanent link to share in social media

Share with a friend

Please login to send this document by email!

Embed in your website

Select page to start with

1. Recordins SAS www.recordins.com admin@recordins.com IQ Recordin Installation v1.0 Project: Recordin Date: 13/02/2019 Version: 1.0 Installation procedure of Record’in software

17. Recordins SAS www.recordins.com admin@recordins.com Illustration Index Philippe Schweitzer · IQ Recordin Installation · Version 1.0 Recordins SAS · 13/02/2019 · Page : 17 / 17

2. Recordins SAS www.recordins.com admin@recordins.com History of changes Version Date Author Coment / Status 1.0 13 /02/2019 Philippe Schweitzer Initial version Document validation Name Date Signature Philippe Schweitzer 13 /02/2019 Philippe Schweitzer · IQ Recordin Installation · Version 1.0 Recordins SAS · 13/02/2019 · Page : 2 / 17

6. Recordins SAS www.recordins.com admin@recordins.com IV. Prerequisites No. Prerequisite Prerequisite met Y/N 1 A server with following minimal specifications: - 2 CPU cores - 4 GB of RAM - 20 GB of disk space 2 A server installed with following OS Debian 9.6 3 Download Record’in software form Github repository: https://github.com/recordins/recordin/releases Philippe Schweitzer · IQ Recordin Installation · Version 1.0 Recordins SAS · 13/02/2019 · Page : 6 / 17

11. Recordins SAS www.recordins.com admin@ recordins .com No. Activity Succesfully Completed Y/N 17 Adapt Java JVM settings #> vim recordin.sh # Update 'launch.sh' with the memory settings and java location: /soft/java/current/bin/java -Xms3G -Xmx3G -XX:+UseG1GC -jar Recordin-all-in-one-jar-19.01-RELEASE.jar $@ 18 Add recordin to users group #> vim /etc/group And put following content for users group: users:x:100:recordin 19 Update permissions chown -R recordin:root /soft/recordin/ /users/recordin/ /backup/recordin/ chown -R root:users /soft/java/ chmod -R 700 /soft/ /users/ /backup/ chmod -R 750 /soft/java/ chmod 711 /soft/ /users/ /backup/ Philippe Schweitzer · IQ Recordin Installation · Version 1.0 Recordins SAS · 13/02/2019 · Page : 11 / 17

3. Recordins SAS www.recordins.com admin@recordins.com Table of Contents I.INTRODUCTION ............................................................................................. 4 II.INSTALLER ..................................................................................................... 5 III.SYSTEM INFORMATION ................................................................................ 5 IV.PREREQUISITES ............................................................................................ 6 V.INSTALLATION STEPS ..................................................................................... 7 VI.INSTALL OF SSL CERTIFICATE AND REDIRECTION ........................................ 13 VII.VALIDATION / INSTALLATION QUALIFICATION STEPS ................................. 16 Philippe Schweitzer · IQ Recordin Installation · Version 1.0 Recordins SAS · 13/02/2019 · Page : 3 / 17

7. Recordins SAS www.recordins.com admin@ recordins .com V. Installation steps No. Activity Succesfully Completed Y/N 1 Connect with ssh as root The first password is provided by your administrator $> ssh root@<hostname in section 3> 2 Update root password, and store it inside the password manager #> passwd 3 Update the hostname inside the server #> apt-get install vim #> vim /etc/hostname Replace the actual value with the <hostname in section 3> 4 Update vim properties #> vim .vimrc Put following lines: set mouse-=a syntax on Philippe Schweitzer · IQ Recordin Installation · Version 1.0 Recordins SAS · 13/02/2019 · Page : 7 / 17

10. Recordins SAS www.recordins.com admin@ recordins .com No. Activity Succesfully Completed Y/N 13 Extract and install java version #> cd /soft/recordin/install/ #> tar -xvzf recordin-19-01-linux_amd64.tar.gz 2>/dev/null #> mv linux_amd64/jre1.8.0_202/ /soft/java/jre1.8.0_202/ #> cd /soft/java/ #> ln -s jre1.8.0_202/ current 14 Copy files and folders to the destination location: #> cd /soft/recordin/install/linux_amd64/ #> cp -r * ../.. 15 Update etc/webserver.properties #> cd /soft/recordin/ #> vim etc/webserver.properties # Comment or adapt line, eventually puth either the hostname or the IP address directly. # Comment will setup the software to use the address linked with the FQDN of the server, NetworkInterface=localhost 16 # Delete 'etc/keys.properties' if existing # Delete 'etc/users.properties' if existing rm etc/keys.properties etc/users.properties 2>/dev/null Philippe Schweitzer · IQ Recordin Installation · Version 1.0 Recordins SAS · 13/02/2019 · Page : 10 / 17

15. Recordins SAS www.recordins.com admin@ recordins .com No. Activity Succesfully Completed Y/N 6 Update etc/webserver.properties to enable SSL #> vim etc/webserver.properties # Update following property to true. NetworkSecureSSL=true 7 Configure iptables for port redirection Update iptable 443 port redirection, make sure selecting the correct network interface name Eventually execute “ /sbin/ifconfig ” command to look for the correct network interface #> iptables -t nat -A PREROUTING -i <network interface name> -p tcp --dport 443 -j REDIRECT --to-port 8080 #> iptables-save > /etc/firewall.conf #> vim /etc/network/if-up.d/iptables Insert following content: --- #!/bin/sh iptables-restore < /etc/firewall.conf --- #> chmod +x /etc/network/if-up.d/iptables #> reboot Philippe Schweitzer · IQ Recordin Installation · Version 1.0 Recordins SAS · 13/02/2019 · Page : 15 / 17

14. Recordins SAS www.recordins.com admin@ recordins .com No. Activity Succesfully Completed Y/N 4 Configure Record’in webserver with SSL #> chmod +x /etc/letsencrypt/archive/ #> chmod +x /etc/letsencrypt/live/ #> vim /soft/recordin/recordin.sh Update domain, your password and add following just before the software start line (before the line containing the .jar file): --- DOMAIN= <hostname in section 3> rm /soft/recordin/etc/keystore.jks 2>/dev/null rm /tmp/fullchain.pkcs12 2>/dev/null openssl pkcs12 -export -out /tmp/fullchain.pkcs12 -in /etc/letsencrypt/live/${DOMAIN}/fullchain.pem -inkey /etc/letsencrypt/live/$ {DOMAIN}/privkey.pem -passout pass: <your password> /soft/java/current/bin/keytool -importkeystore -destkeystore /soft/recordin/etc/keystore.jks -srckeystore /tmp/fullchain.pkcs12 -srcstoretype PKCS12 -noprompt -storepass password -srcstorepass <your password> --- 5 Update etc/ssl.properties to enable SSL #> cd /soft/recordin/ #> vim etc/ssl.properties # Update following property with your password. password= <your password> Philippe Schweitzer · IQ Recordin Installation · Version 1.0 Recordins SAS · 13/02/2019 · Page : 14 / 17

9. Recordins SAS www.recordins.com admin@ recordins .com No. Activity Succesfully Completed Y/N 8 #> vim .vimrc Put following lines: set mouse-=a syntax on 9 #> vim .bashrc Uncomment following line: alias ll='ls -l' 10 Move back to root $> exit 11 Create folders mkdir -p /soft/recordin/install mkdir -p /soft/java mkdir -p /users/recordin/log/ mkdir -p /backup/recordin/ chown -R recordin:root /soft/recordin/ /users/recordin/ /backup/recordin/ chmod -R 700 /soft/ /users/ /backup/ chmod 711 /soft/ /users/ /backup/ 12 Copy Recordin installation resources Make sure having downloaded the release from the GitHub URL described in section 4 scp -r recordin-19 -01-linux_amd64.tar.gz recordin@<hostname in section 3>:/soft/recordin/install Philippe Schweitzer · IQ Recordin Installation · Version 1.0 Recordins SAS · 13/02/2019 · Page : 9 / 17

12. Recordins SAS www.recordins.com admin@ recordins .com No. Activity Succesfully Completed Y/N 20 Create start script #> vim /etc/systemd/system/recordin.service Create put following content --- [Unit] Description=Record’in Blockchain Software [Service] Type=simple User=recordin ExecStart=/soft/recordin/recordin.sh ExecReload=/bin/kill -HUP $MAINPID KillMode=control-group KillSignal=SIGINT TimeoutSec=90 [Install] WantedBy=multi-user.target --- 21 Install start script and reboot #> systemctl enable recordin.service #> reboot Beaware that the software will initiate just after the reboot, it will take arount 10 minutes to complete. The web interface is accessible at following URL: “ http:// <hostname in section3 :8080> ” Philippe Schweitzer · IQ Recordin Installation · Version 1.0 Recordins SAS · 13/02/2019 · Page : 12 / 17

13. Recordins SAS www.recordins.com admin@ recordins .com VI. Install of SSL certificate and redirection No. Activity Succesfully Completed Y/N 1 Connect with ssh as root $> ssh root@<hostname in section 3> 2 Install nginx and certbot #> apt-get install nginx python-certbot-nginx #> certbot --nginx Enter following informations: --- Email address: <your administrative email address> (A)gree/(C)ancel: A (Y)es/(N)o: N <hostname in section 3> 2 -> for redirect --- 3 Configure nginx #> cd /etc/nginx/sites-available/ #> mv default default_orig #> vim default Enter following informations: --- server { return 301 https://$host$request_uri; } --- Philippe Schweitzer · IQ Recordin Installation · Version 1.0 Recordins SAS · 13/02/2019 · Page : 13 / 17

8. Recordins SAS www.recordins.com admin@ recordins .com No. Activity Succesfully Completed Y/N 5 #> vim .bashrc Uncomment following lines: export LS_OPTIONS='--color=auto' alias ls='ls $LS_OPTIONS' alias ll='ls $LS_OPTIONS -l' 6 Create “recordin” user, and store password inside the password manager : #> adduser recordin --- Adding user `recordin' ... Adding new group `recordin' (1001) ... Adding new user `recordin' (1001) with group `recordin' ... Creating home directory `/home/recordin' ... Copying files from `/etc/skel' ... Enter new UNIX password: Retype new UNIX password: passwd: password updated successfully Changing the user information for recordin Enter the new value, or press ENTER for the default Full Name []: Room Number []: Work Phone []: Home Phone []: Other []: Is the information correct? [Y/n] --- 7 Move to recordin user #> su - recordin Philippe Schweitzer · IQ Recordin Installation · Version 1.0 Recordins SAS · 13/02/2019 · Page : 8 / 17

16. Recordins SAS www.recordins.com admin@recordins.com VII. Validation / Installation Qualification steps Author instructions: This section describes any tests that should be run to verify that the installation was successful. The document author must fill in the “Action” and “Expected Result” sections, with adequately detailed instructions and expected observations so that an independent judgment can be made based on the observed /documented observations as to whether the test was successful. If observed results are best documented via screen print or data output (e. g. a log file) this should be noted in the instructions. The author must ensure that enough space is provided to record observed results. Installer instructions: The installer will fill in the “Observed Result”, a pass / fail assessment, and initial and date the test by hand at the time of testing. Printed evidence should be handled as per the instructions in section 8. IMPORTANT: The following tests must be performed to validate the installation process. Follow these instructions and report errors during tests or differences from expected results. No. activity 1 Action: http:// <hostname in section 3> :8080 OR with SSL: http:// <hostname in section 3> Expected results: Record’in’s page opens correctly, and menu “Admin>Model” opens without error. In case of SSL encryption, the page must also automatically redirect to the “https://” URL, and open correctly with a green lock in the address bar of the Inter - net browser. Observed Results: Pass/Fail Initials/Date * * Philippe Schweitzer · IQ Recordin Installation · Version 1.0 Recordins SAS · 13/02/2019 · Page : 16 / 17

5. Recordins SAS www.recordins.com admin@recordins.com II. Installer The Installer is the person performing the following steps and as such, is the person that signs off on each step as it is completed. In the rare case that more than one installer is working on the same system and is personally performing the steps in this IQ, the second and subsequent additional installer’s names should be written into the space provided. Name Company/Role Signature Initials Date Philippe Schweitzer Recordins/CEO PHS 13/02/2019 III. System Information Attribute Value Hostname demo.recordins.com Target Server Virtual machine Server Function VM for development Application Name Record’in 19 -01 Version 19 -01 Manufacturer Recordins Distribution Media Electronic / Internet Language English Data source provided by Recordins Comment N/A Conventions : N/A Philippe Schweitzer · IQ Recordin Installation · Version 1.0 Recordins SAS · 13/02/2019 · Page : 5 / 17

4. Recordins SAS www.recordins.com admin@recordins.com I. Introduction This document describes the installation procedure of Record’in software. Comments to the installer: An Installation Qualification, or IQ, is a document that provides verification that a system is installed according to manufacturer specifications. To satisfy regulations this document must be written and pre-approved. There are strict guidelines guiding the creation of this document, so please read the following rules carefully and do not deviate from these rules: 1. Write in ink . If you make a mistake, draw a single line through the mistake, and initial and date it . 2. Do not leave any blank fields. If something does not apply to this system, write N / A in the appropriate space with a brief explanation of why. Alternatively, if it is foreseeable that certain sections may not always be applicable, a conditional check box indicating non-applicability, accompanied by suitable instructions, can be used to skip inapplicable steps. 3. If you do not or cannot complete some action listed on this form, write NO in the ‘OK’ field, and make a footnote in the ‘Installation Remarks’ section at the end of this form. a. If you use a different version of a utility or component specified in this form, footnote the entry, and provide the version of the utility or component in the ‘Installation Remarks’ section. Include the reason for using a different version. 4. If you observe any errors during the assembly, testing, or shutdown of the system, please make a note of your observations in the ‘Installation Remarks’ section. 5. When you are required to print evidence in support of the documentation, please date and initial the first page of the hardcopy and staple or otherwise bind the pages of the printout together. 6. If there is a field for you to sign or initial, please do so. Every field requiring a signature or initials must be signed. 7. Please fill out by hand. Fill in data during execution, not after completion. Philippe Schweitzer · IQ Recordin Installation · Version 1.0 Recordins SAS · 13/02/2019 · Page : 4 / 17

Views

  • 599 Total Views
  • 315 Website Views
  • 284 Embedded Views

Actions

  • 0 Social Shares
  • 0 Likes
  • 0 Dislikes
  • 0 Comments

Share count

  • 0 Facebook
  • 0 Twitter
  • 0 LinkedIn
  • 0 Google+

Embeds 5

  • 4 in-slideshow.com
  • 6 www.in-slideshow.com
  • 5 in-teractive.com
  • 3 redirect.in-slideshow.com
  • 2 51.75.205.33