Bellow you can find all the steps needed to be done in order to build thr CService (X) WebPage using Ubuntu linux server 22.04.1 and PHP 8.1 version.
Please keep in mind that the IP Address of the machine used for this HOWTO is 192.168.1.122 and it should be changed with the IP address of the machine where you want to have the webpage installed.
OK, now let`s proceed....
1. First we ensure that we have everything installed :
php8.1, apache2 Server, Postgresql, composer
- apt install build-essential
- apt install net-tools
- apt install software-properties-common
- apt install apache2 apache2-bin apache2-data apache2-dev apache2-doc apache2-ssl-dev apache2-utils libapache2-mod-php php php-cgi php-cli php-common php-gd php-pgsql php-curl php-dev php-json php-readline php-mysql php-xml php-xmlrpc php-sqlite3 git flex bison libreadline-dev libssl-dev mlocate openssl zlib1g zlib1g-dev
- updatedb
- Open pico /etc/php/8.1/apache2/php.ini file and change value "short_open_tag = Off" in "short_open_tag = On"
- curl -sS https://getcomposer.org/installer | php && mv composer.phar /usr/local/bin/composer
3. Install Postgresql 15.2: - Skip this step if you already have PGSQL SETUP and RUNNING.
- wget https://coder-com.universalnet.org/packages/postgresql-15.2.tar.gz
- tar zxvf postgresql-15.2.tar.gz
- cd postgresql-15.2
- ./configure
- make
- make install
- mkdir /usr/local/pgsql/data
- adduser gnuworld
- chown gnuworld /usr/local/pgsql/data/
- su - gnuworld
- /usr/local/pgsql/bin/initdb -A trust -E=SQL_ASCII /usr/local/pgsql/data/
- pico /usr/local/pgsql/data/pg_hba.conf
### Add the following line:
- host all all X_machine_ip_here/32 trust
- host all all WebSite_machine_ip_here/32 trust
### Save the file and exit.
Now start postgresql Server...
- /usr/local/pgsql/bin/postmaster -B 64 -N 32 -i -D /usr/local/pgsql/data -F -h 192.168.1.122 >/dev/null 2>&1 &
##replace "192.168.1.122" with the ip address that pgsql will run !!
4 .We get the webpage source code from UniversalNet Official GitHub under user gnuworld:
- su - gnuworld
- git clone https://github.com/UndernetIRC/cservice-web
- cd cservice-web/
- composer install
- cd php_includes/
- cp config.inc.dist config.inc
- cp cmaster.inc.dist cmaster.inc
#replace all containing "localhost" with IP of the currrent running PGSQL server.
- cp blackhole.inc.dist blackhole.inc
5. Now to create the live shortcut for the webpage as root:
- cd /var/www/html/
- chmod 711 ~gnuworld
- chmod 711 ~gnuworld/cservice-web
- chmod 755 ~gnuworld/cservice-web/php_includes
- chmod 644 ~gnuworld/cservice-web/php_includes/config.inc
- chmod 755 ~gnuworld/cservice-web/docs/gnuworld/
- ln -s /home/gnuworld/cservice-web/docs/gnuworld live
6. TThere are two options to solve (IPR) restriction, bellow you can find how to on both.
- su - gnuworld
6.1 - Fix (IPR) by inserting your ip into Admin account direct on database cservice.
- pico ipr.sql
- insert into ip_restrict (id, user_id, added_by, added, type, expiry, value) values (1, 1, 1, now()::abstime::int4, 1, 0, ‘192.168.1.122’);
- /usr/local/pgsql/bin/psql -h 192.168.1.122 cservice < ipr.sql
6.2 - Fix (IPR) by disableing IPR option in config.inc file
- su - gnuworld
- cd gnuworld
- pico cservice_web/php_includes/config.inc
- change define("IPR_REQUIRED",1); to define("IPR_REQUIRED",0);
Save the file and close
7 In order to permit login on CService Web from local IP address like 192.168.xx.xx or 10.0.0.xx the following changes must be made:
nano /home/gnuworld/cservice-web/php_includes/config.inc
# Replace define("DISALLOW_RESERVED_BLOCKS",1); to define("DISALLOW_RESERVED_BLOCKS",0);
Now login using * accounts from local IP address is possible.
This HOWTO was last updated by ZioN
07 Feb 2023