Difference between revisions of "HelloWhiznium"

From
Jump to: navigation, search
(Created page with "Building HelloWhiznium Running HelloWhiznium for the first time Copy the preferences file from ... to ... . If you would like to use HTTPS server, you need to create a pri...")
 
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
Building HelloWhiznium
 
Building HelloWhiznium
  
 +
<pre>
 +
cd ${WHIZROOT[_CCH]}/srcrep/hwzd
 +
 +
cd _rls/ezdevhwzd_<machine>
 +
./checkout.sh
 +
 +
cd [${SYSROOT}]${WHIZROOT}/src/ezdevhwzd
 +
./makeall.sh
 +
</pre>
 +
 +
<pre>
 +
cd ${WHIZROOT[_CCH]}/srcrep/hlwz
 +
 +
cd _rls/dbshlwz_<machine>
 +
./checkout.sh
 +
cd ../hlwzcmbd_<machine>
 +
./checkout.sh
 +
cd ../webapphlwz_<machine>
 +
./checkout.sh
 +
 +
cd [${SYSROOT}]${WHIZROOT}/src/dbshlwz
 +
./makeall.sh
 +
cd ../hlwzcmbd
 +
./make.sh all
 +
</pre>
 +
 +
Generate acv/hlwz and tmp/hlwz directories
  
 
Running HelloWhiznium for the first time
 
Running HelloWhiznium for the first time
  
−
Copy the preferences file from ... to ... .
+
The executable directory for the HelloWhiznium combined engine Hlwzcmbd is ${WHIZROOT}/bin/hlwzcmbd.
 +
 
 +
Copy the preferences file PrefHlwzcmbd.xml from ${WHIZROOT[_CCH]}/srcrep/hlzw/_ini/hlwzcmbd_<machine> to the executable directory.
 +
 
 +
Perform some required customizations:
 +
 
 +
<pre>
 +
<StgHlwzAppsrv>
 +
    <Si sref="port"> application server port of choice, e.g. 13100 </Si>
 +
    <Si sref="https"> true if you would like to use secure communication (see below) </Si>
 +
</StgHlwzAppsrv>
 +
<StgHlwzcmbd>
 +
    <Si sref="jobprcn"> number of job processor threads, should be at least 2 and otherwise match the number of cores </Si>
 +
    ...
 +
</StgHlwzcmbd>
 +
</pre>
 +
 
 +
<StgHlwzDatabase><br>
 +
:<Si sref="srefIxDbsVDbstype">my</Si><br>
 +
:...<br>
 +
:<Si sref="dbsname">DbsHlwz</Si><br>
 +
:<Si sref="username">mpsitech</Si><br>
 +
:<Si sref="password">asdf1234</Si><br>
 +
:<Si sref="ip">127.0.0.1</Si><br>
 +
:<Si sref="port">3306</Si><br>
 +
</StgHlwzDatabase><br>
 +
 
 +
- or -
 +
 
 +
<StgHlwzDatabase><br>
 +
:<Si sref="srefIxDbsVDbstype">lite</Si><br>
 +
:<Si sref="dbspath">$WHIZROOT/bin/hlwzcmbd/DbsHlwz.sql</Si><br>
 +
:...<br>
 +
</StgHlwzDatabase><br>
 +
 
 +
 
 +
<StgHlwzPath><br>
 +
:<Si sref="acvpath"> $WHIZROOT/acv/hlwz </Si><br>
 +
:...<br>
 +
:<Si sref="tmppath"> $WHIZROOT/tmp/hlwz </Si><br>
 +
:<Si sref="webpath"> $WHIZROOT/web/apphlwz </Si><br>
 +
:...<br>
 +
</StgHlwzPath><br>
 +
 
 +
 
 +
If you would like to use HTTPS for the application server, you need to create a private/public key pair, e.g. using OpenSSL. In the executable directory, run:
 +
 
 +
openssl genrsa -out server.key 4096
 +
openssl req -days 365 -out server.pem -new -x509 -key server.key
 +
 
 +
Set up the database:
 +
 
 +
MySQL database
 +
 
 +
sudo mysql -p < ${WHIZROOT}/srcrep/hlwz/_ini/dbshlwz/CreateDbsHlwzMy.sql
 +
 
 +
The two 'CREATE USER ...' lines need to be commented out in case the user already exists.
 +
 
 +
SQLite database
 +
 
 +
In the executable directory, run
 +
 
 +
sqlite3 DbsHlwz.sql<br>
 +
sqlite3> .read ${WHIZROOT}/srcrep/hlwz/_ini/dbshlwz/CreateDbsHlwzLite.sql<br>
 +
sqlite3> .quit<br>
 +
 
 +
As within sqlite3 the shell variable ${WHIZROOT} is unknown, you'll need to expand it manually.
 +
 
 +
If you are in a cross-compile environment (machines apalis and arty), you need to secure-copy a number of files to the target machine. Exemplary commands on the host machine read:
 +
 
 +
cd ${WHIZROOT}
 +
export set IP=192.168.2.26
 +
scp -r bin/hlwzcmbd root@${IP}:whiznium/bin
 +
scp -r acv/hlwz root@${IP}:whiznium/acv
 +
scp -r tmp/hlwz root@${IP}:whiznium/tmp
 +
scp -r web/apphlwz root@${IP}:whiznium/web
 +
 
 +
Run HelloWhiznium for the first time and populate:
  
−
If you would like to use HTTPS server, you need to create a private/public key pair, e.g. using OpenSSL. In the executable directory, run
+
Hlwzcmbd >> clearAll
  
 +
Use Chrome/Safari and go to https://127.0.0.1:13100, log in as 'temp'/'asdf1234'
  
−
and rename the generated files
+
Load initialization data.
  
−
mv ... server.pem
+
${WHIZROOT[_CCH]}/srcrep/hlwz/_ini/hlwzcmbd/IexHlwzIni.xml
−
mv ... server.key
 
  
−
Set up the database
+
From now you can log in as 'hlwzuser'/'asdf1234' or 'hlwzuserdech'/'asdf1234'.

Latest revision as of 11:58, 25 August 2019

Building HelloWhiznium 

cd ${WHIZROOT[_CCH]}/srcrep/hwzd

cd _rls/ezdevhwzd_<machine>
./checkout.sh

cd [${SYSROOT}]${WHIZROOT}/src/ezdevhwzd
./makeall.sh

cd ${WHIZROOT[_CCH]}/srcrep/hlwz

cd _rls/dbshlwz_<machine>
./checkout.sh
cd ../hlwzcmbd_<machine>
./checkout.sh
cd ../webapphlwz_<machine>
./checkout.sh

cd [${SYSROOT}]${WHIZROOT}/src/dbshlwz
./makeall.sh
cd ../hlwzcmbd
./make.sh all

Generate acv/hlwz and tmp/hlwz directories

Running HelloWhiznium for the first time

The executable directory for the HelloWhiznium combined engine Hlwzcmbd is ${WHIZROOT}/bin/hlwzcmbd.

Copy the preferences file PrefHlwzcmbd.xml from ${WHIZROOT[_CCH]}/srcrep/hlzw/_ini/hlwzcmbd_<machine> to the executable directory.

Perform some required customizations: 

<StgHlwzAppsrv>
    <Si sref="port"> application server port of choice, e.g. 13100 </Si>
    <Si sref="https"> true if you would like to use secure communication (see below) </Si>
</StgHlwzAppsrv>
<StgHlwzcmbd>
    <Si sref="jobprcn"> number of job processor threads, should be at least 2 and otherwise match the number of cores </Si>
    ...
</StgHlwzcmbd>

<StgHlwzDatabase>

<Si sref="srefIxDbsVDbstype">my</Si>
...
<Si sref="dbsname">DbsHlwz</Si>
<Si sref="username">mpsitech</Si>
<Si sref="password">asdf1234</Si>
<Si sref="ip">127.0.0.1</Si>
<Si sref="port">3306</Si>

</StgHlwzDatabase>

- or -

<StgHlwzDatabase>

<Si sref="srefIxDbsVDbstype">lite</Si>
<Si sref="dbspath">$WHIZROOT/bin/hlwzcmbd/DbsHlwz.sql</Si>
...

</StgHlwzDatabase>


<StgHlwzPath>

<Si sref="acvpath"> $WHIZROOT/acv/hlwz </Si>
...
<Si sref="tmppath"> $WHIZROOT/tmp/hlwz </Si>
<Si sref="webpath"> $WHIZROOT/web/apphlwz </Si>
...

</StgHlwzPath>


If you would like to use HTTPS for the application server, you need to create a private/public key pair, e.g. using OpenSSL. In the executable directory, run:

openssl genrsa -out server.key 4096 openssl req -days 365 -out server.pem -new -x509 -key server.key

Set up the database:

MySQL database

sudo mysql -p < ${WHIZROOT}/srcrep/hlwz/_ini/dbshlwz/CreateDbsHlwzMy.sql

The two 'CREATE USER ...' lines need to be commented out in case the user already exists.

SQLite database

In the executable directory, run

sqlite3 DbsHlwz.sql
sqlite3> .read ${WHIZROOT}/srcrep/hlwz/_ini/dbshlwz/CreateDbsHlwzLite.sql
sqlite3> .quit

As within sqlite3 the shell variable ${WHIZROOT} is unknown, you'll need to expand it manually.

If you are in a cross-compile environment (machines apalis and arty), you need to secure-copy a number of files to the target machine. Exemplary commands on the host machine read:

cd ${WHIZROOT} export set IP=192.168.2.26 scp -r bin/hlwzcmbd root@${IP}:whiznium/bin scp -r acv/hlwz root@${IP}:whiznium/acv scp -r tmp/hlwz root@${IP}:whiznium/tmp scp -r web/apphlwz root@${IP}:whiznium/web

Run HelloWhiznium for the first time and populate:

Hlwzcmbd >> clearAll

Use Chrome/Safari and go to https://127.0.0.1:13100, log in as 'temp'/'asdf1234'

Load initialization data.

${WHIZROOT[_CCH]}/srcrep/hlwz/_ini/hlwzcmbd/IexHlwzIni.xml

From now you can log in as 'hlwzuser'/'asdf1234' or 'hlwzuserdech'/'asdf1234'.

Retrieved from "http://sbewiki.mpsitech.com/index.php?title=HelloWhiznium&oldid=36"