Difference between revisions of "Installation on Linux/Debian"

From nuBuilderForte
Jump to: navigation, search
(Additional system settings)
 
(23 intermediate revisions by 2 users not shown)
Line 7: Line 7:
 
To do this, you can follow any Linux/Debian installation guide. A few links which can be helpful are listed below:
 
To do this, you can follow any Linux/Debian installation guide. A few links which can be helpful are listed below:
  
''(It is best to just apply the recommended settings during the installation process)''
+
''It is best to just apply the recommended settings during the installation process.''
 +
 
  
 
https://www.cyberciti.biz/faq/how-to-install-lamp-on-debian-10-buster/
 
https://www.cyberciti.biz/faq/how-to-install-lamp-on-debian-10-buster/
Line 18: Line 19:
  
  
 
+
Recommended PHP modules to install (adjust acc. to your version):
 +
<pre>
 +
php7.4-cli php7.4-fpm php7.4-pdo php7.4-mysql php7.4-zip php7.4-gd  php7.4-mbstring php7.4-curl php7.4-xml
 +
php7.4-bcmath php7.4-json php7.4-common php7.4-intl php7.4-bz2 php7.4-soap php7.4-mysql php7.4-readline
 +
php7.4-opcache php7.4-mbstring php7.4-gd php7.4-curl php7.4-pspell php7.4-zip php7.4-xmlrpc php7.4-tidy php7.4-sqlite3
 +
php7.4-imap php7.4-cli php7.4-fpm php7.4-cgi php7.4-cgi-dbgsym libapache2-mod-php7.4
 +
</pre>
 
== '''Creation of database.''' ==
 
== '''Creation of database.''' ==
  
 +
The database for nuBuilder Forte can be created from the command line or with phpMyAdmin if installed together with LAMP server.
  
The database for nuBuilder Forte can be created from the command line or with phpMyAdmin which will allow a more user friendly way to perform that process.
+
Please note that phpMyAdmin is included in the nuBuilder package and will be available from it after full installation and commissioning of nuBuilder.
(The installation of phpMyAdmin is included in the last link).
+
  
  
Line 32: Line 39:
  
 
First, open the mysql command line from the system terminal with:
 
First, open the mysql command line from the system terminal with:
 
+
<pre>
>>> ''mysql -u root -pYourRootPsw''
+
mysql -u root -pYourRootPsw
 
+
</pre>
 
Next, the DB and user can be created as follows:
 
Next, the DB and user can be created as follows:
 
+
<pre>
>>> ''create database TestDB;''
+
create database TestDB;
 
+
create user 'globeadmin'@'%' identified by 'nuB4psw';
>>> ''grant all privileges on TestDB.* to 'globeadmin'@'%' identified by 'nuBpsw';''
+
grant all privileges on TestDB.* to 'globeadmin'@'%';
 
+
</pre>
 
+
  
 
== '''Downloading nuBuilder Forte''' ==
 
== '''Downloading nuBuilder Forte''' ==
  
 
+
Download the nuBuilder Forte zipped files from SourceForge
Download the nuBuilder Forte zipped files from SourceForge
+
https://sourceforge.net/projects/nubuilder/
 
+
<pre>
>>>> ''wget https://sourceforge.net/projects/nubuilder/files/latest/download''
+
wget https://sourceforge.net/projects/nubuilder/files/latest/download -O nubuilder.zip
 
+
</pre>
 
Unpack the downloaded file
 
Unpack the downloaded file
 
+
<pre>
>>> ''unzip download''
+
unzip nubuilder.zip -d TestDB
 
+
</pre>
Rename to desired name (it can have the name of the DB or any other name):
+
 
+
>>> ''mv nubuilder4-master TestDB''
+
 
+
 
The folder TestDB must be placed in the Apache2 folder to be accessible externally. Typically it will be:
 
The folder TestDB must be placed in the Apache2 folder to be accessible externally. Typically it will be:
 
+
<pre>
''/var/www/html/TestDB''
+
/var/www/html/TestDB
 
+
</pre>
 
+
  
 
== '''nuBuilder configuration''' ==
 
== '''nuBuilder configuration''' ==
  
 
Edit '''nuconfig.php''' (nano editor can be used or any other)
 
Edit '''nuconfig.php''' (nano editor can be used or any other)
 
+
<pre>
>>> ''nano /var/www/html/TestDB/nuconfig.php''
+
nano /var/www/html/TestDB/nuconfig.php
 
+
</pre>
 
For simplicity the same name and password both for DB and nuBuilder accounts were used here - but different ones can be used as well.
 
For simplicity the same name and password both for DB and nuBuilder accounts were used here - but different ones can be used as well.
  
 
There are more settings possibilities in nuconfig.php but for the beginning the following ones are sufficient to set-up:
 
There are more settings possibilities in nuconfig.php but for the beginning the following ones are sufficient to set-up:
 
+
<pre>
''$nuConfigDBName                    = "TestDB";
+
$nuConfigDBName                    = "TestDB";
 
+
 
$nuConfigDBUser                    = "globeadmin";
 
$nuConfigDBUser                    = "globeadmin";
 
+
$nuConfigDBPassword                = "nuB4psw";
$nuConfigDBPassword                = "nuBpsw";
+
 
+
 
$nuConfigDBGlobeadminUsername      = "globeadmin";
 
$nuConfigDBGlobeadminUsername      = "globeadmin";
 
+
$nuConfigDBGlobeadminPassword      = "nuB4psw";
$nuConfigDBGlobeadminPassword      = "nuBpsw";
+
$nuConfigTitle                      = "TestDB - nuBuilder";
 
+
</pre>
$nuConfigTitle                      = "TestDB - nuBuilder";''
+
 
+
  
 
== '''Launch of nuBuilder''' ==
 
== '''Launch of nuBuilder''' ==
Line 91: Line 87:
 
After the configuration you can login to nuBuilder with link to the folder on your http server.
 
After the configuration you can login to nuBuilder with link to the folder on your http server.
  
(But of course you need to use your own server address)
+
''But of course you need to use your own server address.''
 
+
<pre>
 
http://192.168.1.10/TestDB/index.php
 
http://192.168.1.10/TestDB/index.php
 
+
</pre>
 
when the login window appears enter the nuBuilder user and password:
 
when the login window appears enter the nuBuilder user and password:
 
+
<pre>
 
User: globeadmin
 
User: globeadmin
 +
Password: nuB4psw
 +
</pre>
 +
All the required tables will be created automatically. So no need to import manually the initial nubuilder4.sql to MariaDB - (anyway manual import is as well allowed).
  
Password: nuBpsw
+
== '''Additional system settings''' ==
 +
Allow nuBuilder and phpMyadmin to access their temp folders.
 +
<pre>
 +
chown -R www-data:www-data /var/www/html/TestDB
  
All the required tables will be created automatically. So no need to import manually the initial nubuilder4.sql to MariaDB - (anyway manual import is as well allowed).
+
cd /var/www/html/TestDB
 +
chmod 400 nuconfig.php
 +
</pre>

Latest revision as of 21:59, 7 February 2021

LAMP server installation on Linux Debian

Before installing nuBuilder Forte on your server you need to make sure that Apache2, MariaDB and PHP are properly installed, configured and fully operational.

To do this, you can follow any Linux/Debian installation guide. A few links which can be helpful are listed below:

It is best to just apply the recommended settings during the installation process.


https://www.cyberciti.biz/faq/how-to-install-lamp-on-debian-10-buster/

https://www.tecmint.com/install-lamp-on-debian-10-server/

https://www.digitalocean.com/community/tutorials/how-to-install-linux-apache-mariadb-php-lamp-stack-on-debian-10

https://linuxhint.com/install_phpmyadmin_debian_10/


Recommended PHP modules to install (adjust acc. to your version):

php7.4-cli php7.4-fpm php7.4-pdo php7.4-mysql php7.4-zip php7.4-gd  php7.4-mbstring php7.4-curl php7.4-xml
php7.4-bcmath php7.4-json php7.4-common php7.4-intl php7.4-bz2 php7.4-soap php7.4-mysql php7.4-readline
php7.4-opcache php7.4-mbstring php7.4-gd php7.4-curl php7.4-pspell php7.4-zip php7.4-xmlrpc php7.4-tidy php7.4-sqlite3
php7.4-imap php7.4-cli php7.4-fpm php7.4-cgi php7.4-cgi-dbgsym libapache2-mod-php7.4

Creation of database.

The database for nuBuilder Forte can be created from the command line or with phpMyAdmin if installed together with LAMP server.

Please note that phpMyAdmin is included in the nuBuilder package and will be available from it after full installation and commissioning of nuBuilder.


Example (Name of database: TestDB)

In case of mysql command line the database can be created as following:

First, open the mysql command line from the system terminal with:

mysql -u root -pYourRootPsw

Next, the DB and user can be created as follows:

create database TestDB;
create user 'globeadmin'@'%' identified by 'nuB4psw';
grant all privileges on TestDB.* to 'globeadmin'@'%';

Downloading nuBuilder Forte

Download the nuBuilder Forte zipped files from SourceForge: https://sourceforge.net/projects/nubuilder/

wget https://sourceforge.net/projects/nubuilder/files/latest/download -O nubuilder.zip

Unpack the downloaded file

unzip nubuilder.zip -d TestDB

The folder TestDB must be placed in the Apache2 folder to be accessible externally. Typically it will be:

/var/www/html/TestDB

nuBuilder configuration

Edit nuconfig.php (nano editor can be used or any other)

nano /var/www/html/TestDB/nuconfig.php

For simplicity the same name and password both for DB and nuBuilder accounts were used here - but different ones can be used as well.

There are more settings possibilities in nuconfig.php but for the beginning the following ones are sufficient to set-up:

$nuConfigDBName                     = "TestDB";
$nuConfigDBUser                     = "globeadmin";
$nuConfigDBPassword                 = "nuB4psw";
$nuConfigDBGlobeadminUsername       = "globeadmin";
$nuConfigDBGlobeadminPassword       = "nuB4psw";
$nuConfigTitle                      = "TestDB - nuBuilder";

Launch of nuBuilder

After the configuration you can login to nuBuilder with link to the folder on your http server.

But of course you need to use your own server address.

http://192.168.1.10/TestDB/index.php

when the login window appears enter the nuBuilder user and password:

User: globeadmin
Password: nuB4psw

All the required tables will be created automatically. So no need to import manually the initial nubuilder4.sql to MariaDB - (anyway manual import is as well allowed).

Additional system settings

Allow nuBuilder and phpMyadmin to access their temp folders.

chown -R www-data:www-data /var/www/html/TestDB

cd /var/www/html/TestDB
chmod 400 nuconfig.php