Installing and

configuring
ATOM

Wrench Solutions (P) Limited

Copyright Wrench Solutions (P) Limited

 Contents
1. Pre-requisites ........................................................................................................................................................ 3
2. Configuring the main server ........................................................................................................................... 3
2.1 Executing CustomReport.XML query .................................................................................................... 3
3. Installing ATOM in main server ...................................................................................................................... 5
3.2 Converting the folders to web service ................................................................................................. 5
3.4 Changing application pool ....................................................................................................................... 6
3.5 Copying files to WrenchService folder ................................................................................................. 6
3.6 Defining impersonation settings ............................................................................................................ 7
3.7 Granting security permissions ................................................................................................................. 7
3.8 Browsing and copying the URL ............................................................................................................... 8
3.9 Creating ATOM client URL ..................................................................................................................... 10
1. Pre-requisites

Netframework 4.5 is mandatory in server machine.

2. Configuring the main server

The procedure to carry out the basic configuration in the main server, required for installing ATOM is

explained in this section.

NOTE: In case the customreport.xml is provided with the setup folder, before starting the installation

you have to execute the CustomReport XML. Or else you can ignore Section 2.1.

2.1 Executing CustomReport.XML query

To execute the query

1. From the server folder (C:\inetpub\wwwroot\WrenchENTService) in your main server

system select ServerConfig.exe and right click.

2. In the right click menu select Run as Administrator.

Wrench ENT server configuration manager window is displayed.

3. In the Server Configuration Manager window, select Report Configuration.

Upgrading ATOM 3
Figure: Server Configuration Manager window

Report Configuration window is displayed.

Figure: Report Configuration window

4. In the Report Configuration window select Browse to choose the xml CustomReport.XML.

5. After selecting the xml select Execute to run the queries.

Upgrading ATOM 4
3. Installing ATOM in main server

The following procedures have to be carried out for installing atom in the main server.

3.2 Converting the folders to web service

Remove the existing ATOM server folders 'WrenchService' and 'WrenchWeb' from the server

machine if ATOM is already installed.

The latest setup folders 'WrenchService' and 'WrenchWeb' has to be converted to web service. Copy
the latest folders in to C:\inetpub\wwwroot.

To convert folder WrenchService

1. Open Internet Information Services (IIS) Manager.

2. Select the WrenchService folder and right-click.

3. In the right-click menu click Convert to Application.

To convert folder WrenchWeb

1. In the Internet Information Service Manager (IIS), select the folder WrenchWeb and right-
click.

Upgrading ATOM 5
 2. In the right-click menu select Convert to Application.

3.4 Changing application pool

The settings for the application pool have to be changed for both Web server service and Application

server service.

To change the application pool for application server service

1. Open the Internet Information Services (IIS) Manager, select WrenchService.

2. In the right-click menu select Manage Applications>>Advanced Settings.

3. In the Advanced Settings window select the Application Pool values as ASP.NET v4.5.

To change the application pool for web server service

1. Open the Internet Information Services (IIS) Manager, select WrenchWeb.

2. In the right-click menu select Manage Applications>>Advanced Settings.

3. In the Advanced Settings window select the Application Pool as ASP.NET v4.5.

Once this step is completed next step is to copy epcsysconfig and license files to WrenchService
folder.

3.5 Copying files to WrenchService folder

The config and license files are located in the ENT server folder of the main server.

To copy files

1. Select the files EPCSysConfig.xml and WrenchLicense.LIC from the ENT server folder in the
main server.

Upgrading ATOM 6
 2. Copy the files to Wrench service folder, WrenchService.

If the ATOM server machine is different from ENTERPRISE server then provide a new

WrenchLicense.LIC file with same licenses as ENT against the ATOM server machine mac ID. Paste

the new License file in the Wrench application service folder, WrenchService.

3.6 Defining impersonation settings

Once copying of files is completed set, impersonation for ‘WrenchService’ web service same as in

WRENCH Enterprise service, if the vault is not present in the application server.

3.7 Granting security permissions

In both Web Service folder and Application service folder full access rights have to be assigned for the

following users:

 IUSR

 IIS_IUSR

 NETWORK SERVICE

 IMPERSONATION USER (If applicable)

To grant full access permission

1. Select the respective folder in the server and right-click.

2. In the right-click menu select Properties.

Upgrading ATOM 7
 3. In the Properties window select Security tab.

4. Select the users and grant them Full Access permission.

3.8 Browsing and copying the URL

The URL of AtomSVC.svc has to be browsed; the URL is then copied and pasted in WrenchWeb folder.

To browse the URL for web server service

1. Open the Internet Information Services (IIS) Manager.

2. Select the web server service folder (WrenchService).

3. Click Content View.

4. Select the file AtomSVC.svc and right-click.

5. In the right-click menu click Browse.

Upgrading ATOM 8
 6. Browser is opened. Select the URL displayed in the browser and copy.

7. Open IIS. Select the WrenchWeb service and explore. Select the file web.config and right-

click.

Upgrading ATOM 9
 8. In the right-click menu, click Open With>>Notepad. The file is opened in notepad.

9. In the opened note pad search for http://localhost/WrenchService/SVC/AtomSVC.svc.

10. Search all matches using CTRL+H and replace them with the ‘AtomSVC’ URL that was

browsed and copied from ATOM web service.

11. After replacing the matches save the notepad file.

3.9 Creating ATOM client URL

Finally URL of ATOM client can be created and this is provided to users to start working with ATOM.

To browse ATOM client URL

Upgrading ATOM 10
 1. Open the Internet Information Services (IIS) Manager.

2. Click Content View.

3. Select WrenchWeb service and right-click.

4. In the right-click menu click Browse.

Browser is opened.

5. In the URL replace 'localhost' with server machine IP (Public IP).

The final URL with server machine IP can be distributed among users to access ATOM client.

Upgrading ATOM 11