Skip to main content Help Control Panel

Login   A+   A-

Documentation «   Yacs handbook «   Software installation and upgrade «  

How to start the Setup Assistant?

Posted by Bernard on Jul. 8 2004, page edited by Bernard on Dec. 18 2007, (popular)  
Rate this page

Once you have pushed script files at your web site, you can trigger YACS to enter the setup process.

The setup script works like an on-line assistant, with several successive panels. This may induce more panels than necessary, but it also helps to make things clearer.

In your preferred browser go to the home page of the new site. YACS detects that configuration files are missing, and suggests you to switch to the Setup Assistant.

setup-01.gif

You can also go directly to the setup assistant, usually at the address http://yourserver/yacs/setup.php.

The setup assistant welcomes you and explains that several steps will be necessary to complete the setup.

The setup assistant is launchedThe setup assistant is launched

Configure main parameters

Indicate the main running parameters for your site, including database parameters. You will use other configuration panels afterwards for security (intranet vs. Internet).

If the installation directory is not at the root of the web site, you may have to modify the default 'URL to root' parameter in the configuration panel. For example, if the prefix of your site is http://www.foo.bar/~fancy, you will have to replace the default value /yacs/ with /~fancy/yacs/.

The main configuration panelThe main configuration panel

The setup assistant displays the content of the configuration file for review. Simply enough, this configuration file is a straightforward PHP script. If the Setup Assistant complains about the database, you will have to hit the back button and adjust parameters accordingly.

Note that a MySQL database should have been created prior the installation. YACS can create tables and populate them, but it cannot create the database itself.

The main configuration file is displayed for reviewThe main configuration file is displayed for review

Integrate software extensions

YACS can be extended through hooks. Because some of these hooks can be involved during the setup of the database they have to be identified as early as possible.

YACS will look for software extensionsYACS will look for software extensions

The setup assistant displays the list of hooks that have been found in the file system.

Software extensions are listedSoftware extensions are listed

Create tables

The setup assistant detects that some tables are missing from the database.

The database has no tableThe database has no table

New tables are created and listed automatically.

YACS lists new tablesYACS lists new tables

Populate tables

The setup assistant detects that the database is empty.

Tables are emptyTables are empty

YACS asks for data for the first account created. YACS also creates sections, categories, sample articles, etc.

YACS puts sample data in the databaseYACS puts sample data in the database

Configure rendering

The setup assistant detects that no rendering parameters have been set yet.

No rendering parameters at the momentNo rendering parameters at the moment

Indicate meta information (that will appear in the <head> part of generated pages) and configure the layout of the home page.

setup-12.gif

The setup assistant let you review the configuration file for rendering parameters.

YACS lets you review the configuration file for skinsYACS lets you review the configuration file for skins

What do you want to do now?

The setup assistant informs you that the most important parameters have been set, and offers several options to move forward.

setup-14.gif