Trail ~ FAQ_
Trail ~ FAQ
How to find an answer to my question
How do I configure my hybris Suite?
How to configure the [Link] property
How to configure your Database to use a non-default Database
How to configure available extensions
Where do I find further configuration topics
Project xxx is missing required source folder: gensrc
Do I have Java installed and how to install if not
How to install eclipse
How to Debug from Eclipse
How to initialize / update hybris
How to initialize the test tenant
How to create an extension
Ant initialize
How to update Eclipse to use Ant 1.8.2
What are the main Ant targets?
How to find an answer to my question
Browse this FAQ
To get started read Trail ~ Preparation_
If you do not find the answer you are looking for here, please email trail@[Link]. We will add
your question and an answer to this page.
Navigation
Previous Step | Home
How do I configure my hybris Suite?
By modifying your config/[Link] and config/[Link] files. You should never change the factory default global configuration files, but
these local files instead.
See for example "How to configure the [Link] property", "How to configure your Database" and "How to configure available extensions" below.
How to configure the [Link] property
Should you have multiple cores on your machine, you can tell hybris to utilise these by building in parallel.
1. Open the config/[Link] file.
2. Add the following entry:
config/[Link]
[Link]=true
3. Save the [Link] file.
4. Rebuild hybris by invoking (double-clicking) the Ant all task from within Eclipse.
5. Notice how during a build, all the cores on your machine will now be under load.
How to configure your Database to use a non-default Database
hybris comes bundled with hSQL which is not recommended for production environments. If you want to configure a different database use the steps
below which use MySQL as an example.
1. Make sure that there is an installation of MySQL available for you to use.
2. Add the following entries to your config/[Link] file and save.
config/[Link]
[Link]=jdbc:mysql://localhost/<dbname>?useConfigs=maxPerformance&characterEncoding=utf8
[Link]=[Link]
[Link]=<username>
[Link]=<password>
3. Rebuild hybris by invoking (double-clicking) the Ant all task from within Eclipse.
4. Start the hybris Server.
5. Check whether the start-up log now mentions mysql:
INFO [hybrisserver]
INFO [hybrisserver] *****************************************************************
INFO [hybrisserver]
INFO [hybrisserver] Starting up hybris server
INFO [hybrisserver]
INFO [hybrisserver] Configuration:
INFO [hybrisserver]
INFO [hybrisserver] Cluster: disabled
INFO [hybrisserver] Tenant: master
INFO [hybrisserver] OS: Windows 7 6.1, x86
INFO [hybrisserver] Database: Pool: JNDI=null - mysql, table prefix:
INFO [hybrisserver] <username>@localhost - jdbc:mysql://localhost/<dbname> <-----------
INFO [hybrisserver] Platform: 4.2.1
INFO [hybrisserver] Java: Sun Microsystems Inc.
INFO [hybrisserver] Java(TM) SE Runtime Environment, 1.6.0_14-b08
INFO [hybrisserver] C:/Program Files (x86)/Java/jdk1.6.0_14/jre
INFO [hybrisserver] VM Locale: language=en,country=US,region=
INFO [hybrisserver] Cache: 20000 entries.
INFO [hybrisserver] Server type: tomcat
INFO [hybrisserver]
INFO [hybrisserver] *****************************************************************
6. Note that if switching to a new database, the system will need to be initialized. See pm:Initializing.
How to configure available extensions
To specify which extension to include in a build you should modify the file config/[Link].
1. Each extension is represented with an extension tag
2. Note how most of these are commented out by default.
3. You can uncomment those extensions you would like to include, or if one of your own, add an extension tag describing it. See for example the
entry for Cuppy <extension dir= HYBRIS_BIN_DIR / custom/cuppy"/>
4. Note that hybris extensions reside in <YOURPATH>/bin/ext-hybris and partner's extensions should reside in <YOURPATH>/bin/custom
5. Should you uncomment any of the extensions, you will need to download them from the download page and import them into Eclipse.
Where do I find further configuration topics
See Configuring the Behavior of the hybris Suite
Project xxx is missing required source folder: gensrc
Ensure the extension xxx is included in config/[Link]
Run the Ant all task to generate the files for all active extensions
Ensure that in Eclipse the option Project|Build Automatically is checked
Select all top-level projects in the Package Explorer, right-click and select refresh
Eclipse will now start to build your project and find the missing gensrc folder.
Do I have Java installed and how to install if not
Open a command line and type java -version
You should see information about your installed Java version
If you do not have Java installed follow the steps Installing Java
How to install eclipse
Read Trail ~ Preparation_
How to Debug from Eclipse
Read Trail ~ Preparation_
How to initialize / update hybris
1. With hybris running, open [Link]
2. If prompted for credentials, enter admin as user account name and nimda as password.
3. Click on the Init / Update tab.
4. Select the option you need - Initialize new hybris Suite or Update running hybris Suite.
5. Alternatively, you can run the initialize and updatesystem Ant targets from within Eclipse or from the command line. Note that when using
HSQLDB as your database, it is not possible to run the initialize or updatesystem Ant tasks while an instance of hybris is running.
How to initialize the test tenant
invoke the ant task yunitinit
How to create an extension
See Trail ~ New Extension_.
Ant initialize
The ant intialize task must be after making modifications to the Data Model by modifying the [Link] files
How to update Eclipse to use Ant 1.8.2
Take it from platform or download Ant 1.8.2 from [Link]
Unpack to <Your new Ant location>
Open Eclipse, select Window|Preferences and modify the AntHome variable to point to <Your new Ant location>
What are the main Ant targets?
Ant target Description
-p Lists all the Ant targets
all default target - perform complete build
build builds all extensions
clean cleans platform and all extensions
extgen generates a new extension
production create a production environment - zip files for hybris Server
server configures hybris Server and redeploys if running
udpatesystem updtaes the system
yunit runs all junit tests
yunitinit initializes the Junit Tenant