Workarounds & APIs Guide
General API

You will need to install first and then configure the Appeon File Server. For installing the file server to IIS, Appeon provides a setup.exe file at %IIS_Web_Root%\appeon\plugin\fileservice.

Step 1: Double click the setup.exe file to start the setup.

If the "Installation Incomplete" error displays, please try the solution in the the section called “Appeon File Server Installation Incomplete” in Appeon Troubleshooting Guide.

Figure 1. Appeon File Service Setup Wizard

Step 2: Click the Next button and then the following window pops up. Select a Web site where the Appeon File Server will be installed.

Note that DO NOT change the name of Virtual directory otherwise Appeon File Server will fail to start.

Figure 2. Select Installation Address

Step 3: Click Next until the installation is complete.

Step 4: Go to directory where the Appeon File Server is installed, for example (C:\inetpub\wwwroot\fileservice).

Figure 3. Appeon File Server directory

Step 5: Select Properties from the right-click menu of the fileservice folder.

Step 6: In the Security tab page of the fileservice Properties window,

For IIS 6.0, grant the IIS_WPG user with Full Control permission to this folder.

Figure 4. Grant Full Control (IIS6)

For IIS 7.0 or above, grant the IIS_IUSRS user with Full Control permission to this folder.

Figure 5. Grant Full Control (IIS7)

Uninstall Appeon File Server

Step 1: Go to Start | Control Panel | Add and Remove Programs.

Step 2: Select Appeon File Server and click Remove button.

After deploying the Appeon File Server, follow steps below to configure it.

Open the appeonfileserver.xml in C:\Inetpub\wwwroot\fileservice.

<?xml version="1.0" encoding="UTF-8"?>
<webserver>
<!-- The value of attribute "value" must begin with either a single or double quote character. -->
 <file-path value="D:\appeon\upload" />
 <log-level value="3" />          <!--0 Error,1 Info,2 Func, 3 Debug-->
 <session-timeout value="3600" /> <!-- the unit is second  -->
 <allowed-file-types value="txt;doc;jpg;mpeg" ignorecase="true" />
 <max-file-size value="20" />     <!-- the unit is M --> 
 <users>
  <user name="test" password="password" />
  <user name="userA" password="userA" />
  <user name="userB" password="userB" />
 </users>
</webserver>

Modify the file according to your own demands.

You will need to configure first and then deploy the Appeon File Server. Follow steps below to configure the Appeon File Server:

Step 1: On the machine where the Appeon File Server will be deployed, create an XML file wherever you like and name it whatever you wish. In this example, create an XML file named "appeonfileserver.xml" under D:\appeon\config directory.

Step 2: Copy the following code to the XML file.

<?xml version="1.0" encoding="UTF-8"?>
<fileserver>
 <file-path value="D:\appeon" />
 <session-timeout value="3600" />
 <allowed-file-types value="txt;doc;jpg;mpeg" ignorecase="true" />
 <max-file-size value="20" />
 <users>
  <user name="userA" password="userA" />
  <user name="userB" password="userB" />
 </users>
</fileserver>

Step 3: Modify the settings in the XML file if necessary.

Step 4: On the machine where the Appeon Server is installed, unzip the fileservice.war (%AppeonServer%\plugin\fileservice) and find the web.xml file under the WEB-INF folder. Then open web.xml with a text editor. Replace the bold text with the name and directory of the XML file created in the previous steps.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC '-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN' 
'http://java.sun.com/dtd/web-app_2_3.dtd'>
<web-app>

<servlet>
 <servlet-name>fileservice</servlet-name>
 <servlet-class>com.appeon.fileserver.WebServiceDispatcher</servlet-class>
 <init-param>
  <param-name>config</param-name>
  <param-value>D:\appeon\config\appeonfileserver.xml</param-value>
 </init-param>
 <load-on-startup>1</load-on-startup>
</servlet>
<servlet>
 <servlet-name>uploadfile</servlet-name>
 <servlet-class>com.appeon.fileserver.UploadFile</servlet-class>
 <init-param>
  <param-name>config</param-name>
  <param-value>D:\appeon\config\appeonfileserver.xml</param-value>
 </init-param>
 <load-on-startup>1</load-on-startup>
</servlet>

<servlet-mapping>
 <servlet-name>fileservice</servlet-name>
 <url-pattern>/fileservice</url-pattern>
</servlet-mapping>

</web-app>

Step 5: Save the file and re-compress the fileservice folder to fileservice.war using WinZip, WinRAR or JDK. Do not use the other compression tools such as 7-zip.

Then follow the next section Deploying the Appeon File Server to deploy fileservice.war.

After configuring the Appeon File Server, follow steps below to deploy it:

Step 1: On the machine where Appeon Server is installed, access the WebLogic Server Administration Console in a Web browser.

Step 2: Click the Deployment link.

Figure 6. 

Step 3: Click the Install button and select the fileservice.war file at %AppeonServer%\plugin\fileservice.

Figure 7. 

Step 4: Click the Next button to use the default settings and then click the Finish button to finish the deployment of Appeon File Server.

Configuring the Appeon File Server in the Java server such as WebLogic, WebSphere, JBoss, JEUS, NetWeaver etc. is the same. Please refer to Configuring the Appeon File Server for WebLogic.

After configuring the Appeon File Server, follow steps below to deploy it:

Step 1: On the machine where Appeon Server is installed, access the WebSphere Administrative Console in a Web browser.

Step 2: Select Applications | Install New Applications from the left tree view. And then in the right page specify the path where the fileservice.war is (by default at %AppeonServer%\plugin\fileservice) and Context Root for the WAR file and click the Next button.

Figure 8. 

Step 3: Click Next with default settings until the file server is successfully installed on the WebSphere server.

Configuring the Appeon File Server in the Java server such as WebLogic, WebSphere, JBoss, JEUS, NetWeaver etc. is the same. Please refer to Configuring the Appeon File Server for WebLogic.

After configuring the Appeon File Server, follow steps below to deploy it. There are two methods to deploy the Appeon File Server in JBoss:

Configuring the Appeon File Server in the Java server such as WebLogic, WebSphere, JBoss, JEUS, NetWeaver etc. is the same. Please refer to Configuring the Appeon File Server for WebLogic.

After configuring the Appeon File Server, follow steps below to deploy it:

Copy the fileservice.war file to the directory %JEUS installation root directory%\webhome\autodeploy and then start JEUS server. The fileservice.war file will be deployed automatically.

Configuring the Appeon File Server in the Java server such as WebLogic, WebSphere, JBoss, JEUS, NetWeaver etc. is the same. Please refer to Configuring the Appeon File Server for WebLogic.

After configuring the Appeon File Server, follow steps below to deploy it:

Step 1: Open SAP Sybase Management Console, click Web Applications and select Deploy from the Actions list box and click the Go button.

Figure 11. 

Step 2: Click Browse to choose the fileservice.war file and then click Next.

Figure 12. 

Step 3: Choose Use Default Module Name and click Next to continue the deployment.

Figure 13. 

Step 4: Click the Finish button to complete the deployment of Appeon File Server.

Configuring the Appeon File Server in the Java server such as WebLogic, WebSphere, JBoss, JEUS, NetWeaver etc. is the same. Please refer to Configuring the Appeon File Server for WebLogic.

After configuring the Appeon File Server, follow steps below to deploy it:

Step 1: Open the deployment perspective in the SAP NetWeaver Developer Studio by clicking the menu Window | Open Perspective | Other and then selecting deployment in the pop-up window. The deployment perspective is shown as below.

Step 2: Click the Import button to import the fileservice.war file and then click Start to deploy the Appeon File Server after the file is imported successfully.

Figure 14. 

AppeonFileService object provides the following functions to upload and download files:

long ll_re
string info

ll_re = fileservice.of_logonfileserver ("192.168.168.52", 80, "username=userA;password=userA") 

if ll_re = 0 then
 info = "Logon to file server is successful."
elseif  ll_re = 1 then
 info = "Failed to connect to the file server."
else
 info = "Failed to connect to the file server."
end if

Messagebox( "ll_re="+string(ll_re),info)

long ll_re
string info

ll_re = fileservice.of_logofffileserver ( ) 

if ll_re = 0 then
 info = "Logoff file server is successful."
elseif  ll_re = 1 then
 info = "Failed to log off file server."
else
 info = "The session has timed out or the user has not logged off the file server."
end if
 
Messagebox( "ll_re="+string(ll_re),info)

long ll_re
string info,ls_url

ls_url = fileservice.of_appeonupload ("C:\temp\1.pdf", "pdf_files", true, ll_re) 

if ll_re = 0 then
 info = "Upload is successful."
elseif  ll_re = 1 then
 info = "Failed to upload the file."
else
 info = "Other errors."
end if

Messagebox("ll_re="+string(ll_re),info+"~r~nurl="+ls_url)

long ll_re
string info

ll_re = fileservice.of_appeondownload ("pdf_files\1.pdf", "C:\") 

if ll_re = 0 then
 info = "Download is successful."
else
 info = "Other errors."
end if

Messagebox ("ll_re="+string(ll_re),info)

string ls_file

ls_file = "~"C:\Program Files\Internet Explorer\iexplore.exe~" C:\1.pdf"
Messagebox("",ls_file)
run(ls_file)

long ll_re
string info

ll_re = fileservice.of_fileexists ("pdf_files\1.pdf") 

if ll_re =1 then
 info = "The file exists."
elseif ll_re =0 then
 info = "The file does not exist on the file server."
else 
 info = "Other errors."
end if

Messagebox( "ll_re="+string(ll_re),info)

AppeonFileService object provides the following properties (private instances) to upload and download files: