Each Axional Studio server will run on a Java VM 8 and it will load its configuration from a JAXB XML file, that describes it's boot configuration. After the startup, the server will load the configuration metadata from the central database dictionary, commonly known as wic_conf.

The following steps show how to setup the Axional Studio with an appropriate boot configuration.

1 Setup tool

The setup tool is a command line console that extends the Axional Server console to add Axional Studio specific commands. This commands are oriented to allow a "cold" server setup and they include:

  • update configuration file parameters
  • check the system status by verifying the connection to the primary database server
  • check the license status
  • create and upgrade the wic_conf database

To run the setup tool type:

Copy 
$ bin/studio.sh --setup
Axional Server Console (C) 1996, 2017 deister software
Connected to titan.local, 192.168.10.100

....

The commands in the setup tool are:

Command Feature Element in config.xml JDBC required
Basic commands (from server core)
help Show commands usage  
quit Exit console  
ansi Toggle ansi display  
debug Toggle debug  
history Show commands history  
version Show manifests artifacts of current product  
hardware Show the hardware information  
diskfree Show the file system disk free  
java Shows the java VM information  
mail Show / configure / use mail server/mail  
nexus Show / configure / user nexus server/nexus  
license Show / configure / axional licenses server/license  
config.xml setup
jdbc Shows / updates the jdbc configuration server/application/jdbc  
wic_conf database setup
status Shows the system connection status.  
init Performs a full initialization of the wic_conf database by creating tables, loading data, creating indexes and procedure compilation  
create Create database tables, indexes or procedures.  
drop Drop database indexes or procedures.  
load Load database table data for system styles or labels.  
insert Insert database objects like server, database, database user, group or user.  
update Update database objects like server, database, database user, group or user.  
sql Enter the SQL command mode. Commands end with ; character  

2 Setup bootstrap configuration database

If you have loaded both wic and wic_admin dictionary databases, you can setup the bootstrap url on application server to point to the boostrap server.

Required databases

If the required databases have not been installed, please go to this document before continue.

2.1 Create config.xml

Running the setup tool will generate a default config.xml file if it does not exists

Copy 
$ bin/studio.sh --setup
Axional Server Console (C) 1996, 2016 deister software
Connected to titan.local, 192.168.10.100
+-----------------------+----------------------------------+--------+
 Configuration status
+-----------------------+----------------------------------+--------+
|key                    |value                             |state   |
+-----------------------+----------------------------------+--------+
|Config                 |/home/axs/studio/conf/config.xml  |OK      |
|Temp                   |/home/axs/studio/tmp/axional-19866|OK      |
|JDBC protocol          |jdbc:informix-sqli                |OK      |
|JDBC host              |unknown                           |OK      |
|JDBC port              |0                                 |NO      |
|JDBC service           |unknown                           |OK      |
|JDBC username          |informix                          |OK      |
|JDBC password          |[changeit]                        |Not safe|
|Dict wic database      |wic                               |FAILED  |
|Dict wic_admin database|wic_admin                         |FAILED  |
|Configuration database |wic_conf                          |FAILED  |
|Configuration tables   |0 of 0 tables                     |FAILED  |
|Configuration user     |manager                           |FAILED  |
+-----------------------+----------------------------------+--------+
Review config.xml boot section
Press ? for help
setup $>

The first time the setup is executed the configuration file is created and shows the next state errors:

key value state
JDBC password [changeit] Not safe
Dict wic database wic FAILED
Dict wic_admin database wic_admin FAILED
Configuration database wic_conf FAILED
Configuration tables 0 of 0 tables FAILED
Configuration user manager FAILED

In order to configure the correct data for your database server follow the next steps:

  1. The password to connect to the database server (informix as default user):
    Copy 
    jdbc set password the_password
    as for example jdbc set password infpass
  2. The IP or DNSName of database server:
    Copy 
    jdbc set host the_server_ip_or_dnsname
    as for example jdbc set host 192.168.1.99
  3. The informix service dbservername:
    Copy 
    jdbc set service the_dbservername
    as for example jdbc set service ol_dbserver1
  4. The informix service port to the connect to the referended dbservername:
    Copy 
    jdbc set port the_port
    as for example jdbc set port 9088

Check the new status

Copy 
setup $> status
+-----------------------+-----------------------------------------------------------------------------------------+------+
 Configuration status
+-----------------------+-----------------------------------------------------------------------------------------+------+
|key                    |value                                                                                    |state |
+-----------------------+-----------------------------------------------------------------------------------------+------+
|Config                 |/home/axs/studio/conf/config.xml                                                         |OK    |
|Temp                   |/home/axs/studio/tmp/axional-19866                                                       |OK    |
|JDBC protocol          |jdbc:informix-sqli                                                                       |OK    |
|JDBC host              |pmahou                                                                                   |OK    |
|JDBC port              |9,088                                                                                    |OK    |
|JDBC service           |ol_pmahou                                                                                |OK    |
|JDBC username          |informix                                                                                 |OK    |
|JDBC password          |CRYPT-AES256:IJFb35SUp6iJy5Nomy/7nnIeBs4jNLZ/zQ9Nzd8VYggqzKA1jq+a7fYWkpRX5zSFfHiFYo30Elnb|OK    |
|Dict wic database      |wic                                                                                      |FAILED|
|Dict wic_admin database|wic_admin                                                                                |FAILED|
|Configuration database |wic_conf                                                                                 |FAILED|
|Configuration tables   |0 of 0 tables                                                                            |FAILED|
|Configuration user     |manager                                                                                  |FAILED|
+-----------------------+-----------------------------------------------------------------------------------------+------+

After the configuration of parameters to connect to the database server you must close the current setup session and executes again:

Copy 
Ctrl+C [to close the current execution]
bin/studio.sh --setup

Now the new status shows that the connections to the database wic and wic_admin are correctly stablished:

Copy 
+-----------------------+-----------------------------------------------------------------------------------------+------+
 Configuration status
+-----------------------+-----------------------------------------------------------------------------------------+------+
|key                    |value                                                                                    |state |
+-----------------------+-----------------------------------------------------------------------------------------+------+
|Config                 |/home/axs/studio/conf/config.xml                                                         |OK    |
|Temp                   |/home/axs/studio/tmp/axional-24096                                                       |OK    |
|JDBC protocol          |jdbc:informix-sqli                                                                       |OK    |
|JDBC host              |pmahou                                                                                   |OK    |
|JDBC port              |9,088                                                                                    |OK    |
|JDBC service           |ol_pmahou                                                                                |OK    |
|JDBC username          |informix                                                                                 |OK    |
|JDBC password          |CRYPT-AES256:IJFb35SUp6iJy5Nomy/7nnIeBs4jNLZ/zQ9Nzd8VYggqzKA1jq+a7fYWkpRX5zSFfHiFYo30Elnb|OK    |
|Dict wic database      |wic                                                                                      |OK    |
|Dict wic_admin database|wic_admin                                                                                |OK    |
|Configuration database |wic_conf                                                                                 |FAILED|
|Configuration tables   |0 of 0 tables                                                                            |FAILED|
|Configuration user     |manager                                                                                  |FAILED|
+-----------------------+-----------------------------------------------------------------------------------------+------+

2.2 Create configuration database (wic_conf)

In order to create the configuration database you can use one of the following methods:

  • Option A: init command: running this command the system creates the database, creates tables, loads the configuration data, creates indexes and compile procedures and triggers in sequence.
  • Option B: step by step process: step by step process or something that needs to be revised executing each command separately.

Recommended mode

We recommended the execution of init command to make more easy the creaction of wic_conf database. You can use the individual commands to check or recreate shomething that failed in the init command.

2.2.1 Option A: init

You can use the init command to run all set of initialization commands in sequence. The init command executes the create database, create tables, load data, create indexes and create procedures commands in sequence.

Copy 
setup $> init
Creating DDL TABLE

Creating DDL TLOAD
....

2.2.2 Option B: step by step process

Option B: If you prefer a step by step process or something that needs to be revised, use the following commands to create a configuration database.

If you have not created configuration database manually, you can do it by simply typing:

Copy 
setup > create database
Database wic_conf created

On first installation, you need to create the initial tables. Use the command create tables to deploy the wic_admin schema into configuration database.

Copy 
setup $> create tables
+-----+--------+---------+------+---------+------------------------------+-----+-------+------------------------------------------------------------------------+------+
 Create TABLE
+-----+--------+---------+------+---------+------------------------------+-----+-------+------------------------------------------------------------------------+------+
|seqno|database|server   |schema|dict     |table_name                    |group|status |message                                                                 |source|
+-----+--------+---------+------+---------+------------------------------+-----+-------+------------------------------------------------------------------------+------+
|    1|wic_conf|bootstrap|      |wic_admin|web_os_lbldata                |1/1  |SUCCEED|TABLE web_os_lbldata created.                                           |n/a   |
|    2|wic_conf|bootstrap|      |wic_admin|web_os_lbldata                |1/1  |SUCCEED|TABLE web_os_lbldata altered, operation is LOCK MODE ROW                |n/a   |
|    3|wic_conf|bootstrap|      |wic_admin|wic_cal_invitation            |1/1  |SUCCEED|TABLE wic_cal_invitation created.                                       |n/a   |
|    4|wic_conf|bootstrap|      |wic_admin|wic_cal_invitation            |1/1  |SUCCEED|TABLE wic_cal_invitation altered, operation is LOCK MODE ROW            |n/a   |
|    5|wic_conf|bootstrap|      |wic_admin|wic_cal_sched_inv             |1/1  |SUCCEED|TABLE wic_cal_sched_inv created.                                        |n/a   |
...            

Operation completed, 360 TABLE(s) created

Now you are ready to load basic data information like OS labels, available roles, application CSS style sheets, etc.

Copy 
setup $> load
Operation completed with 0 error(s)

After data is loaded, you must create indexes and foreign keys.

Copy 
setup $> create indexes
+-----+--------+---------+------+---------+----------------------------+-----+-------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+------+
 Create INDEX
+-----+--------+---------+------+---------+----------------------------+-----+-------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+------+
|seqno|database|server   |schema|dict     |table_name                  |group|status |message                                                                                                                                                       |source|
+-----+--------+---------+------+---------+----------------------------+-----+-------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+------+
|    1|wic_conf|bootstrap|      |wic_admin|wic_certificates            |1/1  |SUCCEED|UNIQUE INDEX i_wic_certificates1 created.                                                                                                                     |n/a   |
|    2|wic_conf|bootstrap|      |wic_admin|wic_customer                |1/1  |SUCCEED|UNIQUE INDEX i_wic_customer2 created.                                                                                                                         |n/a   |
|    3|wic_conf|bootstrap|      |wic_admin|wic_dbms_homeurls           |1/1  |SUCCEED|UNIQUE INDEX u_wic_dbms_homeurls created.                                                                                                                     |n/a   |
|    4|wic_conf|bootstrap|      |wic_admin|wic_dbms_pakgstamp          |1/1  |SUCCEED|UNIQUE INDEX u_wic_dbms_pakgstamp created.                                                                                                                    |n/a   |
|    5|wic_conf|bootstrap|      |wic_admin|wic_dbms_passwords          |1/1  |SUCCEED|UNIQUE INDEX i_wic_dbms_passwords created.                                                                                                                    |n/a   |
|    6|wic_conf|bootstrap|      |wic_admin|wic_dbms_procstamp          |1/1  |SUCCEED|UNIQUE INDEX u_wic_dbms_procstamp created.                                                                                                                    |n/a   |
...

Operation completed with 737 INDEX created(s)

The schema needs some business logic in form of stored procedures and triggers. The create procedures command will create all schema business logic.

Copy 
setup $> create procedures

3 Verify configuration status

The command status can be used to verify the DDL & SPL status of configuration database.

Copy 
setup $> status database

For an individual check of DDL or SPL you can run:

  • status tables - to check DDL table status
  • status checks - to check DDL table checks status
  • status indexes - to check DDL indexes status
  • status procedures - to check SPL compilation status

4 Other database settings

In order to start the server some other action should be taken on the DB.

4.1 Change the database-logging mode

The database wic_conf must be in unbuffered logging mode. On the database server use this command to change the logging mode of the database:

Copy 
ontape -s -U wic_conf -t /dev/null
In a system where there is database replication the database cannot be passed to transactional, so it should be created directly with transactions.

4.2 Set the connection timeout

The connections to the bootstrap DB ( wic_conf) should be started with a non-null timeout time. Otherwise lock errors will happen when different users try to access to the same DB information. This setting can be changed using the tag initSQL in the jdbc section of the configuration file.

Copy 
...
    <initSQL>SET LOCK MODE TO WAIT 5</initSQL>
...