Академический Документы
Профессиональный Документы
Культура Документы
Windows
Revised: 11/21/2013
Table of Contents
About this Guide ......................................................................................................................................... 1
Customer Support ....................................................................................................................................... 2
Supported Platforms ................................................................................................................................... 3
Application Server Setup ........................................................................................................................... 5
Installing Java SE Development Kit (JDK) 1.6.x ....................................................................................... 6
Setting the Environment Variable on the Application Server .................................................................... 7
Installing JBoss Application Server 5.1.X ................................................................................................ 9
Edit JBoss Setting in order to Append to Existing Logs ............................................................................ 9
JBoss Web Server Port ............................................................................................................................. 9
Additional JBoss Configurations ............................................................................................................ 11
Disable Chunking .................................................................................................................................... 11
Bypass the Proxy Server ......................................................................................................................... 12
Downloading the Application................................................................................................................... 13
Installation Instructions ............................................................................................................................ 14
Create Your AutoTime 7 Database ......................................................................................................... 14
Backup Your Import and Export Files ...................................................................................................... 14
Check Your Log Files .............................................................................................................................. 14
Stop the Application Server ..................................................................................................................... 14
Un-Install the AutoTime7Server Service ................................................................................................. 14
Windows 2008: Turn Off User Account Control ...................................................................................... 15
Installing the Application ......................................................................................................................... 17
Installing the Database Schema .............................................................................................................. 30
Installation Errors ..................................................................................................................................... 35
Run the Stored Procedure Scripts for Oracle EBS ................................................................................ 36
License File ................................................................................................................................................ 37
Installing the License File ........................................................................................................................ 37
Purchasing Licenses ............................................................................................................................... 38
iii
iv
CUSTOMER SUPPORT
For customer support you can reach us at:
Main/International: 954-416-1720
Voicemail messages always page someone (24 hours per day/seven days per week/365 days per year).
If all of the Service Representatives are busy, you will be asked to leave your name, your company's
name, and your telephone number. A Service Representative will return your call.
For non-critical issues, you can e-mail us at support.us@kaba.com.
Please have the following information available before contacting Kaba Workforce Solutions Support:
Version of Product
If possible, provide more information such as screen snapshots, Customer Issues Report, exact steps
leading to the issue, log files, file attachments, etc.
SUPPORTED PLATFORMS
Operating System
Version
Database Version
Operating System
Version
Application Server
Version
-or-
-or-
Operating System
Version
Windows XP
-orWindows 7
Browser Supported
You must check whether the java program is present in your PATH variable.
Run the statement set java_home. This command will display the
java_home location. If the wrong version of Java displays, please update the
Java path on the application server to reflect Java version 1.6.x.
If you do not
have Java 1.6.x
installed.
7. In the Variable value field, enter the path of the JDK you installed. For example: C:\Program
Files\Java\jdk1.6.0_26.
8. Click OK.
9. In the System variables section, scroll down and highlight Path.
10. Click Edit.
11. Ensure that the correct version of Java displays in the Java path listed in the Variable value field.
If no Java path exists, please enter the Java home directory as the first directory in the Variable
value field. In the example above, jdk1.6.0_26 is used. The Java directory is C:\Program Files
\Java\jdk1.6.0_26\bin.
12. Click OK.
13. Click OK to exit Environment Variables.
14. Click OK to exit System Properties.
15. If you made any changes to the Environment Variables settings, restart the application server.
The letter "x" in 5.1.x refers to any number in the 5.1 series. For example, 5.1.0.
To install JBoss Application Server, you need an unzip tool. You can download a free, crossplatform unzip tool, available at the following URL: http://www.7-zip.org/
To install JBoss:
1. Download JBoss Application Server from the following URL:
http://labs.jboss.com/jbossas/downloads. For example, jboss-5.1.0.GA-jdk6.zip.
2. Extract the contents to a location of your choice.
Note: The JBoss home folder is referred to as <JBOSS_HOME> in the rest of this document.
"<appender name="FILE"
class="org.jboss.logging.appender.DailyRollingFileAppender">"
4. Within that section find the following text:
10
DISABLE CHUNKING
This section contains instructions on how to disable chunking in JBoss. This section is not intended to
replace your existing JBoss documentation. It is a quick reference for system administrators who are
responsible for configuring the JBoss application server.
Follow the steps below to disable chunking:
1. Stop JBoss.
2. Navigate to the following directory:
<JBOSS_HOME>/server/default/deployers/jbossws.deployer/META-INF.
3. Select and edit the following xml file: standard-jaxws-client-config.xml.
11
12
13
INSTALLATION INSTRUCTIONS
Follow the instructions below if you are installing the application for the first time, or if you have already
installed the application at least once.
14
Installation Instructions
1. Make sure you stop the JBoss application server.
2. Navigate to the folder <application installation folder>\app\bin\windows\appserver\jboss.
Example: C:\Program Files\Kaba\AUTOTIME\app\bin\windows\appserver\jboss.
3. Run UninstallJBoss5Service.bat. This action will un-install the AutoTime7Server Service.
An alert message will appear asking if you want to continue with this action. Click Continue.
15
An alert message will appear telling you to restart your computer. You need to restart the computer
for this change to take effect.
4. Close the User Accounts control panel and restart the computer.
When you are done, proceed with the installation steps below.
16
17
4. Select the directory where you want to install the application. Click Select Folder to navigate to the
destination folder. You must single-click the folder to select it; do not double-click it.
5. Enter the name of the license file you are using. The license file determines which modules you
can activate in the application.
If you change the name of the license file, the new license name you enter will be saved in the
config.xml file.
You will install (on page 37) the license file in the /app directory when you are done installing the
application and database server.
6. Click Next to continue.
18
8. Check all the components you want to install and click Next.
Check the Deploy ERP Data Source box only if you are using an external ERP.
19
9. Enter the JBoss home directory. Click Select Folder to navigate to the folder where JBoss is
located. You must single-click the JBoss home folder to select it; do not double-click it.
10. Enter the Application Server Host name.
11. The Application Server Port refers to the port number used by your JBoss instance. You can
leave this setting at its default value (8080).
If your JBoss port is not set to the default value of 8080, you will need to change the Application
Server Port after you install the application. To do so, you will need to log into the application and
go to the Servers tab in the Application form (Main Menu > Configuration > System > Application >
Servers). Select the Host Name for your application server, click Modify, and change the Port as
necessary. For example, if your JBoss port number is 8180, change the Port to 8180. Refer to your
online help file for more information.
For information on modifying your JBoss port number (e.g., from 8080 to 8180), please refer to the
latest JBoss documentation, which is available at the following URL: http://labs.jboss.com/fileaccess/default/members/jbossweb/freezone/docs/latest/index.htm.
12. Leave the JBoss Service Name as AutoTime7Server.
13. The Java Options specify how much memory to allocate for Java. Do not change these settings
unless you are familiar with changing the memory allocation to the Java Virtual Machine.
Note: If you change the Java Options, the new values will be updated in the RunJBoss.bat file. The
installer also saves these values in a properties file located in the same folder as the installer.jar
file. If you run the installer again from the same folder (e.g., during an upgrade), the installer will use
the Java Options in this properties file as its default values.
14. Click Next.
20
15. Select your Database Type (SQL Server or Oracle) and click Next.
21
22
23
19. Confirm that all the database information you provided is correct and click Next.
If you checked the Deploy ERP Data Source box in the Application Components to Install Window
earlier, the ERP Database Type window appears. Skip to the next step: ERP DATABASE.
If you did not check the Deploy ERP Data Source box in the Application Components to Install
Window earlier, the Installation Progress window will appear instead of the ERP Database Type
window. Please skip to the Installation Progress (on page 28) steps to continue with the Installation
Progress.
24
25
26
27
25. Click Install to begin the installation. You can click Show Details to view the installation progress.
When the installation is complete, a message window will appear.
28
29
30
4. Select the directory where you want to install the Database Schema. Click Select Folder to
navigate to the destination folder. You must single-click the folder to select it; do not double-click it.
Note: The Database Schema directory does not have to be the same as the Application directory.
5. Click Next to continue.
The Database Components to install window appears.
6. Click Next.
31
32
11. Ensure that the information you provided is correct and click Next.
33
12. Click Install to begin the installation. You can click Show Details to view the installation progress.
When the installation is complete, a message window will appear.
34
INSTALLATION ERRORS
You can review the schema_install log for any errors. The file is located in <Schema Installation
Directory>\db\bin. The Schema Installation Directory is the location you chose in the Install Options step.
If you have an Oracle schema, ignore the following errors in the log:
ORA-02293: cannot validate - check constraint violated
ORA-02443: Cannot drop constraint - nonexistent constraint
If you receive errors such as ORA-00942: table or view does not exist, check your Oracle clients to make
sure they meet the minimum system requirements; see Supported Platforms (on page 3) for information.
If the application server from which you are running the installer is not using a supported Oracle client, the
database schema will not install correctly.
If there are any other errors, please call Customer Support:
US Toll Free: 866-635-2122
Main/International: 954-416-1720
The installation is now complete. However, you will not be able to use the application until you install the
license file. The license file enables the applicable modules within the application. See License File (on
page 37) for more information.
You will also need to install and run the AutoTime7Server Service (on page 39).
35
36
LICENSE FILE
In order to use the application you must install a license file. The license file activates and authorizes you
to use the modules you purchased with the application. If you do not install the license file, a violation
notice will appear when you attempt to log in to the system. The violation notice will appear each time you
attempt to log in until the license file is installed.
Note: You will be able to view and use all the modules even though their licenses have expired, except
for when the Configuration license has expired. Once the Configuration license has expired, you will not
be able to use or view any forms when you attempt to log in.
You can change the license name when you install the application. The new license name you enter will
be saved in the config.xml file.
AutoTime will first look for the license name specified in the config.xml file. If this license cannot be found,
the application will look for license.xml or KabaLicense.xml.
37
PURCHASING LICENSES
To purchase licenses or discuss any licensing issues, please contact Kaba Customer Support at:
US Toll Free: 866-635-2122, ext. 300
Main/International: 954-416-1720, ext. 300
E-mail: support.us@kaba.com
38
AUTOTIME7SERVER SERVICE
Before you can run the application, you must install and run the AutoTime7Server Service.
Note: If you are using Windows Server 2008, you need to turn off User Account Control before you install
the AutoTime7Server Service. This setting should have been turned off before you installed the
application (on page 15).
1. Navigate to the folder <application installation folder>\app\bin\windows\appserver\jboss.
Example: C:\Program Files\Kaba\AUTOTIME\app\bin\windows\appserver\jboss.
2. Run InstallJBoss5Service.bat (see below). This installs the AutoTime7Server Service.
39
40
VIOLATION NOTICES
The application requires you to install a license file after installing the application. The license file
activates and authorizes you to use the modules you purchased with the application. If you do not install
the license file, a violation notice will appear when you attempt to log in. The violation notice will appear
each time you attempt to log in until the license file is installed.
Description
Violation Notice
Login Failed. License File is Missing
41
INDEX
B
License File ...................................................... 37
Backup Your Import and Export Files .............. 14
log files ....................................................... 14, 17
Bypass the Proxy Server (JBoss) .................... 11
C
Check Log Files ............................................... 14
chunking ........................................................... 11
support ............................................................... 2
I
Un-Install the AutoTime7Server Service ......... 14
Installation Errors ............................................. 30
43