Configuring Mymicros & MyLabor For Simphony v2.x
Configuring Mymicros & MyLabor For Simphony v2.x
Simphony v2.x:
Software Engineer Note
Simphony v2.4 MyMicros And MyLabor Configuration Software Engineer Note
1. Before installation, ensure JDK 1.6(x86) is installed. You may run the following command on
command prompt to verify the version.
java -version
2. Further verify the PATH environmental variable is updated with JDKs bin. Navigate to
Computer => Properties =>Advanced System Settings => Advanced tab => Environment
Variables and scroll down the system variables to find the PATH variable.
Start => Microsoft SQL Server 2008 R2 => Configuration Tools => SQL Server Configuration
Manager
Enable TCP/IP protocol for MSSQLSERVER and also for other instances if available.
Also check whether your IP addresses are in Active mode. To do that, double click on TCP/IP
protocol for MSSQLSERVER and select “Yes” for available IP addresses as below.
Note: If you are getting the following error while loading SQL Server Configuration Manager,
Open the Command prompt as Admin and navigate to the C:\Program Files <x86>\Microsoft
SQL Server\100\Shared folder. Then run the following command
mofcomp sqlmgmproviderxpsp2up.mof
4. If “SQL Server Reporting Services” is running on your machine need to stop that service since
it is using port 80.
Run Services.msc in run command and find SQL Server Reporting Services if running, and
make startup type to “Manual” and stop the same.
IMPORTANT NOTES:
Splash Screen:
Introduction:
Click Next
Next
Next
Note – for all Password fields, use the same Password used for SQL server Login. (Eg -: S1mph0ny)
Next
Next
DBA Login sa
DBA Password S1mph0ny
Next
Pre-Installation Summary:
Install
Progress window:
Next
Next
Completion Screen:
Done
Splash Screen:
Introduction:
Next
Next
Next
Find the TNS Listener name (SID) from service, and put the SID / Service Name for every field asks
for “Database Service Name”. For this installation Database Service Name = simphony
Next
Next
Pre-Installation Summary:
Install
Next
Completion Screen:
Done
Download and Run the latest Install executable file from the FTP.
Splash Screen:
Introduction:
Next
(Eg -: C:\Micros\myMicros)
Next
Before we begin:
Would you like to install or upgrade a database with this installation for either
No
myMicros or iCare?
Will different features connect to the myMicros Database using different database
No
IP Addresses
Will iCare be used with this installation No
Will Simphony be used with this installation Yes
Will myinventory be used with this installation No
Will mylabor be used with this installation Yes
Will the weather service be used with this installation No
Next
Next
Next
Next
Next
Next
Next
Backup Location
Next
Database Information:
Note – for Password field, use the same Password used for SQL server Login. (Eg -: S1mph0ny)
Next
NOTE: When this screen first appears, it is necessary to first click on Oracle and then click on SQL
Server for the installation to work correctly!
Next
Database Installation
Next
Next
Next
Mail Server:
Next
Next
Next
Next
Mail Users:
Next
Next
Next
Next
Next
Next
Leave blank
Next
Leave blank
Next
Next
Next
Next
Next
Next
Next
Review
Next
Pre-Installation Summary:
Install
Installing myMicros:
Install Complete:
Done
Splash Screen:
Introduction
Next
Next
Before we begin
Next
Next
Next
Next
Next
Next
Backup location
Next
Database Information
Next
Next
Next
Next
Next
Next
Next
Next
Mail Users
Next
Next
Next
Next
Next
Next
Next
Datasource Name
Next
Next
Next
Next
Next
Review
Next
Pre-Installation Summary
Install
Installing myMicros:
Install Complete
Done
Right-Click Logins
New Login…
General Options
Login Name: simadmin
SQL Server Authentication Enable
Password: simadmin
Confirm Password: simadmin
Enforce Password Policy Disable
Server Roles
Sysadmin Enable
OK
It is necessary to add the Simphony Reports user (simadmin) to each of the mymicros database so
that the Simphony application will function correctly.
Right-Click Users
New User…
Login name: …
Check Names
OK
Default Schema: …
Check Names
OK
OK
CoreDB
Location_Activity_DB
PortalDB
Quartz
RTA
The following steps need to be taken to avoid port conflicts with the Simphony installation.
This task is handled by the Simphony installation application when the option to install Simphony
Reports (mymicros.net) is installed as a part of that process.
Edit…
OK
Close
Navigate to D:\Micros\mymicros\myPortal\server\defaul\conf
wrapper.java.additional.7=-Dhttp.webservice.port=8080
Save
Exit
Navigate to D:\Micros\myMicros\myPortal\server\default\deploy\portal.ear\pentaho.war\WEB-INF
Edit web.xml
<context-param>
<param-name> fully-qualified-server-url</param-name>
<param-value>http://www.mymicros.net/binextgen</param-value>
</context-param>
Save
Exit
NOTE: It might be necessary to repeat this process after the Simphony POS installation is complete.
Navigate to Services (Run services.msc) and make sure “SQL Server Reporting Services” service is
stopped.
or
Start
NOTE: Starting the service will create a java process that grows to over 800 MB. The mymicros
website will not show up until in the web browser until it is over the 800 MB threshold.
NOTE: Since the VM image takes so long to start up, it is recommended to change the Startup Type
for both the MICROS Portal and the MICROS Portal Info Delivery services to Manual.
If everything was successfully installed and configured, the following screen will be displayed:
NOTE: If the warning message “Intranet settings are now turned off by default…” is displayed, right
click on the message and choose the following option to make it go away: “Don’t Show This Message
Again”
2012 MICROS Systems, Inc. | Appendix A 108
Simphony v2.4 MyMicros And MyLabor Configuration Software Engineer Note
NOTE: If a message stating that the website cannot be found is displayed check the wrapper.log file,
located in the directory below, for errors. The most common error is the password for the ‘sa’ user
was incorrectly entered.
D:\Micros\mymicros\myPortal\server\default\log
I- EMC Part:
========================================================================================
CORED.CORE_USER
-------------------------------------------
Login for Sys Admin and Super Admin: Apply for both:
Most of the time I cannot log in with Sys Admin Credential because I don't know the password
So manually there is a workaround:
COREDB.CORE_USER
encryptedPassword: 8GjYUdUXfCVVBVjFD3i502wdfcg=
= mymicros27 once we log in we will change password
[COREDB].[CORE_ORGANIZATION]
-------------------------------------------
- For your Organization ID of the Enterprise:
,[enableEnterpriseLabor] = 1 (true)
,[externalAppUserName] = can be anything but unique among records
,[externalAppPassword] = can be anything but unique among records
[MCRSPOS].[HIERARCHY_PARAMETER]
-------------------------------------------
Configure for your property:
,[MyMicrosURL] = Your Server Name or PC Name
,[MyLaborURL] = null
,[MyLaborUser] = can be anything but unique among records
,[MyLaborPass] = can be anything but unique among records
CONFIGURE MYMICROS.NET
Sign into mymicros.net using the following credentials:
All of the fields in blue MUST be filled in. Put values into the fields and click the save button to commit the
changes. The New Password will be used by the Super Admin account which is used to log into the Top-most
organization within the enterprise.
Save the changes once all of the fields have been filled in.
If you have modified the EGateway Server port; then update the DirectPostingService.exe.config (located at
<<Install Media>>\Simphony2\DirectPostingService) file accordingly.
Sys Admin
Micros
<password>
Example:
Click Copy
There is now a new organization with a Sys Admin user – the password needs to be set
values
Log in to the portal as the Sys Admin user for the new organization
Password: as defined
Once you log in, select Contents from the upper right corner (under mymicros.net)
Change this to the name of the new organization with a reference level of 0
Edit TSR Regional – Change this to the short name of the new organization hyphen East (for example:
aaak) with Level Reference 1
For example:
Example:
Before
After
Highlight the TSR Restaurant and Make Inactive for this location
All locations for Simphony properties shall be created through EMC. Do not create a location in
this module.
Add > Enter the name of the reporting hierarchy – use the organization name.
For each of the level names, assign a parent level and select Assign Level
Once you complete the steps on the Simphony side, you will need to return to this step and use
Assign Location.
Run these SQL statements to clear out any existing location information. Make sure you take a back
up of your transaction database first.
UPDATE microsdb.NETVUPOINT_CONFIG
UPDATE microsdb.NETVUPOINT_CONFIG
Modify your DbSettings.xml – these two alias entries should point at the mymicros database:
<db
alias="LOCATION_ACTIVITY_DB"
dbType="sqlserver"
dataSource="DEV-SQL-RPTDB"
catalog="Location_Activity_Db"
uid="sa"
pwd="mymicros"
epwd="QAc77c020b000000001000000013c011f956056426add6fbd12bc5cdbc"
timeout="100" />
<db
alias="EMCREPORTING"
dbType="sqlserver"
dataSource="DEV-SQL-RPTDB"
catalog="Location_Activity_Db"
uid="sa"
pwd="mymicros"
epwd="YPc77c020b000000001000000061f7ce84a805aa053a342e3f3bfe3cd0"
timeout="100" />
Open the Enterprise Parameters module and select the mymicros.net tab
Change the mymicros.net Machine Name to the development portal server name
This is an example:
For example
It’s important that ‘Location Reference’ entries are unique for each Property on the system.
Additionally, these other restrictions also apply:
A good method:
Select the time zone that matches the Properties’ time zone
Enter the property name in lower case for both the Simphony labor logon and password. The logon
must be unique.
For example:
Click OK
This is the form view – note that the Report Location has been updated
Location Name drop down > change to the newly created location
For example:
Click Assign Location and you will be returned to the main screen – note the new entry for Location
If EMC Enterprise Parameter option bit 5 is enabled, you must complete the next step; otherwise
move to L
Click Add
Select the property you wish to be the Master from the location list
Check All
Check the LDS Active box for each RVC you wish to post definitions – Save
Uncheck and save – this should set all the move flags so DTS sends the definitions
[Save]
Admin (menu)
Portal (menu)
Organizational Structure
Locations
Cafe
Edit
Save
Cafe 2
Edit
Save
Sub Shop
Edit
Save
Cancel
Admin (menu)
Portal (menu)
Portal
Portlets
Add
Save
Add
Save
Add
Name: Schedule
Type: Portlet
URL: Scheduling - Schedule
Description: Schedule
myPage Title: Schedule
Options: << Leave Blank >>
Effective Dates: << Today’s Date >>
to: << Leave Blank >>
Save
Add
Name: Payroll
Type: Portlet
URL: Payroll Processing
Description: Payroll
myPage Title: Payroll
Options: << Leave Blank >>
Effective Dates: << Today’s Date >>
to: << Leave Blank >>
Save
Cancel
Roles
Side Menus
Sys Admin
Configure
Add
Save
Cancel
Cancel
Roles
Portlets
Sys Admin
Configure
Add
Save
Add
Save
Add
Portlet: Schedule
Side Menu: Labor
Sort Order: 3
Hide: << Off >>
Enable myPage: << Off >>
All Other Options: << ON >>
Save
Add
Portlet: Payroll
Side Menu: Labor
Sort Order: 4
Hide: << Off >>
Enable myPage: << Off >>
All Other Options: << ON >>
Save
Cancel
Cancel
Logout
Labor (menu)
Admin
Template Builder
Save
Save
Cancel
Admin
Template Assignment
Sys Admin
Save
Logout
Labor (menu)
Admin
Add
Name: Tipped
Save
Add
Name: Non-Tipped
Save
Labor (menu)
Admin
Job Category
Master
Add
Name: Waitstaff
Save
Add
Name: Kitchen
Save
Add
Name: Bar
Save
Add
Name: Cashier
Save
Labor (menu)
Admin
Job Definitions
Add
General Tab:
Type Tab:
Hourly: Enabled
Effective Date: Tomorrow
Overtime Level 1: Enabled
Default Regular Rate: << As Desired >>
Other Fields: << As Desired >>
Save
Add
General Tab:
Type Tab:
Hourly: Enabled
Effective Date: Tomorrow
Overtime Level 1: Enabled
Save
Add
General Tab:
Type Tab:
Hourly: Enabled
Effective Date: Tomorrow
Overtime Level 1: Enabled
Default Regular Rate: << As Desired >>
Other Fields: << As Desired >>
Save
Add
General Tab:
Type Tab:
Hourly: Enabled
Effective Date: Tomorrow
Overtime Level 1: Enabled
Default Regular Rate: << As Desired >>
Other Fields: << As Desired >>
Save
Labor (menu)
Admin
Job Definitions
Bartender
Assign to Locations
Café 1
Café 2
Effective From: Tomorrow
Overtime Level 1: Enabled
Default Regular Rate: 5.00
Save
Dishwasher
Assign to Locations
Café
Café 2
Sub Shop
Save
Server
Assign to Locations
Café
Café 2
Save
Cashier
Assign to Locations
Sub Shop
Save
Labor (menu)
Payroll
Admin
Add
Name: Server
Authorize Clocks Ins: 1
Perform Clock In: 1
Other Options: << As desired >>
Save
NOTE: There is a known issue with the privilege level settings in mylabor and how they are transferred to the
Simphony POS database. At this time, only levels 0 and 1 (not authorized and authorized) are supported. If
levels 2 and 3 are used, they will be interpreted the same way as level 0.
Labor (menu)
Admin
Add
Name: Maryland
Default: << Enable if default >>
Minimum Wage: << Enter Rate >>
Maximum Tip Credit Amount: << Enter if desired >>
Maximum Tip Credit Percentage: << Enter if desired >>
Effective From: << Tomorrow >>
Save
Labor (menu)
Payroll (menu)
Admin
Add
Name: Biweekly
Start Date: << Enter Date >>
End Date: << Enter Date – 2015ish >>
Frequency: Biweekly
Save
Cancel
Admin
Labor (menu)
Payroll (menu)
Add
Name: Default
Overtime Multiplier: 1.5
Overtime Level: 1
Daily Overtime: << Configure as desired >>
Weekly Overtime: << Configure as desired >>
Effective From: << Tomorrow >>
Save
Labor (menu)
Payroll (menu)
Admin
Add
Main Tab:
Name: Default
Allocate to Clock-in Labor Date: Enabled
Effective From: << Tomorrow >>
Other Options: << As desired >>
Overtime Rules:
Save
Cancel
Labor (menu)
Payroll (menu)
Admin
Work Rules
Add
Name: Default
Min Hours Per Week: << As desired >>
Max Hours Per Week: << As desired >>
Min Hours Per Day: << As desired >>
Max Hours Per Day: << As desired >>
Save
Cancel
Labor (menu)
Payroll (menu)
Admin
Location Assignment
Cafe
Save
OK
Labor (menu)
Payroll (menu)
Admin
Location Configuration
Cafe
Save
OK
Save
OK
Save
OK
ADD EMPLOYEES
Labor (menu)
Employee
Add
General Tab:
Status:
Location Configuration:
Save
OK
To find employee:
>> Add
>> Find
Search
NOTE: It could take up to 5 minutes for the employee to appear depending upon the configuration of the
system.
NOTE: If employee does not appear, check the DTS log to make sure DTS is running. Common errors seen
include DTS failing to start (due to DB connection timeout at boot when mymicros is trying to start at same
time as DTS on slow hardware) and not configuring the external application username and password when
setting up the organization.
Admin
System
Organizations
Organizations
Select Organization
Edit
NOTE : (This should be the same user name/ password provided in EMC > Enterprise > Setup > Properties >
Report Location )
Save
After few minutes, the created Employee should be visible in EMC’s Employee maintenance
module.
Admin (menu)
Warehouse (menu)
Report Roles
Sys Admin
Select
Add
Save
Cancel
Logout
Reports (menu)
mylabor Reports
APPENDIX A
TROUBLESHOOTING TIPS
1. REMOVE DUPLICATE PAYROLID
When newly created employees in Mymicros site, are not displaying in the EMC due to duplicate
PayRolIDs, execute below Queries in MCRSPOS db.
---------------------------------------------------------------------------------------------------------------
---------------------------------------------------------