Addoro for Axapta 2009

Transcription

1 Addoro for Axapta 2009 Installation and Configuration Overview of Addoro for Axapta 2009 Addoro for Axapta 2009 consists of two Windows Service applications that Addoro customers installs on their local network. Addoro Local Print enables printing of documents created in the Addoro online service to local printers behind the firewall. Addoro Local Print service will automatically log on to the Addoro online service and check for files that should be printed. For each files it finds it will download both the file (as a PDF) and the name of the printer that should be used. The Local Print Service will then print the PDF file on the specified printer. Addoro Local Upload takes files produced by the Axapta system and uploads them to Addoro. There is a graphical configuration tool provided that is used to configure the applications. For Local Print the configuration tool is used to specify which local printers that should be made available for printing from Addoro. The Local Print service will read the information about available printers and connect to the Addoro online service and register which printers that can be selected. (Usage of the Addoro online service is not covered in this document) Installation Prerequisites If Addoro Local Print is used then the applications should be installed on a server from which it is possible to print to all the printers that should be exposed to Addoro. The Windows service must also be run by a user that has access to all the printers, I.e. can print to them from a Windows print dialog. Both the setup program and the application are Java based programs and they need a 32 bit Java version 6 to be installed. Java must be available for both the user that runs the setup and the user that is running the Windows service. After that Java has been installed the JAVA_HOME environment variable should be set to point to the Java installation directory, eg JAVA_HOME=C:\Program Files\Java\jre6. The PATH environment variable should be updated to include the bin directory of the Java installation. If Java is installed in the standard directory then the following should be added to the end of the PATH variable ;C:\Program Files\Java\jre6\bin

2 Installation 1. Launch the setup by double clicking on it from a Windows Explorer. Note that the setup must be run by an Administrator. On on Windows 2008 Server, Windows 7 or Windows 8 it is not enough to belong to the Administrator group. The Run as administrator feature must also be used. To ensure that you have Administrator right do the following: 1. Open a Command line prompt using Run as Administrator. 2. Use cd (change directory) command to change directory to the directory here the setup can be found, 3. Run the following command java jar <name_of_setup>.jar 2. Read the licence agreement and select accept if you accept it an press next. 3. Select the directory to install the application in and then press next.

3 4. Next all files will be installed and the services will be created. This may take a minute or two. Once the progress bar has reached 100%, press Next. 5. Select the name of the program group in the Windows start menu where the configuration tool

4 will be placed. The setup will suggest Addoro which is recommended in most cases. When the group has been selected press next. 7. The setup shows an information screen telling you that the setup is done. Press Done. That s it. Addoro Local Print and Addoro Local Upload are now installed. Before it can be used it must be configured using the configuration tool. See section Configuration below. If any errors

5 were displayed during the installation please visit the troubleshooting section. Configuration Overview Configuration is done using the Addoro Axapta 2009 Configuration tool. The configuration tool can be launched from Windows start menu. The standard location in the start menu is under the program group Addoro and is called Addoro Axapta 2009 configuration The configuration tool consists of three tabs: Local Printers. This tab is used to configure the printers that should be used for printing from Addoro. Local Upload. This tab is used to configure the Local Upload application Account. Here the Addoro user and password can be changed. In the bottom of the tool there are a Save button and an Exit button that is used to save the changes and to exit the tool. Account Settings On the account settings tab the user and password that the service uses to connect to Addoro can be changed. The Environment control is used to select if the local print server should connect to Addoro s test or production environment. The verify button can be used to check that it is possible to connect with the current parameters. The apply button will apply the new credentials. It will connect to the Addoro server and download the existing logical printers for that account.

6 Local Upload configuration On the Local Upload tab, the folder that contains files that should be sent to Addoro should be specified. This should be the same folder where Axapta is placing XML files that should be sent to Addoro. If Enabled upload copy is checked then the Local Upload application will copy all files to the upload copy folder after the files has been sent to Addoro. Days to keep copy specifies the number of days that the copied files should be kept before they are deleted. Local Printers configuration

7 The local printers tab consists of a list of printers that should be exposed in the Addoro UI. Every printer has a logical name, physical name, Printer Tray and description. Logical name is the name that will be displayed in the Addoro user interface. E.g. Invoice Printer Physical name is the name of the printer on the local machine that the local service is running at. Printer Tray is the tray on the local printer that will be used when printing. Description is a human readable description of the printer that will be displayed together with the logical name in the Addoro online user interface. E.g. Printer in the reception. The Add, Edit and Delete buttons are used to manage the printers. The Add and Edit button will bring up the Edit Printer dialog. The margin can be used to adjust the print margins on each printer. Use this dialog to map all logical printers to a physical printer. Change Location

8 The location concept is used to setup multiple local print installations when the installations use the same Addoro account, but does not share physical printers. If you are only going to use one local print server then you can leave this setting to it s default value. To separate multiple installations each local print installations can be given a unique location, e.g. Stockholm and London. Each printer is is then dentified by the location and the logical name together. This means that there can be one printer in London and one in Stockholm with the same name, e.g. Invoice Printer. In the Addoro web user interface the printers are displayed with location and logical name, so when the distribution configuration is done it can be seen which printers that are in London and which is in Stockholm. When the local print server downloads print jobs it will only download the jobs that matches it s location. Saving The Configuration Saving the configuration is done using the Save button. After that the configuration has been saved the Local Print Service will directly start using the new settings Troubleshooting If the service does not start or any other unexpected behaviour is detected then start by investigating the log files. The log files are normally located in C:\Program Files (x86)\addoro\3l\1.0\log. Look in the most recently updated log file for error messages. When contacting Addoro support always send the log files to support@addoro.com. For some of the problems described below the settings of the Windows service needs to be changed. To find the service, open the Service Control Manager (Control Panel\System and Security\Administrative Tools) and locate the service named Addoro 3L Local Print. Choose properties on the service and go to the logon tab where you will find the options. The setup fails This is almost always caused by the that the user that runs the setup does not have Administrator rights. Most often this happen on Windows 2008 Server, Windows 7 or Windows 8. On these versione the Run As Administrator command must be used. To ensure that you have Administrator right do the following: 4. Open a Command line prompt using Run as Administrator. 5. Use cd (change directory) command to change directory to the directory here the setup can be found, 6. Run the following command java jar <name_of_setup>.jar The Service does not start Check that the user that runs the service has Java available. The directory where

9 java.exe is located should be included in the PATH environment variable. The JAVA_HOME environment variable should be set to point to the Java installation directory. As default the service is set to use the system account. If the service does not start test to change the the user to a regular user, e.g. the use that ran the setup. There is a known bug that connection fails if the password contains characters that need to be url encoded, e.g. %. Test to change the password to a password that only contains letters and digits. Nothing is printed Check that the user that runs the service has access to the printers. Often a regular user is used to run the configuration tool and the system user runs the service. If the regular user has access to the printers and not the system user, then it is possible to add the printers in the tool, but the service will not find the printers. Printing to a printer that stores the document to disk instead of sending to a printer fails. The allow service to interact with desktop must be selected on the service since the service will try to open a dialog where the file name can be specified. The Configuration Tool does not start The cause of this is most often that Java is not installed for the user that tries to start the Configuration Tool. To test this try to start the configuration tool from a command prompt. If Java is not installed an error message like this is displayed 'java' is not recognized as an internal or external command, operable program or batch file.. To start the configuration tool from a command line prompt first open a command prompt. It is normally found in Windows start menu All Programs Accessories Command prompt. Then try to start the Configuration Tool by typing C:\Program Files (x86)\addoro\3l\1.0\smock_localservice_ui.bat <enter>. To resolve this issue use another user or enable Java for the current user. Advanced Configuration Tanuki Service Wrapper The Addoro Local Print service is a Java application. To make a Java application run as a service on windows a framework called Tanuki Service wrapper is used. The Tanuki framework has a lot of features that can be manually enabled. Among other things it provides monitoring of the service, notifications when problems occur, automatic restart if the Java application crashes. For more information see

10 The Tanuki configuration file is called localprint_winwrapper.properties and can be found in C:\Program Files (x86)\addoro\3l\1.0\resources\wrapper. Addoro uses version of Tanuki Service wrapper. Log4J The Local Print server uses a logging framework called log4j. Log4J can be configured by changing its configuration file. The file is called log4j.properties and is located in C:\Program Files (x86)\addoro\3l\1.0\resources\localprint. In the configuration file the log level can be changed, log messages can be filtered out, sending of error log messages to an address can be added etc. For a full list of Log4Js capabilities see Addoro is currently using Log4J version