-
Notifications
You must be signed in to change notification settings - Fork 44
/
How_To_Install_HRCloud2.txt
163 lines (148 loc) · 9.78 KB
/
How_To_Install_HRCloud2.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
-----MINIMUM REQUIREMENTS-----
HRCloud2 requires at least a Raspberri Pi Model B+ or greater.
HRCloud2 should run on any x86 or x64 based PC.
HRCloud2 requires a Debian Linux-based operating system w/3rd party audio license.
-----PREFACE-----
For this guide, it is assumed that the user is installing HRCloud2
on a PC which meets the above conditions. This guide will walk
a new user through the installation of HRCloud2 on a freshly installed
version of Lubuntu 16.04 LTS with no pre-existing dependencies.
For a walkthrough of installing a Ubuntu distro, visit.....
http://www.ubuntu.com/download/desktop/install-ubuntu-desktop
IMPORTANT NOTE: During this guide we will be setting-up a fully
functional, yet somewhat customized, LAMP stack including
linux, Apache2.4, MySQL, and PHP8.0. If you DO NOT want to have
a LAMP stack installed on your local machine DO NOT install this software.
This software was designed to be run on a dedicated server setup for NAS
duties.
In the abscence of required dependencies, HRCloud2 will make every attempt
to complete a user-suppied operation while logging errors every step of the way.
Administrators are responsible for monitoring and maintaining the dependencies
of their servers.
--------------------------------------------------
-----STEP 1 - INSTALL APACHE 2.4-----
-sudo apt-get update
-sudo apt-get install apache2
-sudo apt-get install curl
--------------------------------------------------
-----STEP 2 - INSTALL MYSQL------
-sudo apt-get install mysql-server
-sudo apt-get install mysql-client
-sudo mysql_secure_installation
**DO NOT ENABLE PASSWORD STRENGTH MODULE**
-sudo mysql -u root -p
-CREATE DATABASE database1;
-exit
**WRITE DOWN THE MYSQL ROOT PASSWORD AND DATABASE NAME!!!**
--------------------------------------------------
-----STEP 3 - INSTALL FEATHERPAD, LIBREOFFICE, PHP7 & PLUGINS-----
-sudo apt-get install featherpad && sudo apt-get install libreoffice-common && sudo apt-get install libreoffice-java-common && sudo apt-get install php libapache2-mod-php php-mysql && sudo apt-get install php-all-dev
**YOU MAY NEED TO CHANGE THE PHP VERSIONS BELOW DEPENDING ON YOUR UBUNTU/PHP VERSION**
-sudo apt-get install php8.0-zip && sudo apt-get install php8.0-gd && sudo apt-get install php-curl
**EDIT THE "php.ini" FILE LOCATED IN "/etc/php/8.0/apache2/php.ini"**
-sudo featherpad /etc/php/8.0/apache2/php.ini
**SEARCH FOR AND MODIFY THE FOLLOWING VALUES CAREFULLY**
max_execution_time = 90
max_input_time = 90
memory_limit = 512M
;Use 256 - 384M for Raspberry Pis
display_errors = On
;Leave display errors = Off if you're not debugging HRCloud2 youself
post_max_size = 3000M
upload_max_filesize = 3000M
max_file_uploads = 100
zlib.output_compression = On
**SAVE THE MODIFIED "php.ini" FILE AND EXIT FEATHERPAD**
-sudo service apache2 restart
--------------------------------------------------
-----STEP 4 - INSTALL BASIC FEATURE DEPENDENCIES-----
-sudo apt-get install clamav && sudo apt-get install unoconv && sudo apt-get install default-jre
-sudo chown -R www-data:www-data /var/www
-sudo featherpad /etc/rc.local
**ADD THE FOLLOWING LINE TO THE "rc.local" FILE **ABOVE** THE "exit 0" LINE**
/usr/bin/soffice --headless --accept="socket,host=127.0.0.1,port=$soffice_port;urp;" --nofirststartwizard &
**IF YOU DO NOT HAVE AN "rc.local" FILE, OR IF THE FILE IS BLANK THEN COPY AND PASTE THE INCLUDED ONE**
-sudo chmod +x /etc/rc.local
-sudo systemctl enable rc-local.service
**IF YOU GET ERRORS WHEN ENABLING THE SERVICE**
**COPY AND PASTE THE INCLUDED "rc-local.service" FILE TO "/etc/systemd/system/rc-local.service"**
**-sudo chmod +x /etc/rc.local**
**-sudo systemctl enable rc-local.service**
-sudo apt-get install rar && sudo apt-get install unrar && sudo apt-get install p7zip-full && sudo apt-get install imagemagick && sudo apt-get install ffmpeg && sudo apt-get install tesseract-ocr && sudo apt-get install meshlab && sudo apt-get install dia && sudo apt-get install pandoc && sudo apt-get install poppler-utils && sudo apt-get install nodejs && sudo apt-get install winetricks
-sudo apt install libnode-dev && sudo apt install node-gyp && sudo apt install npm && sudo apt-get install acpi
-sudo npm install nativefier -g
**REBOOT THE SERVER**
**IF DOCUMENT CONVERSIONS DONT WORK...**
**-unoconv --listen**
**OR -unoconv -l**
**OR create a daemon to run unoconv --listen**
**OR adjust the shebang at the top of /usr/bin/unoconv to #!/usr/bin/env python3
--------------------------------------------------
-----STEP 5 - INSTALL HRCLOUD2-----
**CREATE A DIRECTORY IN "/var/www/html" NAMED "HRProprietary"**
**CREATE ANOTHER DIRECTORY IN "/var/www/html/HRProprietary" NAMED "HRCloud2"**
**VISIT "http://github.com/zelon88/HRCloud2" AND DOWNLOAD THE LATEST HRCLOUD2 .zip FILE TO YOUR DOWNLOADS FOLDER**
**EXTRACT HRCLOUD2.zip TO YOUR DOWNLOADS FOLDER**
**COPY THE CONTENTS OF THE "HRCloud2-master" FOLDER TO "/var/www/html/HRProprietary/HRCloud2"*
-sudo featherpad /var/www/html/HRProprietary/HRCloud2/config.php
**CAREFULLY READ AND COMPLETELY FILL OUT THE CONFIG.PHP FILE!!!**
**HRCLOUD2 REQUIRES A SAFE LOCATION TO CREATE USER CLOUD DIRECTORIES. TO FACILITATE THIS YOU MUST CREATE A !!!NEW!!! DIRECTORY AND ENTER IS AS THE "$CloudLoc"**
**ONCE YOU HAVE CREATED A CLOUD LOCATION "$CloudLoc" CONTINUE**
-sudo chmod -R 0755 /path/to/my/CloudLoc
-sudo chown -R www-data /path/to/my/CloudLoc
-sudo chgrp -R www-data /path/to/my/CloudLoc
**IF YOU DO NOT HAVE A VALID "$CloudLoc" AND PROPER PERMISSIONS, HRCLOUD2 ...WILL...NOT...WORK!!!**
-sudo featherpad /var/www/html/HRProprietary/HRCloud2/Applications/HRAI/adminINFO.php
**CAREFULLY READ AND COMPLETELY FILL OUT YOUR ADMIN USER AND LOGIN INFO FOR HRAI**
-sudo chmod -R 0755 /var/www/html
-sudo chown -R www-data /var/www/html
-sudo chgrp -R www-data /var/www/html
**OPTIONAL -sudo useradd -g www-data USERNAME #adds your user to www-data usergroup.**
**MAKE SURE THAT ANY UPDATES YOU PERFORM TO HRCLOUD2 HAVE PROPER PERMISSIONS!!!**
**SCRUTINIZE / DOUBLE-CHECK THE PERMISSIONS FOR ANY FILES ADDED TO /HRCloud2 AFTER INSTALLATION IS COMPLETE!!!**
**VISIT HTTP://localhost/HRProprietary/HRCloud2/index1.php IN A BROWSER TO HAVE HRCLOUD2 INSTALL WORDPRESS!!!**
IMPORTANT NOTE: If you need to correct permissions later, perform the following commands
from above again...
-sudo chmod -R 0755 /var/www/html
-sudo chown -R www-data /var/www/html
-sudo chgrp -R www-data /var/www/html
--------------------------------------------------
-----STEP 6 - CONFIGURE WORDPRESS-----
**NAVIGATE TO "/var/www/html"**
-sudo featherpad /var/www/html/wp-config.php
**SEARCH FOR AND MODIFY THE FOLLOWING VALUES CAREFULLY**
define('DB_NAME', 'database1');
define('DB_USER', 'root');
define('DB_PASSWORD', 'YOURPASSWORD');
**VISIT "http://localhost" IN A BROWSER AND YOU SHOULD BE GREETED BY THE WORDPRESS INSTALLATION PAGE**
**COMPLETELY READ AND FILL OUT THE WORDPRESS INSTALLATION PAGE**
**IF YOU GET AN ERROR: "ERROR ESTABLISHING CONNECTION TO DATABASE" FOLLOW THE STEPS BELOW**
-sudo mysql
-ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'YOUR_DB_PASSWORD_HERE';
-FLUSH PRIVILEGES;
-exit;
--------------------------------------------------
-----STEP 7 - VISIT YOUR CLOUD!!!-----
Go to http://localhost/HRProprietary/HRCloud2 to view your Cloud Drive! The computer you install HRCloud2 onto should be considered a staitionary NAS device that you can safely point your "Static NAT" at and access from anywhere. To accomplish these things, follow the additional steps below.
--------------------------------------------------
-----STEP 8 - ADD FIREWALL EXCEPTIONS AND SETUP STATIC NAT ON YOUR ROUTER-----
-According to the manual for the manufacturer of your broadband router, find the local IP address where you can make changes to it's
configuration. Try entering "192.168.1.1" into a browser. If you are greeted with a login screen, check the bottom of your router or your
system administrator for the required information. If you are not greeted with any tangible login screen other than an error message,
seek the owners manual for the specific make and manual for your router.
-Once you have gained access to your router, seek the settings which control Firewall exceptions and Static NAT settings.
You should seek a way to enter the local IPv4 address of the machine running HRCloud2.
You should also seek a way to enter a "Static NAT" entry for the local IPv4 address of the machine running HRCloud2.
You should also forward port 80 to the internal IPv4 of the machine running HRCloud2.
To configure SSL encryption, add port 443 to your port forwarding rules and visit www.letsencrypt.com for instructions on obtaining and installing an SSL certificate.
-It is not reccomended that you utilize this Cloud platform in commercial or even open-to-the-public fashion.
-To protect your installation and your server, secure your administrator account within WordPress and disable account creation for visitors.
-If you want other users to have their own Cloud on your network, create an account for them manually by using the administrator features
built into WordPress.
-HRCloud2 will create and maintain complete segregation of user Cloud files during operation, and will not impose restrictions on user uploads
(however PHP will, so verify that your php.ini file is set correctly!!!).
-You and your users should now be able to access your server via any standard web browser by entering the IPv4 from your
ISP into the address bar. Alternatively you can purchase a domain name and point it at the IPv4 instead to obtain a ".com"
(or similar) address for your new Cloud.
--------------------------------------------------
If you have any problems with HRCloud2 please create an issue on http://github.com/zelon88/HRCloud2