Release: 1.8
This is a description how to set up myWMS LOS. For the other releases have a look to the installation instructions of that release.
$media.
Copy the content of the WildFly archive to the directory $media/wildfly8.2.0.Final
Below we will call it $wildfly. It is necessary to use that path, because it is referenced by the build-scripts.
Download and install the Eclipse programming IDE.
You will find it on www.eclipse.org.
The checked version is Eclipse Luna Service Release 1 'Eclipse IDE for Java EE Developers'
It is important that eclipse uses jdk-1.8 as default jdk. You can check this in eclipse by opening the preferences (Window->Preferences), then navigating to 'Java - Installed JREs'. If jdk1.8 is not listed here click Add, select Standard VM and click next. Now click directory, navigate to your jdk1.8 installation directory (default: C:\Program Files\Java\jdk1.8) and press 'Ok'. Now just check the box next to jdk-1.8 in 'Installed JREs'. |
Download and install the Netbeans programming IDE.
You will find it on www.netbeans.org
The recommended version is Netbeans 8.0.2. The Java SE Version is sufficient.
Again it is important that netbeans uses jdk-1.8 as default jdk. Enter this in installation process. If this is not done on installation, you can change it later on. To change the netbeans default jdk open 'netbeans installation directory/etc/netbeans.conf' and change 'netbeans_jdkhome' to point to your java jdk1.8 installation directory. You may not be able to save the changes made in 'netbeans.conf', in that case just copy 'netbeans.conf' to your desktop, make the needed changes and copy it back to 'netbeans installation directory/etc'. |
We have a set of configuration files to set up WildFly to handle myWMS.
$media/config/wildfly82/standalone/configuration/standalone.xml
to $wildfly/standalone/configuration
$media/config/wildfly82/ standalone/deployments
to $wildfly/standalone/deployments
Maybe it is necessary to use a different appropriate driver for your version of the databaseserver. $media
.($wildfly
). Use the default settings, but make sure that the JDK 1.8 Runtime JRE is selected for the execution runtime environment. -Xms128m -Xmx1024m -XX:PermSize=256m
'.$media/server.app/mywms.as
. It is important to choose 'Next', not 'Finish'. eclipse-out
. Press 'OK'.$media/server.app/mywms.as/lib
/. Choose all available jar files and press 'OK'. $media/server.app/mywms.as/cactus/WEBINF/ lib
and add all the jar files there.Now the project should be shown without any errors. Any warnings can be ignored.
• Project setup for 'los.location-ejb'.
a) Repeat all steps from Project setup for 'los.common-ejb', but choose 'los.locationejb'.
• Project setup for 'los.inventory-ejb'.
a) Repeat all steps from Project setup for 'los.common-ejb' for 'los.inventory-ejb'.
• Project setup for 'los.stocktaking-ejb'.
a) Repeat all steps from Project setup for 'los.common-ejb' for 'los.stocktaking-ejb'.
• Repeat project setup for 'los.mobile'.
a) Repeat all steps from Project setup for 'los.common-ejb' for 'los.mobile'.
• There is another module for customization. So repeat project setup for 'project-ejb'.
a) Repeat all steps from Project setup for 'los.common-ejb' for 'los.project-ejb'.
• To access build file $media/server.app/build.xml it is necessary to create a new
Project in Eclipse.
a) Choose 'File - New - Project'. In the project type selection wizard select
'General/Project'. It is important not to create a new 'Java Project'.
b) Name it 'LOS Reference Server App' and disable option 'Use default location'.
Browse to and select $media/server.app and press 'Finish'.
c) Open Ant view with 'Window - Show View - Ant'. Drag 'build.xml' from newly
created project into the 'Ant'-view.
d) Run target 'components.build', 'ear.package' and 'jboss.deploy'. This will build all
LOS server modules and deploy them to WildFly. Maybe you have to grant
JavaVM access to the internet.
• Create a new plain project, not a java-project, like the step before and name it 'LOS
Reference DB'.
a) Disable 'Use default location' and browse to $media/database/postgres and
check 'OK', then 'Finish'.
b) For advanced user: Maybe you want to check connection.properties to configure
another database.
c) Drag 'build.xml' from the newly created project into the 'Ant'-view.
d) Run 'postgres.local.createSchema'.
e) Run 'postgres.local.init'.
f) Start the server ('Window - Show View - Other - Server - Servers', right click in
'Server'-view on the 'WildFly 8.x at localhost [Stopped]' and select 'Start').
--- Now all LOS Server Modules are available to you.
• Point a web browser to 'http://localhost:8080/los-mobile'.
• Now you should be able to login with 'admin', 'admin'.
Setup Client (Netbeans)
• If you wish to work with workspaces in Netbeans too, you have to do a little workaround,
because Netbeans is not aware of workspaces.
• Start Netbeans with parameter userdir
$media/workspace
• Choose 'File / Open Project' and browse to $media/rich.client/los.clientsuite.
• You will get a project called 'LinogistiX LOS Client'. To see the content of the suite
expand 'LinogistiX LOS Client / Modules'.
• Open context menu on the project and choose 'Clean and Build'.
• There is another netbeans suite available called 'LOS Reference Client'
This is a reference implementation of the basic 'LinogistiX LOS Client'. To start this
application, you first have to create a netbeans platform based on the 'LinogistiX LOS
Client' and then you can build and start the reference-implementation.
• Open the context menu on the project 'Linogistix LOS Client'.
• Select 'Package as | ZIP Distribution'.
• Choose 'File / Open Project' and browse to
$media/rich.client/los.reference.
• You will get a project called 'LOS Reference Client'.
• Open the context menu on the project 'LOS Reference Client'. And choose
'Properties'.
• Navigate to the Libraries category and select 'Manage Platforms...'
• Choose 'Add Platform...'
• Navigate to
$media/rich.client/los.clientsuite/nbplatform/linogistix_clientsuite
and Choose 'Finish'.
• Now you are able to select the NetBeans Platform 'Linogistix LOS Client'
• Make sure that all platform modules are included!
• Finish this step with 'OK'.
• Open the context menu on the project 'LOS Reference Client'. Choose 'Run'. On
start up a login dialog is displayed and you should be able to log in with 'admin',
'admin'